Start Payment for Stripe fra din app (URL-ordninger)

Kort svar: Din app eller dit websted åbner en payment:// URL. Payment for Stripe tager imod betalingen og åbner derefter din callback URL med resultatet. Intet SDK. Intet serverarbejde. Det fungerer på samme måde på iPhone og Android, med et par forskelle, der er nævnt nedenfor.

Den fulde reference findes på paymentforstripe.com/api.

Sådan fungerer det

1. Din app åbner en payment:// URL med parametre.
2. Payment for Stripe åbner og sætter salget op. Forhandleren tager imod betalingen med en kortlæser, Tap to Pay eller et indtastet kort.
3. Når det er færdigt, åbner appen din callback URL med resultatet tilføjet som forespørgselsparametre.

Forhandleren skal være logget ind. Hvis der modtages et link, mens en anden faktura kører, afviser appen det, og dit tilbagekald får meddelelsen error=charge_in_progress.

Opret en regning: betaling://ny

En engangsbetaling på et beløb, du fastsætter.

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

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

Et link med et manglende, nul eller ikke-numerisk amount ignoreres.

Opret en faktura fra dit katalog: payment://cart

Fylder indkøbskurven med priser fra dit Stripe produktkatalog. Forhandleren betaler derefter som sædvanligt, og salget gemmes i Stripe som en betalt faktura med disse linjeposter. Den sender ikke en faktura via e-mail til din kunde.

 payment://cart?prices=price_coffee:2,price_muffin:1&email=customer@example.com

Send ikke amount med prices. Totalen kommer fra priserne, og et link med begge ignoreres. Priser skjult med payment_hidden virker stadig her.

Betal en eksisterende faktura: betaling://faktura

Indsamler en personlig betaling for en åben Stripe faktura. Beløb, valuta, kunde og moms stammer alle fra fakturaen. Når betalingen er gennemført, markerer appen fakturaen som betalt. Virker på iPhone og Android.

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

Fakturaen angiver salget, så alle af følgende: amount, currency, customer, customer_id, email, name, description, coupon, prices eller line_items får linket afvist med error=invoice_invalid_param. Fakturaer, der er betalte, ugyldige, ikke-inddrivelige, $0, knyttet til et abonnement eller indstillet til at fakturere en standardbetalingsmetode, afvises også, hver med sin egen invoice_… -fejl.

Tilbagekaldet

Appen tilføjer disse til din callback-URL:

 myapp://payment-complete?status=success&charge_id=ch_3Qx…&success=true&amount=3500&currency=usd&chargeId=ch_3Qx…

Brug for det samme ID på begge platforme? Læs stripe_charge_id først, og brug derefter charge_id.

For ældre integrationer sender appen også success=true, chargeId, cancelled=true og error[message]. Ny kode bør læse status.

En annullering åbner tilbagekaldet med det samme. En fakturas succes eller fejl venter på, at forhandleren lukker resultatskærmen, medmindre du sender auto_return=true. På iPhone åbner et kontantsalg aldrig tilbagekaldet, da der ikke er blevet faktureret noget.

URL-kodning

• Indkod alle værdier, der indeholder mellemrum eller symboler. Mellemrum bliver %20, { og } bliver %7B og %7D, " bliver %22, : bliver %3A.
• Hvis din callback-URL har sin egen forespørgselsstreng, skal du indkode hele callback-adressen, så den & ikke opdeler dit payment:// link.
• Kommaerne og kolonene i prices kan forblive, som de er.

Metadata {"order_id":"1234","location":"Store A"} bliver:

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

Den ældre metadata[order_id]=1234 formular fungerer også.