Lansează Payment for Stripe din aplicația ta (scheme URL)

Răspuns scurt: Aplicația sau site-ul web deschide o adresă URL payment://, Payment for Stripe preia plata, apoi deschide adresa URL de apel invers cu rezultatul. Fără SDK. Nicio funcționare pe server. Funcționează la fel pe iPhone și Android, cu câteva diferențe menționate mai jos.

Referința completă se găsește la paymentforstripe.com/api.

Cum funcționează

1. Aplicația ta deschide o adresă URL payment:// cu parametri.
2. Payment for Stripe se deschide și configurează vânzarea. Comerciantul preia plata cu un cititor, Tap to Pay sau cu un card introdus la mașină.
3. Când este gata, aplicația deschide adresa URL callback, rezultatul fiind adăugat ca parametri de interogare.

Comerciantul trebuie să fie conectat. Dacă un link sosește în timp ce o altă plată este în curs, aplicația îl refuză și apelul dvs. de retur primește error=charge_in_progress.

Creați o taxă: plată://nou

O plată unică pentru o sumă stabilită de dumneavoastră.

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

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

O legătură cu o amount lipsă, zero sau non-numerică este ignorată.

Creați o factură din catalogul dvs.: payment://cart

Completează coșul cu prețuri din catalogul tău de produse Stripe. Comerciantul percepe apoi taxele ca de obicei, iar vânzarea este salvată în Stripe ca factură plătită cu articolele respective. Nu trimite o factură prin e-mail clientului tău.

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

Nu trimiteți amount cu prices. Totalul provine din prețuri, iar un link cu ambele este ignorat. Prețurile ascunse cu payment_hidden funcționează în continuare aici.

Plata unei facturi existente: payment://invoice

Colectează o plată în persoană pentru o factură Stripe deschisă. Suma, moneda, clientul și taxa provin toate din factură. În caz de succes, aplicația marchează factura ca fiind plătită. Funcționează pe iPhone și Android.

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

Factura setează vânzarea, așadar oricare dintre amount, currency, customer, customer_id, email, name, description, coupon, prices sau line_items primește linkul refuzat cu error=invoice_invalid_param. Facturile plătite, nule, neîncasabile, cu valoarea de 0 USD, legate de un abonament sau setate să debiteze o metodă de plată implicită sunt, de asemenea, refuzate, fiecare cu propria eroare invoice_….

Apelul invers

Aplicația adaugă următoarele la adresa URL de apel invers:

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

Aveți nevoie de același ID pe ambele platforme? Citiți mai întâi stripe_charge_id, apoi reveniți la charge_id.

Pentru integrările mai vechi, aplicația trimite și success=true, chargeId, cancelled=true și error[message]. Noul cod ar trebui să citească status.

O anulare deschide imediat apelul invers. Succesul sau eroarea unei plăți așteaptă ca comerciantul să închidă ecranul cu rezultate, cu excepția cazului în care transmiteți auto_return=true. Pe iPhone, o vânzare cu numerar nu deschide niciodată apelul invers, deoarece nu s-a perceput nimic.

Codificare URL

• Codificați fiecare valoare care conține spații sau simboluri. Spațiile devin %20, { și } devin %7B, iar %7D, " devine %22, : devine %3A.
• Dacă adresa URL de apel invers are propriul șir de interogare, codificați întreaga apel invers astfel încât să fie & să nu divizeze linkul payment://.
• Virgulele și două punctele din prices pot rămâne neschimbate.

Metadatele {"order_id":"1234","location":"Store A"} devin:

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

Și formularul mai vechi metadata[order_id]=1234 funcționează.