Перейти к основному содержанию
Заказ (счет) содержит товары, клиента и цену. Клиент оплачивает его на размещенной странице checkout_url, где выбирает любой способ оплаты, который принимает ваш магазин. Заказы, созданные через API, подчиняются тем же правилам, что и ваша витрина: цены берутся из каталога, остатки резервируются, применяются купоны и правила товаров, выполняются проверки на мошенничество.

Создайте заказ

Ответ (201)
Перенаправьте клиента на checkout_url. Неоплаченные заказы истекают через 3 часа.

Физические товары

Для товаров с доставкой добавьте адрес. Сначала получите варианты с помощью POST /shipping/quote или не указывайте shipping_rate_id, чтобы использовать самый дешевый тариф.
Стоимость доставки добавляется к total_cents и отображается как shipping_cents. Если адрес не указан, клиент вводит его на странице оплаты перед платежом. После оплаты отправьте заказ с помощью POST /orders/{invoiceId}/shipments.

Статусы заказа

Вместо опроса слушайте вебхук order.completed. См. Вебхуки.

После создания заказа

Используйте ID своего заказа как Idempotency-Key для вызовов создания, завершения и возврата. Тогда повторные запросы никогда не создадут второй заказ или второй возврат.