Spusťte Payment for Stripe z vaší aplikace (URL schémata)

Stručná odpověď: Vaše aplikace nebo webová stránka otevře URL payment://, Payment for Stripe platbu přijme a poté otevře vaši URL adresu zpětného volání s výsledkem. Žádné SDK. Žádná práce se serverem. Funguje to stejně na iPhonu i Androidu, s několika rozdíly uvedenými níže.

Celý referenční text je k dispozici na adrese paymentforstripe.com/api.

Jak to funguje

1. Vaše aplikace otevírá URL adresu payment:// s parametry.
2. Payment for Stripe se otevře a nastaví prodej. Obchodník přijme platbu čtečkou, Tap to Pay nebo vytištěnou kartou.
3. Po dokončení aplikace otevře vaši URL callback s výsledkem přidaným jako parametry dotazu.

Obchodník musí být přihlášen. Pokud odkaz dorazí během probíhajícího jiného nabíjení, aplikace jej zamítne a vaše zpětné volání dostane error=charge_in_progress.

Vytvořit platbu: payment://new

Jednorázová platba ve vámi stanovené částce.

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

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

Odkaz s chybějící, nulovou nebo nečíselnou amount je ignorován.

Vytvořte fakturu z vašeho katalogu: platba://košík

Naplní košík cenami z vašeho katalogu produktů Stripe. Obchodník poté účtuje jako obvykle a prodej se uloží do Stripe jako zaplacená faktura s těmito položkami. Zákazníkovi se faktura e-mailem nezasílá.

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

Neposílejte amount s prices. Celková částka pochází z cen a odkaz na obě se ignoruje. Ceny skryté pomocí payment_hidden zde stále fungují.

Zaplatit existující fakturu: platba://faktura

Osobně inkasuje platbu za otevřenou fakturu Stripe. Částka, měna, zákazník a daň pocházejí z faktury. V případě úspěchu aplikace označí fakturu jako zaplacenou. Funguje na iPhonu a Androidu.

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

Faktura nastavuje prodej, takže u jakékoli položky s hodnotou amount, currency, customer, customer_id, email, name, description, coupon, prices nebo line_items bude odkaz odmítnut s error=invoice_invalid_param. Faktury, které jsou zaplacené, neplatné, nevymahatelné, v hodnotě 0 $, vázané na předplatné nebo nastavené na inkaso výchozí metody platby, jsou také odmítnuty, každá s vlastní chybou invoice_….

Zpětné volání

Aplikace přidá do vaší adresy URL zpětného volání tyto položky:

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

Potřebujete stejné ID na obou platformách? Nejprve si přečtěte stripe_charge_id a poté se vraťte k charge_id.

U starších integrací aplikace také odesílá success=true, chargeId, cancelled=true a error[message]. Nový kód by měl mít hodnotu status.

Zrušení okamžitě spustí zpětné volání. Úspěšné nebo chybné provedení platby čeká na zavření obrazovky s výsledky ze strany obchodníka, pokud nepředáte auto_return=true. Na iPhonu prodej v hotovosti nikdy neotevře zpětné volání, protože nebylo nic účtováno.

Kódování URL

• Zakódujte každou hodnotu, která obsahuje mezery nebo symboly. Mezery se stanou %20, { a } se stanou %7B a %7D, " se stane %22, : se stane %3A.
• Pokud má vaše adresa URL zpětného volání vlastní řetězec dotazu, zakódujte celou adresu zpětného volání tak, aby její znak & nerozděloval váš odkaz payment://.
• Čárky a dvojtečky v prices mohou zůstat tak, jak jsou.

Metadata {"order_id":"1234","location":"Store A"} se stanou:

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

Starší formulář metadata[order_id]=1234 funguje také.