Avant de commencer
- Lancez le paiement par carte sur votre serveur avec
POST /api/v1/invoices/{invoiceId}/papelpayet transmettezpayment.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.
localhostet127.0.0.1fonctionnent sans configuration pendant le développement.
Intégrer le formulaire
checkout.html
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.