Passer au contenu principal
Le SDK JavaScript PapelShip intègre le formulaire de carte PapelPay dans votre propre page de paiement, de sorte que le client ne quitte jamais votre site. Le formulaire se charge dans un cadre (frame) servi par PapelShip : les données de carte ne transitent jamais par votre serveur ni par votre page.

Avant de commencer

  • Lancez le paiement par carte sur votre serveur avec POST /api/v1/invoices/{invoiceId}/papelpay et transmettez payment.embed_url à votre page. Consultez Présentation.
  • Ajoutez le domaine de votre page de paiement dans le tableau de bord, sous PapelPay > Domains, puis vérifiez-le. Un domaine personnalisé vérifié de votre boutique fonctionne également, ainsi que ses sous-domaines.
  • localhost et 127.0.0.1 fonctionnent sans configuration pendant le développement.
Sur un domaine non vérifié, le cadre affiche un avertissement à la place du formulaire et onError reçoit origin_not_allowed.

Intégrer le formulaire

checkout.html
Le cadre s’agrandit et se réduit en fonction de son contenu. mount renvoie { iframe, destroy } ; appelez card.destroy() pour retirer le formulaire, par exemple lorsque le client choisit un autre moyen de paiement.

Options

Événements

Les mêmes événements sont disponibles globalement avec PapelShip.on("papelpay:paid", fn), papelpay:declined, papelpay:error et papelpay:ready, ainsi que sous forme de CustomEvent papelship:papelpay:paid (et ainsi de suite) sur window.

Confirmer le paiement sur votre serveur

onPaid indique à votre page que la carte a été débitée. Avant de livrer quoi que ce soit vous-même, confirmez la commande sur votre serveur : attendez le webhook order.completed ou lisez GET /api/v1/invoices/{invoiceId} et vérifiez que status vaut completed. Consultez Webhooks.
Autorisez les fonctionnalités de paiement par carte dans le parent du cadre si vous utilisez votre propre sandbox d’iframe ou votre propre politique d’autorisations : le SDK définit allow="payment *" sur son cadre pour les paiements par portefeuille.