Ontwikkelaars-API

Integreren en aanpassen

Start Payment for Stripe vanuit je eigen app of website met URL-schema's, en bepaal rechtstreeks vanuit je Stripe-dashboard welke producten in de app verschijnen.

Integreren met URL-schema's

Start betalingen vanuit je app of website, geef klantgegevens door en verwerk callbacks.

Producten verbergen met metadata

Houd producten die je alleen online verkoopt buiten de app met één metadatasleutel.

Integreren met URL-schema's

Hoe het werkt

Je app opent een payment:// URL met parameters

Payment for Stripe wordt gestart en verwerkt de transactie.

Na voltooiing stuurt de app je door naar je callback-URL met het resultaat.

Endpoints

Een betaling 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 betalingsomschrijving
`customer`	string	Nee	Bestaand Stripe-klant-ID
`email`	string	Nee	E-mailadres van de klant voor de bon
`name`	string	Nee	URL-gecodeerde klantnaam
`metadata`	string	Nee	Aangepaste sleutel-waardeparen (URL-gecodeerde JSON)
`callback`	string	Nee	URL om na voltooiing naar terug te keren
`autoprocess`	boolean	Nee	Sla het startscherm over en start de betaling direct.
`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 je 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 de bon
`name`	string	Nee	URL-gecodeerde klantnaam
`callback`	string	Nee	URL om na voltooiing naar terug te keren
`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?

Neem een betaling ter plaatse aan voor een bestaande Stripe-factuur. Bedrag, valuta, klant en belasting komen van de factuur. Een poging om een van deze gegevens te overschrijven wordt geweigerd. De verkoper laat de kaart aanbieden via een kaartlezer, Tap to Pay of handmatige invoer; bij succes wordt de factuur gemarkeerd als buiten Stripe betaald (out-of-band) en gekoppeld via de metadata charge_id en payment_intent_id. Facturen met abonnementen, een default_payment_method of een andere status dan open worden geweigerd met een duidelijke 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 start de betaling direct.
`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 bon 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 het betalingsproces via payment://invoice)
`error`	string	Foutmelding (bij een fout)

Voorbeelden

Eenvoudige betaling

Breng $10,00 in rekening met slechts een bedrag.

payment://new?amount=1000

Betaling met omschrijving

Breng €25,00 in rekening met een omschrijving.

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

Betaling met nieuwe klant

Breng $50,00 in rekening en maak een klantrecord aan.

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

Betaling bij bestaande klant

Breng een bestaande Stripe-klant $75,00 in rekening.

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

Betaling met metadata

Breng $100,00 in rekening met aangepaste metadata voor je administratie.

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 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-complete

Automatische 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-complete

Factuur 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)

Neem een betaling ter plaatse aan voor een bestaande Stripe-factuur. Geeft bij succes invoice_id en payment_intent_id terug.

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

Volledig voorbeeld

Alle parameters gecombineerd voor een volledig geïntegreerde flow.

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-codering

Vergeet niet speciale tekens in parameterwaarden te URL-coderen. Spaties worden %20, accolades worden %7B en %7D.

Producten verbergen met metadata

Producten verbergen in de app

De app toont de producten en prijzen uit je Stripe-account. Wil je er een buiten de app houden (bijvoorbeeld artikelen die je alleen via je webshop verkoopt), voeg dan deze metadatasleutel toe aan het product of de prijs in het Stripe-dashboard:

payment_hidden = true

Op een product: verbergt het product en al zijn prijzen.

Op een prijs: verbergt alleen die prijs.

Verwijder de sleutel, of zet hem op false, om het weer te tonen. Wijzigingen gelden zodra de app je productlijst opnieuw laadt.

Winkelwagen-links blijven werken

Verbergen geldt alleen voor de productlijst in de app. payment://cart-URL's die naar een verborgen prijs verwijzen blijven werken, en bestaande abonnementen worden niet beïnvloed.

Klaar voor integratie?

Download de app en begin vandaag nog met het testen van je integratie.

Download voor iOS Download voor Android

Contact opnemen met de ondersteuning