Перейти к основному содержанию
PapelPay является способом оплаты картой в вашем магазине PapelShip. С помощью Store API вы создаете заказ, запускаете для него платеж PapelPay, и клиент оплачивает картой на вашей размещенной странице оплаты или в форме карты на вашем собственном сайте. Заказы на товары, которые продаются по подписке, оплачиваются повторно в каждом расчетном периоде.
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.

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

Подписки

Продавайте товар по подписке и отслеживайте ее продления.

Форма карты на вашем сайте

Показывайте форму карты на собственной странице оформления заказа.