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 online-only producten buiten de app met één metadatasleutel.

Integreren met URL-schema's

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=1000

Kosten met omschrijving

Breng €25,00 in rekening met een omschrijving.

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

Kosten 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_ABC123xyz

Kosten 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%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)

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

Volledig voorbeeld

Alle parameters gecombineerd voor een volledig geïntegreerde doorstroming.

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 om speciale tekens in parameterwaarden URL-coderend in te stellen. 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 uw integratie.

Download de app Neem contact op met de ondersteuning.