Käivita Payment for Stripe oma rakendusest (URL-i skeemid) – Payment for Stripe

Lühike vastus: Teie rakendus või veebisait avab URL- payment://, Payment for Stripe võtab makse vastu ja avab seejärel teie tagasihelistus-URL-i tulemusega. SDK-d pole. Serverit pole vaja. See töötab iPhone'is ja Androidis samamoodi, mõned erinevused on välja toodud allpool.

Täielik viitenumber asub aadressil paymentforstripe.com/api.

Kuidas see toimib

Teie rakendus avab parameetritega URL-i nimega payment://.
Payment for Stripe avaneb ja müük toimub. Kaupmees võtab makse vastu kaardilugeja, Tap to Pay või sisestatud kaardiga.
Kui see on valmis, avab rakendus teie callback URL-i, millele on tulemus lisatud päringuparameetritena.

Kaupmees peab olema sisse logitud. Kui link saabub samal ajal, kui mõni teine makse on pooleli, siis rakendus lükkab selle tagasi ja tagasihelistus annab veateate error=charge_in_progress.

Loo makse: payment://new

Ühekordne makse teie määratud summas.

Nimi	Tüüp	Nõutav	Kirjeldus
`amount`	täisarv	Jah	Summa valuuta väikseimas ühikus, mis on suurem kui 0. `1000` = 10,00 dollarit.
`currency`	nöör	Ei	Kolmetäheline ISO-kood, näiteks `usd` või `eur`. Kui see välja jätta, kasutab rakendus juba määratud valuutat.
`description`	nöör	Ei	Arve kirjeldus. URL-kodeeri see.
`customer`	nöör	Ei	Olemasolev Stripe kliendi ID ( `cus_…`). `customer_id` töötab samuti. Kui see on määratud, siis `email` ja `name` ignoreeritakse.
`email`	nöör	Ei	Kliendi e-posti aadress. Loob uue kliendi.
`name`	nöör	Ei	Kliendi nimi. URL-kodeeri see. Loo uus klient.
`metadata`	nöör	Ei	URL-kodeeringuga JSON-objekt võtme-väärtuse paaridest, mis lisatakse maksele. Kehtivad Stripe metaandmete piirangud.
`callback`	nöör	Ei	URL, mis avatakse pärast müügi lõppemist.
`autoprocess`	tõeväärtus	Ei	`true` jätab klaviatuuri vahele ja alustab laadimist kohe. Vaikimisi on `false`.
`auto_return`	tõeväärtus	Ei	`true` avab tagasihelistamise kohe, kui tulemus on teada. Vaikimisi `false`: tagasihelistamine ootab, kuni kaupmees tulemuste ekraani sulgeb.

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

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

Puuduva, nulli või mittenumbrilise amount linki ignoreeritakse.

Loo arve oma kataloogist: payment://cart

Täidab ostukorvi teie Stripe tootekataloogi hindadega. Seejärel arveldab kaupmees tavapäraselt ja müük salvestatakse Stripe tasutud arvena koos nende reaüksustega. See ei saada teie kliendile arvet e-postiga.

Nimi	Tüüp	Nõutav	Kirjeldus
`prices`	nöör	Jah	Komadega eraldatud `price_id:quantity` paarid, näiteks `price_abc:2,price_xyz:1`. `line_items` töötab samuti.
`coupon`	nöör	Ei	Ostukorvi lisamiseks Stripe kupongi ID.
`customer`	nöör	Ei	Olemasolev Stripe kliendi ID. `customer_id` töötab samuti.
`email`	nöör	Ei	Kliendi e-posti aadress. Loob uue kliendi.
`name`	nöör	Ei	Kliendi nimi. URL-kodeeri see.
`metadata`	nöör	Ei	URL-kodeeringuga võtme-väärtuse paaridest koosnev JSON-objekt.
`callback`	nöör	Ei	URL, mis avatakse pärast müügi lõppemist.
`autoprocess`	tõeväärtus	Ei	`true` alustab tasu võtmist pärast iga hinna (ja kupongi) laadimist.
`auto_return`	tõeväärtus	Ei	Sama mis ülalpool. Vaikimisi on `false`.

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

Ära saada koos prices amount. Kogusumma tuleb hindadest ja linki mõlemaga ignoreeritakse. Atribuudiga payment_hidden peidetud hinnad siin endiselt toimivad.

Maksa olemasolev arve: payment://invoice

Kogub avatud Stripe arve eest isikliku makse. Summa, valuuta, klient ja maks pärinevad kõik arvelt. Edu korral märgib rakendus arve makstuks. Töötab iPhone'is ja Androidis.

Nimi	Tüüp	Nõutav	Kirjeldus
`id`	nöör	Jah	Stripe arve ID. Peab algama `in_`. Saada avatud arve. iPhone'is lõpetatakse mustand kõigepealt. Androidis lükatakse mustand tagasi veateatega `error=invoice_state_changed` ".
`metadata`	nöör	Ei	URL-kodeeringuga JSON-objekt, mis on lisatud maksekavatsusele.
`callback`	nöör	Ei	URL, mis avatakse pärast müügi lõppemist. Edu korral saadakse `invoice_id` ja `payment_intent_id`.
`autoprocess`	tõeväärtus	Ei	`true` alustab tasu võtmist pärast arve kontrollide läbimist, ainult siis, kui kaardilugeja on ühendatud.
`auto_return`	tõeväärtus	Ei	Sama mis ülalpool. Vaikimisi on `false`.

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

Arve määrab müügi, seega kõik amount, currency, customer, customer_id, email, name, description, coupon, prices või line_items lingid lükatakse tagasi veakoodiga error=invoice_invalid_param. Arved, mis on tasutud, kehtetud, sissenõudmatud, 0 $, seotud tellimusega või määratud debiteerima vaikemakseviisi kaudu, lükatakse samuti tagasi, igaühel oma invoice_… veaga.

Tagasihelistamine

Rakendus lisab teie tagasihelistamise URL-ile järgmised:

Nimi	Tüüp	Saadetud	Kirjeldus
`status`	nöör	Alati	`success`, `error` või `cancelled`.
`charge_id`	nöör	Edu kohta	Makse ID. iPhone'is on see Stripe makse ( `ch_…`). Androidis on see PaymentIntent ( `pi_…`).
`stripe_charge_id`	nöör	Ainult Android	Stripe laeng ( `ch_…`).
`payment_intent_id`	nöör	Edu kohta	Maksekavatsus. iPhone saadab selle ainult `payment://invoice` jaoks. Android saadab selle iga kaardimakse puhul.
`invoice_id`	nöör	Arvete lingid	Tasutud arve, mille puhul `payment://invoice`.
`amount`	täisarv	Edu kohta	Arvestatud summa väikseimas ühikus.
`currency`	nöör	Edu kohta	Väiketäheline ISO-kood.
`error`	nöör	Vea korral	Lühike kood, näiteks `charge_in_progress` või `invoice_already_paid`, või loetav teade kaardi tagasilükkamise kohta.

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

Kas vajate mõlemal platvormil sama ID-d? Lugege esmalt stripe_charge_id ja seejärel kasutage charge_id.

Vanemate integratsioonide puhul saadab rakendus ka success=true, chargeId, cancelled=true ja error[message]. Uus kood peaks lugema status.

Tühistamine avab kohe tagasihelistamise. Makse õnnestumise või vea korral ootab kaupmees tulemuste ekraani sulgemist, välja arvatud juhul, kui edastate auto_return=true. iPhone'is ei ava sularahamüük kunagi tagasihelistamist, kuna midagi ei võetud.

URL-i kodeering

Kodeeri iga väärtus, mis sisaldab tühikuid või sümboleid. Tühikud muutuvad %20, { ja } muutuvad %7B ja %7D, " muutub %22, : muutub %3A.
Kui teie tagasihelistamis-URL-il on oma päringustring, kodeerige kogu tagasihelistamis-URL nii, et see & ei jagaks teie payment:// linki.
Komad ja koolonid prices võivad jääda nii, nagu nad on.

Metaandmetest {"order_id":"1234","location":"Store A"} saab:

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

Vanem metadata[order_id]=1234 vorm töötab samuti.