Перейти к основному содержанию
В этом руководстве вы пройдете полный цикл заказа в PapelShip Store API: создадите заказ на один из своих товаров, отправите клиента на размещенную страницу оплаты и подтвердите платеж, прежде чем на него полагаться.

Предварительные требования

  • Магазин PapelShip хотя бы с одним товаром
  • Ключ Store API (pk_live_...) с разрешением orders:write и ID вашего магазина для заголовка x-store-hash
И то и другое находится в панели управления PapelShip в настройках API вашего магазина. См. Аутентификация.
1

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

Передайте email клиента и товары. Добавьте заголовок Idempotency-Key, чтобы повторные запросы никогда не создавали второй заказ.
2

Отправьте клиента на страницу оплаты

Ответ содержит заказ с полем checkout_url. Перенаправьте туда клиента, чтобы он оплатил любым способом, который принимает ваш магазин.
Ответ (201)
Сохраните invoice.id вместе со своим заказом. Неоплаченные заказы истекают через 3 часа. Чтобы сразу списать оплату с карты или показать форму карты на своем сайте, см. PapelPay.
3

Подтвердите платеж

Никогда не полагайтесь только на возврат клиента на ваш сайт. Слушайте вебхук order.completed или прочитайте заказ на своем сервере:
Заказ оплачен и доставлен, когда status равен completed.
Храните API-ключ на своем сервере. Никогда не включайте его в браузерный код, мобильные приложения или десктопные клиенты.

Следующие шаги

Заказы

Физические товары, статусы, отмена и возвраты.

PapelPay

Оплата картой, подписки и форма карты на вашем сайте.