Перейти до основного вмісту
JavaScript SDK PapelShip вбудовує форму картки PapelPay у вашу власну сторінку оформлення, тож клієнт ніколи не залишає ваш сайт. Форма завантажується у фреймі з PapelShip: дані картки ніколи не потрапляють на ваш сервер чи вашу сторінку.

Перш ніж почати

  • Запустіть оплату карткою на своєму сервері через POST /api/v1/invoices/{invoiceId}/papelpay і передайте payment.embed_url на свою сторінку. Див. Огляд.
  • Додайте домен своєї сторінки оформлення в панелі керування в розділі PapelPay > Domains і підтвердіть його. Підтверджений власний домен вашого магазину також підходить, як і його піддомени.
  • localhost і 127.0.0.1 працюють без налаштування під час розробки.
На непідтвердженому домені фрейм показує повідомлення замість форми, а onError отримує origin_not_allowed.

Вбудуйте форму

checkout.html
Фрейм збільшується та зменшується разом із вмістом. mount повертає { iframe, destroy }; викличте card.destroy(), щоб прибрати форму, наприклад коли клієнт обирає інший спосіб оплати.

Параметри

Події

Ті самі події доступні глобально через PapelShip.on("papelpay:paid", fn), papelpay:declined, papelpay:error і papelpay:ready, а також як CustomEvent на window з назвами papelship:papelpay:paid тощо.

Підтвердіть оплату на своєму сервері

onPaid повідомляє вашій сторінці, що кошти з картки списано. Перш ніж самостійно щось доставляти, підтвердіть замовлення на своєму сервері: дочекайтеся вебхука order.completed або прочитайте GET /api/v1/invoices/{invoiceId} і перевірте, що status має значення completed. Див. Вебхуки.
Якщо ви використовуєте власний sandbox для iframe або політику дозволів, дозвольте функції карткових платежів у батьківському елементі фрейму: SDK встановлює allow="payment *" для свого фрейму, щоб підтримувати платежі через гаманці.