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

Перед началом

  • Запустите оплату картой на своем сервере через POST /api/v1/invoices/{invoiceId}/papelpay и передайте payment.embed_url на свою страницу. См. Обзор.
  • Добавьте домен своей страницы оформления заказа в панели управления в разделе PapelPay > Домены и подтвердите его. Подтвержденный собственный домен вашего магазина и его поддомены также подходят.
  • Во время разработки 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 вида papelship:papelpay:paid (и так далее) на window.

Подтвердите оплату на своем сервере

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