PapelPay должен быть активирован в вашем магазине. Подайте заявку в панели управления в разделе PapelPay; пока магазин не одобрен, эндпоинты на этой странице возвращают
PAPELPAY_NOT_ENABLED.Как работает оплата картой
1
Создайте заказ
Вызовите
POST /api/v1/invoices с данными клиента и товарами, как описано в разделе Создание заказов и управление ими. Добавьте auto_renew, чтобы продать товар с подпиской как подписку или как разовую покупку. См. Подписки.2
Запустите оплату картой
Вызовите
POST /api/v1/invoices/{invoiceId}/papelpay или передайте "payment_method": "PAPELPAY" при создании заказа, чтобы выполнить оба действия одним вызовом. Ответ содержит объект payment.3
Дайте клиенту оплатить
Отправьте клиента на
payment.payment_url: это ваша размещенная страница оплаты, открытая на форме карты. Чтобы клиент оставался на вашем сайте, подключите payment.embed_url с помощью JavaScript SDK. См. Форма карты на вашем сайте.4
Подтвердите заказ
Когда оплата с карты списана, заказ переходит в статус
completed, и PapelShip доставляет товары. Слушайте вебхук order.completed или прочитайте заказ через GET /api/v1/invoices/{invoiceId}. См. Вебхуки.Запустите оплату картой
Ответ (200)
Повторный вызов эндпоинта, пока платеж открыт, возвращает тот же
session_id. Используйте ID заказа в своем Idempotency-Key.
Объект платежа
Ошибки
Если вы передали
"payment_method": "PAPELPAY" при создании, а оплата картой не смогла запуститься, заказ все равно создан. Его ID указан в details.invoice_id ошибки, поэтому вы можете повторить попытку через POST /invoices/{invoiceId}/papelpay.
Следующие шаги
Подписки
Продавайте товар по подписке и отслеживайте ее продления.
Форма карты на вашем сайте
Показывайте форму карты на собственной странице оформления заказа.