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. |
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 |
Het afhandelen van callbacks
Wanneer de transactie is voltooid, stuurt Payment for Stripe u door naar uw callback-URL met queryparameters die het resultaat aangeven.
Callbackparameters
| Parameter | Waarden | Beschrijving |
|---|---|---|
status | success | error | cancelled | Resultaat van de transactie |
charge_id | string | Stripe-betalings-ID (bij succesvolle betaling) |
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-completeFactuur met specificaties
Maak een factuur aan met producten uit je Stripe-catalogus.
payment://cart?prices=price_coffee:2,price_muffin:1&[email protected]Volledig 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.