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.
Наступні кроки
Підписки
Продавайте товар за підпискою та відстежуйте її поновлення.
Форма картки на вашому сайті
Показуйте форму картки на власній сторінці оформлення.