Ontwikkelaars-API
Integreren met URL-schema's
Start de Stripe-betaalfunctie vanuit je app of website om transacties te verwerken. Geef klantgegevens, bedragen en productinformatie door en verwerk de callback zodra de transactie is voltooid.
Hoe het werkt
Je app opent een betaling:// URL met parameters
De betaling via Stripe wordt gestart en verwerkt de transactie.
Na voltooiing stuurt de app je door naar je callback-URL met het resultaat.
Eindpunten
Een factuur aanmaken
payment://new?Verwerk een eenmalige betaling met bedrag, valuta en omschrijving.
Parameters
| Naam | Type | Vereist | Beschrijving |
|---|---|---|---|
amount | integer | Ja | Bedrag in centen (bijv. 1000 = $10,00) |
currency | string | Nee | Drieletterige ISO-valutacode (standaard: USD) |
description | string | Nee | URL-gecodeerde kostenomschrijving |
customer | string | Nee | Bestaand Stripe-klant-ID |
email | string | Nee | E-mailadres van de klant voor ontvangstbevestiging |
name | string | Nee | URL-gecodeerde klantnaam |
metadata | string | Nee | Aangepaste sleutel-waardeparen (URL-gecodeerde JSON) |
callback | string | Nee | URL waarnaar u na voltooiing moet terugkeren |
autoprocess | boolean | Nee | Sla het startscherm over en begin direct met opladen. |
auto_return | boolean | Nee | Roep de callbackfunctie aan zodra het resultaat is geladen, in plaats van te wachten tot de verkoper het resultaatdialoogvenster sluit. Standaardwaarde: false. |
Een factuur aanmaken
payment://cart?Maak een Stripe-factuur aan met artikelregels uit uw productcatalogus.
Parameters
| Naam | Type | Vereist | Beschrijving |
|---|---|---|---|
prices | string | Ja | Door komma's gescheiden prijs-ID's met aantallen (bijv. price_abc:2,price_xyz:1) |
customer | string | Nee | Bestaand Stripe-klant-ID |
email | string | Nee | E-mailadres van de klant voor ontvangstbevestiging |
name | string | Nee | URL-gecodeerde klantnaam |
callback | string | Nee | URL waarnaar u na voltooiing moet terugkeren |
auto_return | boolean | Nee | Roep de callbackfunctie aan zodra het resultaat is geladen, in plaats van te wachten tot de verkoper het resultaatdialoogvenster sluit. Standaardwaarde: false. |
Een bestaande factuur betalen (alleen iOS)
payment://invoice?Een betaling ter plaatse wordt geïncasseerd op basis van een bestaande Stripe-factuur. Het bedrag, de valuta, de klant en de btw worden overgenomen van de factuur. Het overschrijven van een van deze gegevens wordt geweigerd. De verkoper scant een kaart via een kaartlezer / Tap to Pay / handmatige invoer; bij een succesvolle transactie wordt de factuur automatisch als betaald gemarkeerd en gekoppeld via de metadata charge_id en payment_intent_id. Facturen met abonnementen, een standaard betaalmethode of een niet-open status worden geweigerd met een foutmelding.
Parameters
| Naam | Type | Vereist | Beschrijving |
|---|---|---|---|
id | string | Ja | Stripe factuur-ID (moet beginnen met in_) |
callback | string | Nee | URL waarnaar na voltooiing moet worden teruggekeerd. Ontvangt invoice_id en payment_intent_id bij succes. |
metadata | string | Nee | Aangepaste sleutel-waardeparen (URL-gecodeerde JSON) samengevoegd in de PaymentIntent-metadata. |
autoprocess | boolean | Nee | Sla het startscherm over en begin direct met opladen. |
auto_return | boolean | Nee | Roep de callbackfunctie aan zodra het resultaat is geladen, in plaats van te wachten tot de verkoper het resultaatdialoogvenster sluit. Standaardwaarde: false. |
Het afhandelen van callbacks
Wanneer de transactie is voltooid, stuurt Payment for Stripe je door naar je callback-URL met queryparameters die het resultaat aangeven. Standaard wordt de redirect geactiveerd nadat de verkoper het resultaatdialoogvenster heeft gesloten, zodat deze acties na de betaling kan uitvoeren (een ontvangstbewijs per e-mail versturen, een terugbetaling doen). Geef auto_return=true door om de redirect te activeren zodra het resultaat bekend is. Ondersteund op iOS en Android.
Callbackparameters
| Parameter | Waarden | Beschrijving |
|---|---|---|
status | success | error | cancelled | Resultaat van de transactie |
charge_id | string | Stripe-betalings-ID (bij succesvolle betaling) |
invoice_id | string | Stripe-factuur-ID (alleen bij succes, in het betalingsproces via payment://invoice) |
payment_intent_id | string | Stripe PaymentIntent ID (alleen bij succes, in de payment://invoice flow) |
error | string | Foutmelding (bij een fout) |
Voorbeelden
Eenvoudige lading
Breng $10,00 in rekening met slechts een bedrag.
payment://new?amount=1000Kosten met omschrijving
Breng €25,00 in rekening met een omschrijving.
payment://new?amount=2500¤cy=eur&description=Coffee%20and%20pastryKosten in rekening brengen bij nieuwe klant
Breng $50,00 in rekening en maak een klantrecord aan.
payment://new?amount=5000&name=John%20Smith&[email protected]bestaande klant kosten in rekening brengen
Breng een bestaande Stripe-klant $75,00 in rekening.
payment://new?amount=7500&customer=cus_ABC123xyzKosten met metadata
Reken $100,00 voor aangepaste metadata voor uw gegevens.
payment://new?amount=10000&description=Invoice%20%231234&metadata=%7B%22order_id%22%3A%221234%22%2C%22location%22%3A%22Store%20A%22%7DAutomatische verwerking met callback
Sla het startscherm over en keer terug naar je app als je klaar bent.
payment://new?amount=3500&autoprocess=true&callback=myapp://payment-completeAutomatische terugkeer bij resultaat
Activeer de callback zodra het resultaat bekend is, in plaats van te wachten tot de verkoper het resultaatdialoogvenster sluit.
payment://new?amount=3500&autoprocess=true&auto_return=true&callback=myapp://payment-completeFactuur met specificaties
Maak een factuur aan met producten uit je Stripe-catalogus.
payment://cart?prices=price_coffee:2,price_muffin:1&[email protected]Een bestaande factuur betalen (iOS)
Verzamel contante betalingen voor een bestaande Stripe-factuur. Retourneert invoice_id en payment_intent_id bij succes.
payment://invoice?id=in_1ABC123xyz&autoprocess=true&callback=myapp://invoice-paidVolledig voorbeeld
Alle parameters gecombineerd voor een volledig geïntegreerde doorstroming.
payment://new?amount=15000¤cy=usd&description=Service%20Fee&customer=cus_ABC123xyz&metadata=%7B%22invoice%22%3A%22INV-2024-001%22%7D&autoprocess=true&callback=myapp://payment-resultURL-codering
Vergeet niet om speciale tekens in parameterwaarden URL-coderend in te stellen. Spaties worden %20, accolades worden %7B en %7D.
Klaar voor integratie?
Download de app en begin vandaag nog met het testen van uw integratie.