Entwickler-API

Integrieren und anpassen

Starten Sie Payment for Stripe per URL-Schema aus Ihrer eigenen App oder Website, und steuern Sie direkt im Stripe-Dashboard, welche Produkte in der App erscheinen.

Integration per URL-Schema

Lösen Sie Zahlungen aus Ihrer App oder Website aus, übergeben Sie Kundendaten und verarbeiten Sie Callbacks.

Produkte per Metadaten ausblenden

Halten Sie Nur-Online-Produkte mit einem einzigen Metadaten-Schlüssel aus der App fern.

Integration per URL-Schema

So funktioniert es

Ihre App öffnet eine Zahlung:// URL mit Parametern

Stripe startet die Zahlung und verarbeitet die Transaktion.

Nach Abschluss der Anwendung werden Sie mit dem Ergebnis an Ihre Callback-URL weitergeleitet.

Endpunkte

Eine Ladung erstellen

payment://new?

Eine einmalige Zahlung mit Betrag, Währung und Beschreibung verarbeiten.

Parameter

Name	Typ	Erforderlich	Beschreibung
`amount`	integer	Ja	Betrag in Cent (z. B. 1000 = 10,00 $)
`currency`	string	NEIN	Dreistelliger ISO-Währungscode (Standard: USD)
`description`	string	NEIN	URL-codierte Gebührenbeschreibung
`customer`	string	NEIN	Vorhandene Stripe-Kunden-ID
`email`	string	NEIN	Kunden-E-Mail für den Beleg
`name`	string	NEIN	URL-codierter Kundenname
`metadata`	string	NEIN	Benutzerdefinierte Schlüssel-Wert-Paare (URL-codiertes JSON)
`callback`	string	NEIN	URL, zu der nach Abschluss zurückgekehrt werden soll
`autoprocess`	boolean	NEIN	Startbildschirm überspringen und Ladevorgang sofort starten
`auto_return`	boolean	NEIN	Die Callback-Funktion soll beim Laden des Ergebnisses ausgelöst werden, anstatt darauf zu warten, dass der Händler den Ergebnisdialog schließt. Standardmäßig deaktiviert.

Rechnung erstellen

payment://cart?

Erstellen Sie eine Stripe-Rechnung mit Positionen aus Ihrem Produktkatalog.

Parameter

Name	Typ	Erforderlich	Beschreibung
`prices`	string	Ja	Durch Kommas getrennte Preis-IDs mit Mengen (z. B. price_abc:2,price_xyz:1)
`customer`	string	NEIN	Vorhandene Stripe-Kunden-ID
`email`	string	NEIN	Kunden-E-Mail für den Beleg
`name`	string	NEIN	URL-codierter Kundenname
`callback`	string	NEIN	URL, zu der nach Abschluss zurückgekehrt werden soll
`auto_return`	boolean	NEIN	Die Callback-Funktion soll beim Laden des Ergebnisses ausgelöst werden, anstatt darauf zu warten, dass der Händler den Ergebnisdialog schließt. Standardmäßig deaktiviert.

Eine bestehende Rechnung bezahlen (nur iOS)

payment://invoice?

Eine persönliche Zahlung wird gegen eine bestehende Stripe-Rechnung eingezogen. Betrag, Währung, Kunde und Steuer werden aus der Rechnung übernommen. Änderungen dieser Daten sind nicht möglich. Der Händler führt eine Karte per Lesegerät/Tap-to-Pay/manueller Eingabe durch. Bei erfolgreicher Zahlung wird die Rechnung als außerbörslich bezahlt markiert und über die Metadaten charge_id und payment_intent_id verknüpft. Rechnungen mit Abonnements, der Standardzahlungsmethode oder dem Status „Nicht offen“ werden mit einer entsprechenden Fehlermeldung abgelehnt.

Parameter

Name	Typ	Erforderlich	Beschreibung
`id`	string	Ja	Stripe-Rechnungs-ID (muss mit in_ beginnen)
`callback`	string	NEIN	URL, zu der nach Abschluss zurückgekehrt werden soll. Erhält bei Erfolg die Rechnungs-ID und die Zahlungsabsichts-ID.
`metadata`	string	NEIN	Benutzerdefinierte Schlüssel-Wert-Paare (URL-codiertes JSON) wurden in die PaymentIntent-Metadaten integriert.
`autoprocess`	boolean	NEIN	Startbildschirm überspringen und Ladevorgang sofort starten
`auto_return`	boolean	NEIN	Die Callback-Funktion soll beim Laden des Ergebnisses ausgelöst werden, anstatt darauf zu warten, dass der Händler den Ergebnisdialog schließt. Standardmäßig deaktiviert.

Bearbeitung von Rückrufen

Nach Abschluss der Transaktion leitet Payment for Stripe mit Abfrageparametern, die das Ergebnis angeben, an Ihre Callback-URL weiter. Standardmäßig erfolgt die Weiterleitung, nachdem der Händler den Ergebnisdialog geschlossen hat, damit er nach der Abbuchung weitere Aktionen durchführen kann (z. B. eine Quittung per E-Mail versenden oder eine Rückerstattung veranlassen). Mit `auto_return=true` wird die Weiterleitung ausgelöst, sobald das Ergebnis bekannt ist. Unterstützt iOS und Android.

Callback-Parameter

Parameter	Werte	Beschreibung
`status`	success \| error \| cancelled	Ergebnis der Transaktion
`charge_id`	string	Stripe-Zahlungs-ID (bei Erfolg)
`invoice_id`	string	Stripe-Rechnungs-ID (nur im Erfolgsfall, payment://invoice-Ablauf)
`payment_intent_id`	string	Stripe PaymentIntent-ID (nur bei Erfolg, payment://invoice-Ablauf)
`error`	string	Fehlermeldung (bei einem Fehler)

Beispiele

Einfaches Aufladen

Berechnen Sie 10,00 $ mit nur einem Betrag

payment://new?amount=1000

Gebühr mit Beschreibung

Gebühr 25,00 € mit Beschreibung

payment://new?amount=2500&currency=eur&description=Coffee%20and%20pastry

Gebühr bei Neukunden

Berechnen Sie 50,00 $ und erstellen Sie einen Kundendatensatz.

payment://new?amount=5000&name=John%20Smith&[email protected]

Bestehende Kunden belasten

Einem bestehenden Stripe-Kunden 75,00 $ in Rechnung stellen

payment://new?amount=7500&customer=cus_ABC123xyz

Aufladen mit Metadaten

Berechnen Sie 100,00 $ inklusive benutzerdefinierter Metadaten für Ihre Datensätze

payment://new?amount=10000&description=Invoice%20%231234&metadata=%7B%22order_id%22%3A%221234%22%2C%22location%22%3A%22Store%20A%22%7D

Automatische Verarbeitung mit Rückruffunktion

Überspringen Sie den Startbildschirm und kehren Sie nach Abschluss der Arbeit zu Ihrer App zurück.

payment://new?amount=3500&autoprocess=true&callback=myapp://payment-complete

Automatische Rückkehr zum Ergebnis

Die Callback-Funktion sollte ausgelöst werden, sobald das Ergebnis bekannt ist, anstatt darauf zu warten, dass der Händler den Ergebnisdialog schließt.

payment://new?amount=3500&autoprocess=true&auto_return=true&callback=myapp://payment-complete

Rechnung mit Einzelposten

Erstellen Sie eine Rechnung mit Produkten aus Ihrem Stripe-Katalog

payment://cart?prices=price_coffee:2,price_muffin:1&[email protected]

Eine bestehende Rechnung bezahlen (iOS)

Akzeptiert Zahlungen vor Ort für eine bestehende Stripe-Rechnung. Gibt bei Erfolg die Rechnungs-ID und die Zahlungsabsichts-ID zurück.

payment://invoice?id=in_1ABC123xyz&autoprocess=true&callback=myapp://invoice-paid

Vollständiges Beispiel

Alle Parameter kombiniert für einen vollständig integrierten Durchfluss

payment://new?amount=15000&currency=usd&description=Service%20Fee&customer=cus_ABC123xyz&metadata=%7B%22invoice%22%3A%22INV-2024-001%22%7D&autoprocess=true&callback=myapp://payment-result

URL-Codierung

Denken Sie daran, Sonderzeichen in Parameterwerten URL-zu-kodieren. Leerzeichen werden zu %20, geschweifte Klammern zu %7B und %7D.

Produkte per Metadaten ausblenden

Produkte in der App ausblenden

Die App listet die Produkte und Preise aus Ihrem Stripe-Konto auf. Um eines aus der App fernzuhalten (zum Beispiel Artikel, die nur über Ihren Onlineshop verkauft werden), fügen Sie dem Produkt oder Preis im Stripe-Dashboard diesen Metadaten-Schlüssel hinzu:

payment_hidden = true

Bei einem Produkt: blendet das Produkt und alle zugehörigen Preise aus.

Bei einem Preis: blendet nur diesen Preis aus.

Entfernen Sie den Schlüssel oder setzen Sie ihn auf false, um es wieder anzuzeigen. Änderungen gelten beim nächsten Laden Ihrer Produktliste in der App.

Warenkorb-Links funktionieren weiterhin

Das Ausblenden betrifft nur die Produktliste in der App. payment://cart-URLs, die auf einen ausgeblendeten Preis verweisen, funktionieren weiterhin, und bestehende Abonnements sind nicht betroffen.

Bereit zur Integration?

Laden Sie die App herunter und testen Sie noch heute Ihre Integration.

Laden Sie die App herunter Kontaktieren Sie den Support.