Paleiskite Payment for Stripe iš savo programėlės (URL schemos) – Payment for Stripe

Trumpas atsakymas: jūsų programėlė arba svetainė atidaro payment:// URL adresą, Payment for Stripe priima mokėjimą, tada atidaro jūsų atgalinio iškvietimo URL adresą su rezultatu. Jokių SDK. Nereikia serverio. Tai veikia taip pat „iPhone“ ir „Android“ įrenginiuose, su keliais skirtumais, nurodytais toliau.

Visa nuoroda pateikiama adresu paymentforstripe.com/api.

Kaip tai veikia

Jūsų programėlė atidaro payment:// URL adresą su parametrais.
Atidaromas Payment for Stripe ir nustatomas pardavimas. Pardavėjas priima mokėjimą skaitytuvu, Tap to Pay “ arba įvesta kortele.
Kai tai bus baigta, programa atidarys jūsų callback URL su rezultatu, pridėtu kaip užklausos parametrais.

Pardavėjas turi būti prisijungęs. Jei nuoroda gaunama, kol vyksta kitas mokėjimas, programėlė ją atmeta, o jūsų grįžtamasis iškvietimas gauna error=charge_in_progress “.

Sukurkite mokestį: payment://new

Vienkartinis mokėjimas už jūsų nustatytą sumą.

Vardas	Tipas	Privaloma	Aprašymas
`amount`	sveikasis skaičius	Taip	Suma mažiausiu valiutos vienetu, didesniu už 0. `1000` = 10,00 USD.
`currency`	styga	Ne	Trijų raidžių ISO kodas, pvz., `usd` arba `eur`. Praleiskite jį ir programa naudos jau nustatytą valiutą.
`description`	styga	Ne	Mokesčio aprašymas. Užkoduokite jį URL.
`customer`	styga	Ne	Esamas Stripe kliento ID ( `cus_…`). `customer_id` taip pat veikia. Kai nustatytas, `email` ir `name` ignoruojami.
`email`	styga	Ne	Kliento el. pašto adresas. Sukuriamas naujas klientas.
`name`	styga	Ne	Kliento vardas. Užkoduokite jį URL adresu. Sukurkite naują klientą.
`metadata`	styga	Ne	URL užkoduotas JSON objektas iš raktų ir reikšmių porų, pridėtas prie mokėjimo. Taikomi „ Stripe “ metaduomenų apribojimai.
`callback`	styga	Ne	URL, kurį reikia atidaryti pasibaigus išpardavimui.
`autoprocess`	loginė reikšmė	Ne	`true` praleidžia klaviatūrą ir iš karto pradeda krauti. Numatytoji reikšmė – `false`.
`auto_return`	loginė reikšmė	Ne	`true` atidaro grįžtamąjį iškvietimą, kai tik sužinomas rezultatas. Numatytoji reikšmė `false`: grįžtamasis iškvietimas laukia, kol pardavėjas uždaro rezultatų ekraną.

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

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

Ryšys su trūkstama, nuline arba neskaitine amount ignoruojamas.

Sukurkite sąskaitą faktūrą iš savo katalogo: payment://cart

Krepšelis užpildomas kainomis iš jūsų Stripe produktų katalogo. Tada pardavėjas apmokestina kaip įprasta, o pardavimas išsaugomas Stripe sistemoje kaip apmokėta sąskaita faktūra su tomis eilutėmis. Sąskaita faktūra klientui el. paštu nesiunčiama.

Vardas	Tipas	Privaloma	Aprašymas
`prices`	styga	Taip	Kableliais atskirtos `price_id:quantity` poros, pvz., `price_abc:2,price_xyz:1` “. `line_items` taip pat veikia.
`coupon`	styga	Ne	Stripe kupono ID, kurį reikia pritaikyti krepšeliui.
`customer`	styga	Ne	Esamas Stripe kliento ID. `customer_id` taip pat veikia.
`email`	styga	Ne	Kliento el. pašto adresas. Sukuriamas naujas klientas.
`name`	styga	Ne	Kliento vardas. Užkoduokite jį URL formatu.
`metadata`	styga	Ne	URL užkoduotas JSON objektas iš rakto ir reikšmės porų.
`callback`	styga	Ne	URL, kurį reikia atidaryti pasibaigus išpardavimui.
`autoprocess`	loginė reikšmė	Ne	`true` pradeda apmokestinimą, kai įkeliama kiekviena kaina (ir kuponas).
`auto_return`	loginė reikšmė	Ne	Tas pats, kas aukščiau. Numatytoji reikšmė yra `false`.

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

Nesiųskite amount su prices. Bendra suma gaunama iš kainų, o nuoroda su abiem ignoruojama. Kainos, paslėptos naudojant „payment_hidden“, čia vis tiek veikia.

Apmokėti esamą sąskaitą faktūrą: payment://invoice

Surenka mokėjimą iš banko už neapmokėtą Stripe sąskaitą faktūrą. Suma, valiuta, klientas ir mokesčiai yra iš sąskaitos faktūros. Sėkmingai surenkant, programa pažymi sąskaitą faktūrą kaip apmokėtą. Veikia „iPhone“ ir „Android“ įrenginiuose.

Vardas	Tipas	Privaloma	Aprašymas
`id`	styga	Taip	Stripe sąskaitos faktūros ID. Turi prasidėti `in_`. Siųsti neapmokėtą sąskaitą faktūrą. „iPhone“ telefone pirmiausia užbaigiamas juodraštis. „Android“ telefone juodraštis atmetamas su `error=invoice_state_changed`.
`metadata`	styga	Ne	URL užkoduotas JSON objektas, pridėtas prie „PaymentIntent“.
`callback`	styga	Ne	URL, kurį reikia atidaryti pasibaigus pardavimui. Sėkmingai įvykus, gaunami `invoice_id` ir `payment_intent_id`.
`autoprocess`	loginė reikšmė	Ne	`true` pradeda nuskaityti mokestį po to, kai sąskaitos faktūros patikrinimas sėkmingas, tik tada, kai prijungtas kortelių skaitytuvas.
`auto_return`	loginė reikšmė	Ne	Tas pats, kas aukščiau. Numatytoji reikšmė yra `false`.

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

Sąskaita faktūra nustato pardavimą, todėl bet kuri iš šių reikšmių: amount “, currency, customer, customer_id, email, „ name “, „ description “, coupon “, prices “ arba line_items gauna atmetimą su klaida „ error=invoice_invalid_param “. Apmokėtos, anuliuotos, neapmokamos, 0 USD vertės, susietos su prenumerata arba nustatytos apmokėti pagal numatytąjį mokėjimo būdą sąskaitos faktūros taip pat atmetamos, kiekvienai iš jų pateikiant atskirą klaidą invoice_….

Atgalinis skambutis

Programa prideda šiuos duomenis prie jūsų atgalinio iškvietimo URL:

Vardas	Tipas	Išsiųsta	Aprašymas
`status`	styga	Visada	`success`, `error` arba `cancelled`.
`charge_id`	styga	Apie sėkmę	Mokėjimo ID. „iPhone“ telefone tai yra Stripe mokėjimas ( `ch_…`). „Android“ telefone tai yra „PaymentIntent“ ( `pi_…`).
`stripe_charge_id`	styga	Tik „Android“	Stripe mokestis ( `ch_…`).
`payment_intent_id`	styga	Apie sėkmę	Mokėjimo ketinimas. „iPhone“ siunčia jį tik `payment://invoice`. „Android“ siunčia jį kiekvieno mokėjimo kortele metu.
`invoice_id`	styga	Sąskaitų faktūrų nuorodos	Apmokėta sąskaita faktūra, skirta `payment://invoice`.
`amount`	sveikasis skaičius	Apie sėkmę	Nuskaičiuota suma, išreikšta mažiausiu vienetu.
`currency`	styga	Apie sėkmę	Mažosios raidės ISO kodas.
`error`	styga	Įvykus klaidai	Trumpas kodas, pvz., `charge_in_progress` “ arba `invoice_already_paid` “, arba įskaitomas pranešimas, jei kortelė atmesta.

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

Reikia to paties ID abiejose platformose? Pirmiausia perskaitykite stripe_charge_id, tada grįžkite prie charge_id.

Senesnėms integracijoms programa taip pat siunčia success=true, chargeId, cancelled=true “ ir error[message]. Naujas kodas turėtų skaityti status.

Atšaukimas iš karto atidaro atgalinį skambutį. Sėkmingas arba klaidingas mokėjimas laukia, kol pardavėjas uždarys rezultatų ekraną, nebent perduodate auto_return=true. „iPhone“ telefone grynaisiais pinigais atliktas pirkimas niekada neatidaro atgalinio skambučio, nes niekas nebuvo nuskaičiuota.

URL kodavimas

Užkoduokite kiekvieną reikšmę, kurioje yra tarpų arba simbolių. Tarpai tampa %20, { ir } tampa %7B, o %7D, " tampa %22, : tampa %3A.
Jei jūsų atgalinio iškvietimo URL turi savo užklausos eilutę, užkoduokite visą atgalinį iškvietimą taip, & jis nepadalintų jūsų payment:// nuorodos.
Kableliai ir dvitaškiai prices gali likti tokie, kokie yra.

Metaduomenys {"order_id":"1234","location":"Store A"} tampa:

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

Senesnė metadata[order_id]=1234 forma taip pat veikia.