Перейти до основного вмісту
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" під час створення, а оплата карткою не може розпочатися, замовлення все одно існує. Його вказано в details.invoice_id помилки, тож ви можете повторити спробу через POST /invoices/{invoiceId}/papelpay.

Наступні кроки

Підписки

Продавайте товар за підпискою та відстежуйте її поновлення.

Форма картки на вашому сайті

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