Bevor Sie beginnen
- Starten Sie die Kartenzahlung auf Ihrem Server mit
POST /api/v1/invoices/{invoiceId}/papelpayund übergeben Siepayment.embed_urlan Ihre Seite. Siehe Überblick. - Fügen Sie die Domain Ihrer Checkout-Seite im Dashboard unter PapelPay > Domains hinzu und verifizieren Sie sie. Eine verifizierte benutzerdefinierte Domain Ihres Shops funktioniert ebenfalls, ebenso deren Subdomains.
localhostund127.0.0.1funktionieren während der Entwicklung ohne Einrichtung.
Formular einbinden
checkout.html
mount liefert { iframe, destroy }; rufen Sie card.destroy() auf, um das Formular zu entfernen, zum Beispiel wenn der Kunde eine andere Zahlungsmethode wählt.
Optionen
Ereignisse
Dieselben Ereignisse sind global über
PapelShip.on("papelpay:paid", fn), papelpay:declined, papelpay:error und papelpay:ready verfügbar sowie als CustomEvents papelship:papelpay:paid (und so weiter) auf window.
Zahlung auf Ihrem Server bestätigen
onPaid teilt Ihrer Seite mit, dass die Karte belastet wurde. Bevor Sie selbst etwas ausliefern, bestätigen Sie die Bestellung auf Ihrem Server: Warten Sie auf den Webhook order.completed oder rufen Sie GET /api/v1/invoices/{invoiceId} ab und prüfen Sie, ob status den Wert completed hat. Siehe Webhooks.