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 |
auto_return | boolean | Ingen | Utfør tilbakeringing når resultatet lastes inn i stedet for å vente på at selgeren skal lukke resultatdialogboksen. Standard usann. |
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 |
auto_return | boolean | Ingen | Utfør tilbakeringing når resultatet lastes inn i stedet for å vente på at selgeren skal lukke resultatdialogboksen. Standard usann. |
Betal en eksisterende faktura (kun iOS)
payment://invoice?Motta en personlig betaling mot en eksisterende Stripe-faktura. Beløp, valuta, kunde og skatt kommer fra fakturaen – overstyring av noen av disse avvises. Selgeren trykker på et kort via leser / Trykk for å betale / manuell inntasting; ved vellykket betaling merkes fakturaen som betalt utenfor båndet og kobles via charge_id og payment_intent_id metadata. Fakturaer med statusen abonnementer, standardbetalingsmetode eller ikke-åpen avvises med en feil som kan gi rett til handling.
Parametere
| Navn | Type | Obligatorisk | Beskrivelse |
|---|---|---|---|
id | string | Ja | Stripe-faktura-ID (må starte med in_) |
callback | string | Ingen | URL å gå tilbake til etter fullføring. Mottar invoice_id og payment_intent_id ved vellykket gjennomføring. |
metadata | string | Ingen | Tilpassede nøkkelverdipar (URL-kodet JSON) slått sammen med PaymentIntent-metadataene |
autoprocess | boolean | Ingen | Hopp over startskjermen og start ladingen umiddelbart |
auto_return | boolean | Ingen | Utfør tilbakeringing når resultatet lastes inn i stedet for å vente på at selgeren skal lukke resultatdialogboksen. Standard usann. |
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. Som standard utløses omdirigeringen etter at selgeren har lukket resultatdialogboksen, slik at de kan iverksette tiltak etter belastning (sende en kvittering på e-post, refusjon). Sett auto_return=true i gang så snart resultatet er kjent. Støttes på iOS og Android.
Tilbakeringingsparametere
| Parameter | Verdier | Beskrivelse |
|---|---|---|
status | success | error | cancelled | Resultatet av transaksjonen |
charge_id | string | Stripe-betalings-ID (ved suksess) |
invoice_id | string | Stripe-faktura-ID (ved suksess, kun betaling://fakturaflyt) |
payment_intent_id | string | Stripe PaymentIntent ID (ved suksess, kun betaling://fakturaflyt) |
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-completeAutomatisk retur på resultat
Utfør tilbakekallingen så snart resultatet er kjent, i stedet for å vente på at selgeren skal lukke resultatdialogboksen.
payment://new?amount=3500&autoprocess=true&auto_return=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]Betal en eksisterende faktura (iOS)
Samle inn betaling for en eksisterende Stripe-faktura. Returnerer invoice_id og payment_intent_id ved vellykket betaling.
payment://invoice?id=in_1ABC123xyz&autoprocess=true&callback=myapp://invoice-paidKomplett 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.