Utvikler-API
Integrer med URL-skjemaer
Start betaling for Stripe fra appen eller nettstedet ditt for å behandle transaksjoner. Overfør kundedata, beløp og produktinformasjon – og håndter deretter tilbakeringingen når den er fullført.
Hvordan det fungerer
Appen din åpner en betaling:// URL med parametere
Betaling for Stripe starter og behandler transaksjonen
Når det er fullført, omdirigerer appen til tilbakeringings-URL-en din med resultatet
Endepunkter
Opprett en belastning
payment://new?Behandle en engangsbetaling med beløp, valuta og beskrivelse.
Parametere
| Navn | Type | Obligatorisk | Beskrivelse |
|---|---|---|---|
amount | integer | Ja | Beløp i cent (f.eks. 1000 = $10,00) |
currency | string | Ingen | ISO-valutakode med tre bokstaver (standard: USD) |
description | string | Ingen | URL-kodet faktureringsbeskrivelse |
customer | string | Ingen | Eksisterende Stripe-kunde-ID |
email | string | Ingen | Kundens e-postadresse for kvittering |
name | string | Ingen | URL-kodet kundenavn |
metadata | string | Ingen | Tilpassede nøkkelverdipar (URL-kodet JSON) |
callback | string | Ingen | URL å gå tilbake til etter fullføring |
autoprocess | boolean | Ingen | Hopp over startskjermen og start ladingen umiddelbart |
Opprett en faktura
payment://cart?Opprett en Stripe-faktura med linjeelementer fra produktkatalogen din.
Parametere
| Navn | Type | Obligatorisk | Beskrivelse |
|---|---|---|---|
prices | string | Ja | Kommaseparerte pris-ID-er med mengder (f.eks. price_abc:2,price_xyz:1) |
customer | string | Ingen | Eksisterende Stripe-kunde-ID |
email | string | Ingen | Kundens e-postadresse for kvittering |
name | string | Ingen | URL-kodet kundenavn |
callback | string | Ingen | URL å gå tilbake til etter fullføring |
Håndtering av tilbakeringinger
Når transaksjonen er fullført, omdirigerer Payment for Stripe til tilbakeringings-URL-en din med spørreparametere som angir resultatet.
Tilbakeringingsparametere
| Parameter | Verdier | Beskrivelse |
|---|---|---|
status | success | error | cancelled | Resultatet av transaksjonen |
charge_id | string | Stripe-betalings-ID (ved suksess) |
error | string | Feilmelding (ved feil) |
Eksempler
Enkel lading
Belast $10,00 med bare et beløp
payment://new?amount=1000Belast med beskrivelse
Belast €25,00 med en beskrivelse
payment://new?amount=2500¤cy=eur&description=Coffee%20and%20pastryBelast med ny kunde
Belast 50,00 dollar og opprett en kundepost
payment://new?amount=5000&name=John%20Smith&[email protected]Belast eksisterende kunde
Belast en eksisterende Stripe-kunde med 75,00 dollar
payment://new?amount=7500&customer=cus_ABC123xyzLad opp med metadata
Belast 100,00 dollar med tilpassede metadata for dine poster
payment://new?amount=10000&description=Invoice%20%231234&metadata=%7B%22order_id%22%3A%221234%22%2C%22location%22%3A%22Store%20A%22%7DAutomatisk prosess med tilbakeringing
Hopp over startskjermen og gå tilbake til appen når du er ferdig
payment://new?amount=3500&autoprocess=true&callback=myapp://payment-completeFaktura med linjeelementer
Opprett en faktura med produkter fra Stripe-katalogen din
payment://cart?prices=price_coffee:2,price_muffin:1&[email protected]Komplett eksempel
Alle parametere kombinert for en fullstendig integrert flyt
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-koding
Husk å URL-kode spesialtegn i parameterverdier. Mellomrom blir %20, krøllparenteser blir %7B og %7D.
Klar til å integrere?
Last ned appen og begynn å teste integrasjonen din i dag.