Udvikler-API

Integrér og tilpas

Start Payment for Stripe fra din egen app eller hjemmeside med URL-skemaer, og styr hvilke produkter der vises i appen direkte fra dit Stripe Dashboard.

Integration med URL-skemaer

Udløs betalinger fra din app eller hjemmeside, videregiv kundedata og håndtér callbacks.

Skjul produkter med metadata

Hold produkter, der kun sælges online, ude af appen med en enkelt metadatanøgle.

Integration med URL-skemaer

Sådan fungerer det

Din app åbner en betaling:// URL med parametre

Betaling for Stripe starter og behandler transaktionen

Når det er færdigt, omdirigerer appen til din callback-URL med resultatet

Endepunkter

Opret en opkrævning

payment://new?

Behandl en engangsbetaling med beløb, valuta og beskrivelse.

Parametre

Navn	Type	Påkrævet	Beskrivelse
`amount`	integer	Ja	Beløb i cent (f.eks. 1000 = $10,00)
`currency`	string	Ingen	ISO-valutakode med tre bogstaver (standard: USD)
`description`	string	Ingen	URL-kodet debiteringsbeskrivelse
`customer`	string	Ingen	Eksisterende Stripe-kunde-ID
`email`	string	Ingen	Kundens e-mailadresse til kvittering
`name`	string	Ingen	URL-kodet kundenavn
`metadata`	string	Ingen	Brugerdefinerede nøgle-værdi-par (URL-kodet JSON)
`callback`	string	Ingen	URL, der skal vendes tilbage til efter færdiggørelse
`autoprocess`	boolean	Ingen	Spring startskærmen over og start opladning med det samme
`auto_return`	boolean	Ingen	Udfør callback, når resultatet indlæses, i stedet for at vente på, at forhandleren lukker resultatdialogboksen. Standardværdi: falsk.

Opret en faktura

payment://cart?

Opret en Stripe-faktura med linjeelementer fra dit produktkatalog.

Parametre

Navn	Type	Påkrævet	Beskrivelse
`prices`	string	Ja	Kommaseparerede pris-ID'er med mængder (f.eks. price_abc:2,price_xyz:1)
`customer`	string	Ingen	Eksisterende Stripe-kunde-ID
`email`	string	Ingen	Kundens e-mailadresse til kvittering
`name`	string	Ingen	URL-kodet kundenavn
`callback`	string	Ingen	URL, der skal vendes tilbage til efter færdiggørelse
`auto_return`	boolean	Ingen	Udfør callback, når resultatet indlæses, i stedet for at vente på, at forhandleren lukker resultatdialogboksen. Standardværdi: falsk.

Betal en eksisterende faktura (kun iOS)

payment://invoice?

Modtag en personlig betaling mod en eksisterende Stripe-faktura. Beløb, valuta, kunde og moms stammer fra fakturaen. Tilsidesættelse af disse afvises. Forhandleren trykker på et kort via læser / Tryk for at betale / manuel indtastning; når betalingen lykkes, markeres fakturaen som betalt uden for båndet og linkes via metadataene charge_id og payment_intent_id. Fakturaer med status som abonnementer, standardbetalingsmetode eller ikke-åben afvises med en handlingsrettet fejl.

Parametre

Navn	Type	Påkrævet	Beskrivelse
`id`	string	Ja	Stripe-faktura-ID (skal starte med in_)
`callback`	string	Ingen	URL, der skal vendes tilbage til efter afslutning. Modtager invoice_id og payment_intent_id, når processen er gennemført.
`metadata`	string	Ingen	Brugerdefinerede nøgle-værdi-par (URL-kodet JSON) flettet ind i PaymentIntent-metadataene
`autoprocess`	boolean	Ingen	Spring startskærmen over og start opladning med det samme
`auto_return`	boolean	Ingen	Udfør callback, når resultatet indlæses, i stedet for at vente på, at forhandleren lukker resultatdialogboksen. Standardværdi: falsk.

Håndtering af tilbagekald

Når transaktionen er fuldført, omdirigerer Payment for Stripe til din callback-URL med forespørgselsparametre, der angiver resultatet. Som standard aktiveres omdirigeringen, når forhandleren lukker resultatdialogboksen, så de kan foretage handlinger efter debitering (sende en kvittering via e-mail, refundere). Giv auto_return=true besked, så snart resultatet er kendt. Understøttes på iOS og Android.

Tilbagekaldsparametre

Parameter	Værdier	Beskrivelse
`status`	success \| error \| cancelled	Resultat af transaktionen
`charge_id`	string	Stripe-betalings-ID (ved succes)
`invoice_id`	string	Stripe faktura-ID (kun ved succes, betaling://fakturaflow)
`payment_intent_id`	string	Stripe PaymentIntent ID (kun ved succes, betaling://fakturaflow)
`error`	string	Fejlmeddelelse (ved fejl)

Eksempler

Simpel opladning

Opkræv 10,00 USD med blot et beløb

payment://new?amount=1000

Opkræv med beskrivelse

Opkræv 25,00 € med en beskrivelse

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

Opkræv med ny kunde

Opkræv 50,00 USD og opret en kundepost

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

Opkræv betaling fra eksisterende kunde

Opkræv 75,00 USD for en eksisterende Stripe-kunde

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

Opladning med metadata

Opkræv 100,00 USD for brugerdefinerede metadata til dine optegnelser

payment://new?amount=10000&description=Invoice%20%231234&metadata=%7B%22order_id%22%3A%221234%22%2C%22location%22%3A%22Store%20A%22%7D

Automatisk behandling med tilbagekald

Spring startskærmen over, og vend tilbage til din app, når du er færdig

payment://new?amount=3500&autoprocess=true&callback=myapp://payment-complete

Automatisk retur på resultat

Udfør tilbagekaldet, så snart resultatet er kendt, i stedet for at vente på, at forhandleren lukker resultatdialogboksen.

payment://new?amount=3500&autoprocess=true&auto_return=true&callback=myapp://payment-complete

Faktura med linjeposter

Opret en faktura med produkter fra dit Stripe-katalog

payment://cart?prices=price_coffee:2,price_muffin:1&[email protected]

Betal en eksisterende faktura (iOS)

Modtag personlig betaling for en eksisterende Stripe-faktura. Returnerer invoice_id og payment_intent_id, hvis betalingen er gennemført.

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

Komplet eksempel

Alle parametre kombineret for et fuldt integreret 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-kodning

Husk at URL-kode specialtegn i parameterværdier. Mellemrum bliver %20, krøllede parenteser bliver %7B og %7D.

Skjul produkter med metadata

Skjul produkter i appen

Appen viser produkterne og priserne fra din Stripe-konto. Vil du holde et af dem ude af appen (for eksempel varer, der kun sælges via din webshop), skal du tilføje denne metadatanøgle til produktet eller prisen i Stripe Dashboard:

payment_hidden = true

På et produkt: skjuler produktet og alle dets priser.

På en pris: skjuler kun den pris.

Fjern nøglen, eller sæt den til false, for at vise det igen. Ændringer træder i kraft, næste gang appen indlæser din produktliste.

Indkøbskurv-links virker fortsat

Skjulning påvirker kun produktlisten i appen. payment://cart-URL'er, der henviser til en skjult pris, virker stadig, og eksisterende abonnementer påvirkes ikke.

Klar til at integrere?

Download appen og begynd at teste din integration i dag.

Download appen Kontakt support