Start Payment for Stripe fra appen din (URL-skjemaer)

Kort svar: Appen eller nettstedet ditt åpner en payment:// -URL. Payment for Stripe tar imot betalingen og åpner deretter tilbakeringings-URL-en din med resultatet. Ingen SDK. Ingen serverarbeid. Det fungerer på samme måte på iPhone og Android, med noen få forskjeller som er nevnt nedenfor.

Den fullstendige referansen finnes på paymentforstripe.com/api.

Hvordan det fungerer

1. Appen din åpner en payment:// -URL med parametere.
2. Payment for Stripe åpnes og salget settes opp. Selgeren tar imot betalingen med en kortleser, Tap to Pay kort eller et maskinskrevet kort.
3. Når det er ferdig, åpner appen callback -URL-en din med resultatet lagt til som spørreparametere.

Selgeren må være logget på. Hvis en lenke mottas mens en annen betaling pågår, avviser appen den, og tilbakekallingen din får meldingen error=charge_in_progress.

Opprett en belastning: betaling://ny

En engangsbetaling for et beløp du angir.

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

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

En lenke med manglende, null eller ikke-numerisk amount ignoreres.

Opprett en faktura fra katalogen din: payment://cart

Fyller handlekurven med priser fra Stripe-produktkatalogen din. Selgeren fakturerer deretter som vanlig, og salget lagres i Stripe som en betalt faktura med disse linjeelementene. Den sender ikke en faktura til kunden din via e-post.

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

Ikke send amount med prices. Totalen kommer fra prisene, og en lenke med begge ignoreres. Priser skjult med payment_hidden fungerer fortsatt her.

Betal en eksisterende faktura: betaling://faktura

Samler inn en personlig betaling for en åpen Stripe faktura. Beløp, valuta, kunde og avgift kommer fra fakturaen. Ved vellykket betaling markerer appen fakturaen som betalt. Fungerer på iPhone og Android.

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

Fakturaen angir salget, så alle av følgende: amount, currency, customer, customer_id, email, name, description, coupon, prices eller line_items får lenken avvist med error=invoice_invalid_param. Fakturaer som er betalte, ugyldige, ikke kan innkreves, $0, knyttet til et abonnement eller satt til å belastes med en standard betalingsmåte, blir også avvist, hver med sin egen invoice_… -feil.

Tilbakeringingen

Appen legger til disse i tilbakeringings-URL-en din:

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

Trenger du samme ID på begge plattformene? Les stripe_charge_id først, og bruk deretter charge_id.

For eldre integrasjoner sender appen også success=true, chargeId, cancelled=true og error[message]. Ny kode skal lese status.

En avbryting åpner tilbakeringingen med en gang. En belastnings suksess eller feil venter på at selgeren lukker resultatskjermen, med mindre du sender auto_return=true. På iPhone åpner et kontantsalg aldri tilbakeringingen, siden ingenting ble belastet.

URL-koding

• Kod alle verdier som har mellomrom eller symboler. Mellomrom blir %20, { og } blir %7B og %7D, " blir %22, : blir %3A.
• Hvis tilbakeringings-URL-en din har sin egen spørrestreng, må du kode hele tilbakeringingen slik at den & ikke deler opp payment:// -lenken din.
• Kommaene og kolonene i prices kan forbli som de er.

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

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

Det eldre skjemaet metadata[order_id]=1234 fungerer også.