Tweġiba qasira: L-app jew il-websajt tiegħek tiftaħ URL ta' payment://, Payment for Stripe jieħu l-ħlas, imbagħad jiftaħ il-URL ta' callback tiegħek bir-riżultat. L-ebda SDK. L-ebda xogħol fuq is-server. Jaħdem l-istess fuq iPhone u Android, bi ftit differenzi msemmija hawn taħt.
Ir-referenza sħiħa tinsab fuq paymentforstripe.com/api.
Kif jaħdem
- L-app tiegħek tiftaħ URL ta'
payment://bil-parametri. - Payment for Stripe jiftaħ u jistabbilixxi l-bejgħ. Il-kummerċjant jieħu l-ħlas b'qarrej, Tap to Pay, jew b'karta ttajpjata.
- Meta jkun lest, l-app tiftaħ il-URL
callbacktiegħek bir-riżultat miżjud bħala parametri tal-mistoqsija.
Il-kummerċjant jeħtieġ li jkun illoggjat. Jekk tasal link waqt li jkun qed jiġri ħlas ieħor, l-app tirrifjutah u s-sejħa lura tiegħek tirċievi error=charge_in_progress.
Oħloq ħlas: ħlas://ġdid
Ħlas ta' darba għal ammont li tistabbilixxi int.
| Isem | Tip | Meħtieġ | Deskrizzjoni |
|---|---|---|---|
amount
|
numru sħiħ | Iva | Ammont fl-iżgħar unità tal-munita, akbar minn 0. 1000 = $10.00. |
currency
|
spag | Le | Kodiċi ISO bi tliet ittri, bħal usd jew eur. Ħallih barra u l-app tuża l-munita li diġà hija ssettjata għaliha. |
description
|
spag | Le | Deskrizzjoni tal-ħlas. Ikkodifikaha bil-URL. |
customer
|
spag | Le | ID tal-klijent Stripe eżistenti ( cus_…). customer_id jaħdem ukoll. Meta jiġi ssettjat, email u name jiġu injorati. |
email
|
spag | Le | Email tal-klijent. Joħloq klijent ġdid. |
name
|
spag | Le | Isem il-klijent. Ikkodifikah bil-URL. Joħloq klijent ġdid. |
metadata
|
spag | Le | Oġġett JSON ikkodifikat bil-URL ta' pari ta' ċavetta-valur, miżjud mal-ħlas. Japplikaw il-limiti tal-metadata ta' Stripe. |
callback
|
spag | Le | URL biex tiftaħ meta tispiċċa l-bejgħ. |
autoprocess
|
Boolean | Le | true jaqbeż it-tastiera u jibda l-iċċarġjar minnufih. Default false. |
auto_return
|
Boolean | Le | true jiftaħ is-sejħa lura hekk kif ir-riżultat ikun magħruf. Default false: is-sejħa lura tistenna sakemm il-kummerċjant jagħlaq l-iskrin tar-riżultat. |
payment://new?amount=2500¤cy=eur&description=Coffee%20and%20pastry payment://new?amount=3500&autoprocess=true&auto_return=true&callback=myapp://payment-complete Link amount nieqes, żero, jew mhux numeriku jiġi injorat.
Oħloq fattura mill-katalgu tiegħek: payment://cart
Jimla l-karrettun bil-prezzijiet mill-katalgu tal-prodotti Stripe tiegħek. Il-bejjiegħ imbagħad jiċċarġja bħas-soltu, u l-bejgħ jiġi ssejvjat fi Stripe bħala fattura mħallsa ma' dawk l-oġġetti tal-linja. Ma jibgħatx fattura lill-klijent tiegħek bl-email.
| Isem | Tip | Meħtieġ | Deskrizzjoni |
|---|---|---|---|
prices
|
spag | Iva | Parijiet price_id:quantity separati b'virgola, bħal price_abc:2,price_xyz:1. line_items jaħdem ukoll. |
coupon
|
spag | Le | ID tal-kupun Stripe biex tapplika għall-karrettun. |
customer
|
spag | Le | L-ID tal-klijent Stripe eżistenti. customer_id jaħdem ukoll. |
email
|
spag | Le | Email tal-klijent. Joħloq klijent ġdid. |
name
|
spag | Le | Isem il-klijent. Kodifikah bil-URL. |
metadata
|
spag | Le | Oġġett JSON ikkodifikat bil-URL ta' pari ta' ċavetta-valur. |
callback
|
spag | Le | URL biex tiftaħ meta tispiċċa l-bejgħ. |
autoprocess
|
Boolean | Le | true jibda l-ħlas ladarba kull prezz (u l-kupun) ikun tgħabba. |
auto_return
|
Boolean | Le | L-istess bħal hawn fuq. Default false. |
payment://cart?prices=price_coffee:2,price_muffin:1&email=customer@example.com Tibgħatx amount bil- prices. It-total jiġi mill-prezzijiet, u link mat-tnejn jiġi injorat. Il-prezzijiet moħbija b'payment_hidden xorta jaħdmu hawn.
Ħallas fattura eżistenti: ħlas://fattura
Jiġbor ħlas personalment għal fattura miftuħa ta' Stripe. L-ammont, il-munita, il-klijent, u t-taxxa kollha jiġu mill-fattura. Jekk jirnexxi, l-app timmarka l-fattura mħallsa. Jaħdem fuq iPhone u Android.
| Isem | Tip | Meħtieġ | Deskrizzjoni |
|---|---|---|---|
id
|
spag | Iva | ID tal-fattura Stripe. Irid jibda in_. Ibgħat fattura miftuħa. Fuq iPhone, abbozz jiġi ffinalizzat l-ewwel. Fuq Android, abbozz jiġi miċħud error=invoice_state_changed. |
metadata
|
spag | Le | Oġġett JSON ikkodifikat bil-URL, miżjud mal-PaymentIntent. |
callback
|
spag | Le | URL biex tiftaħ meta l-bejgħ jintemm. Jikseb invoice_id u payment_intent_id jekk jirnexxi. |
autoprocess
|
Boolean | Le | true jibda l-iċċarġjar wara li jgħaddu l-verifiki tal-fattura, biss meta jkun imqabbad qarrej tal-kards. |
auto_return
|
Boolean | Le | L-istess bħal hawn fuq. Default false. |
payment://invoice?id=in_1ABC123xyz&autoprocess=true&callback=myapp://invoice-paid Il-fattura tissettja l-bejgħ, għalhekk kwalunkwe minn amount, currency, customer, customer_id, email, name, description, coupon, prices, jew line_items iġib il-link miċħud error=invoice_invalid_param. Il-fatturi li huma mħallsa, nulli, ma jistgħux jinġabru, $0, marbuta ma' abbonament, jew issettjati biex jiċċarġjaw metodu ta' ħlas awtomatiku jiġu miċħuda wkoll, kull waħda bl-iżball invoice_… tagħha stess.
Is-sejħa lura
L-app iżżid dawn mal-URL tas-sejħa lura tiegħek:
| Isem | Tip | Mibgħut | Deskrizzjoni |
|---|---|---|---|
status
|
spag | Dejjem | success, error, jew cancelled. |
charge_id
|
spag | Fuq is-suċċess | L-ID tal-ħlas. Fuq iPhone huwa l-ħlas Stripe ( ch_…). Fuq Android huwa l-PaymentIntent ( pi_…). |
stripe_charge_id
|
spag | Android biss | Il-ħlas ta Stripe ( ch_…). |
payment_intent_id
|
spag | Fuq is-suċċess | Il-PaymentIntent. iPhone jibgħatha għal payment://invoice biss. Android jibgħatha għal kull ħlas bil-kard. |
invoice_id
|
spag | Links tal-fatturi | Il-fattura mħallsa, għal payment://invoice. |
amount
|
numru sħiħ | Fuq is-suċċess | Ammont mitlub, fl-iżgħar unità. |
currency
|
spag | Fuq is-suċċess | Kodiċi ISO b'ittri żgħar. |
error
|
spag | Fuq żball | Kodiċi qasir bħal charge_in_progress jew invoice_already_paid, jew messaġġ li jinqara għal kard miċħuda. |
myapp://payment-complete?status=success&charge_id=ch_3Qx…&success=true&amount=3500¤cy=usd&chargeId=ch_3Qx… Teħtieġ l-istess ID fuq iż-żewġ pjattaformi? Aqra stripe_charge_id l-ewwel, imbagħad erġa' lura għal charge_id.
Għal integrazzjonijiet eqdem, l-app tibgħat ukoll success=true, chargeId, cancelled=true, u error[message]. Il-kodiċi l-ġdid għandu jaqra status.
Kanċellazzjoni tiftaħ is-sejħa lura minnufih. Is-suċċess jew l-iżball ta' ħlas jistenna li l-kummerċjant jagħlaq l-iskrin tar-riżultat, sakemm ma tgħaddix auto_return=true. Fuq l-iPhone, bejgħ bi flus kontanti qatt ma jiftaħ is-sejħa lura, peress li ma ġie ċċarġjat xejn.
Kodifikazzjoni tal-URL
- Ikkodifika kull valur li fih spazji jew simboli. L-ispazji jsiru
%20,{u}isiru%7Bu%7D,"issir%22,:issir%3A. - Jekk il-URL tas-sejħa lura tiegħek għandu s-sekwenza tal-mistoqsija tiegħu stess, ikkodifika s-sejħa lura kollha sabiex il-
&ma tifridx il-linkpayment://tiegħek. - Il-virgoli u l-kolon fil
pricesjistgħu jibqgħu kif inhuma.
Il-Metadata {"order_id":"1234","location":"Store A"} issir:
payment://new?amount=10000&description=Invoice%20%231234&metadata=%7B%22order_id%22%3A%221234%22%2C%22location%22%3A%22Store%20A%22%7D Il-formola l-antika metadata[order_id]=1234 taħdem ukoll.