API

Ein einfaches, benutzerfreundliches URL-Schema zur Integration Ihres Unternehmens mit Payment for Stripe.

Leiten Sie ganz einfach von jeder iOS-App oder Website direkt zur Zahlungs-App weiter, um Zahlungen zu erhalten.

Füllen Sie eine neue Ladung auf

Übergeben Sie Daten an Payment, um Gebühren zu erstellen: payment://new?

Fügen Sie einen Betrag in Cent hinzu: payment://new?amount=2000

Wählen Sie eine unterstützte Währung: payment://new?currency=usd

Fügen Sie eine URL-codierte Beschreibung für die Gebühr hinzu: payment://new?description=Cat+Sweater

Erstellen Sie eine Rechnung mit Einzelposten

Alternativ können Sie eine Einzelposten-Stripe-Rechnung erstellen: payment://cart?

Übergeben Sie ein Preis-ID- und Mengenpaar: payment://cart?line_items=price_xxx:3

Oder geben Sie mehrere Preis-IDs und Mengen weiter: payment://cart?line_items=price_abc:3,price_xyz:2

Zusätzlich können Sie einen Gutschein einlösen: payment://cart?coupon=kZjFzekm

Geben Sie Kundeninformationen an (optional)

Fügen Sie einen URL-codierten Namen für den Kunden hinzu: payment://new?name=John+Doe

Geben Sie eine E-Mail-Adresse für eine Quittung an: payment://new?[email protected]

Geben Sie eine Rückruf-URL an

Nach einer erfolgreichen Transaktion kehrt die Zahlungs-App zu Ihrer App zurück. payment://new?callback=https://foo.bar.com/hook

Zusätzlich dazu, dass iOS Sie automatisch zu Ihrer Website zurückleitet, senden wir auch einige Informationen zurück, darunter: https://foo.bar.com/hook?success=true&
  amount=2000&currency=usd&
  chargeId=pi_xxxxxx

Im Fehlerfall erhalten Sie möglicherweise eine Nachricht im folgenden Format: https://foo.bar.com/hook?error[message]=Card+declined

https://foo.bar.com/hook?cancelled=true

Nutzen Sie einen bestehenden Kunden

Nutzen Sie einen bestehenden Stripe-Kunden, indem Sie dessen ID übergeben: payment://new?customer_id=cus_xxxxxx

Dadurch wird der Kunde für die Transaktion vorausgewählt, sodass seine gespeicherten Zahlungsmethoden verfügbar sind.

Benutzerdefinierte Metadaten einbinden

Übergeben Sie benutzerdefinierte Metadaten, die in die Stripe-Zahlung aufgenommen werden sollen: payment://new?metadata[order_id]=12345

Fügen Sie bei Bedarf mehrere Metadatenfelder hinzu: payment://new?metadata[order_id]=12345&
  metadata[source]=pos

Automatische Zahlungsabwicklung

Überspringen Sie den Startbildschirm und starten Sie den Ladevorgang sofort: payment://new?amount=2000&auto=true

Die Zahlung startet automatisch, sobald die App geöffnet wird. Wenn ein Kartenlesegerät angeschlossen ist, werden Sie sofort zur Zahlung aufgefordert.

Vollständiges Beispiel

Hier ist ein Beispiel, das alles miteinander verbindet:

payment://new?amount=2000&
  currency=usd&
  customer_id=cus_xxxxxx&
  metadata[order_id]=12345&
  callback=myapp://payment&
  auto=true

Möchten Sie mehr von der API?
Lass uns wissen