API za razvojne programere
Integrirajte i prilagoditi
Pokrenite plaćanje za Stripe iz vlastite aplikacije ili web stranice s URL shemama i kontrolirajte koji se proizvodi pojavljuju u aplikaciji izravno s vaše Stripe nadzorne ploče.
Integracija sa shemama URL-ova
Kako funkcionira
Vaša aplikacija otvara plaćanje:// URL s parametrima
Plaćanje za Stripe pokreće i obrađuje transakciju
Nakon završetka, aplikacija preusmjerava na vaš URL povratnog poziva s rezultatom
Krajnje točke
Napravi naplatu
payment://new?Obradite jednokratno plaćanje s iznosom, valutom i opisom.
Parametri
| Ime | Tip | Potreban | Opis |
|---|---|---|---|
amount | integer | Da | Iznos u centima (npr. 1000 = 10,00 USD) |
currency | string | Ne | Troslovni ISO kod valute (zadano: USD) |
description | string | Ne | Opis naplate kodiran URL-om |
customer | string | Ne | Postojeći Stripe ID korisnika |
email | string | Ne | E-pošta kupca za potvrdu |
name | string | Ne | URL-kodirano ime korisnika |
metadata | string | Ne | Prilagođeni parovi ključ-vrijednost (URL-kodirani JSON) |
callback | string | Ne | URL za povratak nakon završetka |
autoprocess | boolean | Ne | Preskoči početni zaslon i odmah pokreni punjenje |
auto_return | boolean | Ne | Aktiviraj povratni poziv kada se rezultat učita umjesto čekanja da trgovac zatvori dijalog s rezultatima. Zadana vrijednost je "false". |
Izradi fakturu
payment://cart?Izradite Stripe fakturu s stavkama iz vašeg kataloga proizvoda.
Parametri
| Ime | Tip | Potreban | Opis |
|---|---|---|---|
prices | string | Da | ID-ovi cijena odvojeni zarezima s količinama (npr. price_abc:2, price_xyz:1) |
customer | string | Ne | Postojeći Stripe ID korisnika |
email | string | Ne | E-pošta kupca za potvrdu |
name | string | Ne | URL-kodirano ime korisnika |
callback | string | Ne | URL za povratak nakon završetka |
auto_return | boolean | Ne | Aktiviraj povratni poziv kada se rezultat učita umjesto čekanja da trgovac zatvori dijalog s rezultatima. Zadana vrijednost je "false". |
Plaćanje postojeće fakture (samo za iOS)
payment://invoice?Naplatite osobno na temelju postojećeg Stripe računa. Iznos, valuta, kupac i porez potječu s računa. Poništavanje bilo kojeg od tih podataka se odbija. Trgovac prisloni karticu putem čitača / Tap to Pay / ručno unese; u slučaju uspjeha, račun se označava kao plaćen izvan opsega i povezuje se putem metapodataka charge_id i payment_intent_id. Računi s pretplatama, default_payment_method ili neotvorenim statusom odbijaju se s pogreškom na koju se može primijeniti mjera.
Parametri
| Ime | Tip | Potreban | Opis |
|---|---|---|---|
id | string | Da | ID Stripe fakture (mora započeti s in_) |
callback | string | Ne | URL za povratak nakon završetka. U slučaju uspjeha prima invoice_id i payment_intent_id. |
metadata | string | Ne | Prilagođeni parovi ključ-vrijednost (URL-kodirani JSON) spojeni su u metapodatke PaymentIntent-a |
autoprocess | boolean | Ne | Preskoči početni zaslon i odmah pokreni punjenje |
auto_return | boolean | Ne | Aktiviraj povratni poziv kada se rezultat učita umjesto čekanja da trgovac zatvori dijalog s rezultatima. Zadana vrijednost je "false". |
Obrada povratnih poziva
Kada se transakcija završi, Payment for Stripe preusmjerava na vaš URL povratnog poziva s parametrima upita koji ukazuju na rezultat. Prema zadanim postavkama, preusmjeravanje se aktivira nakon što trgovac odbaci dijalog s rezultatom kako bi mogao poduzeti radnje nakon naplate (slanje računa e-poštom, povrat novca). Proslijedite auto_return=true da bi se preusmjeravanje aktiviralo čim rezultat bude poznat. Podržano na iOS-u i Androidu.
Parametri povratnog poziva
| Parametar | Vrijednosti | Opis |
|---|---|---|
status | success | error | cancelled | Rezultat transakcije |
charge_id | string | ID naplate putem Stripe-a (u slučaju uspjeha) |
invoice_id | string | ID Stripe fakture (u slučaju uspjeha, samo tijek plaćanja://fakture) |
payment_intent_id | string | ID namjere plaćanja Stripe (u slučaju uspjeha, samo tijek plaćanja://fakture) |
error | string | Poruka o pogrešci (u slučaju greške) |
Primjeri
Jednostavno punjenje
Naplatite 10,00 USD samo određenim iznosom
payment://new?amount=1000Naplata s opisom
Naplatite 25,00 € s opisom
payment://new?amount=2500¤cy=eur&description=Coffee%20and%20pastryNaplata s novim kupcem
Naplatite 50,00 USD i stvorite zapis o kupcu
payment://new?amount=5000&name=John%20Smith&[email protected]Naplati postojećem kupcu
Naplatite 75,00 USD postojećem Stripe korisniku
payment://new?amount=7500&customer=cus_ABC123xyzNaplata s metapodacima
Naplatite 100,00 USD s prilagođenim metapodacima za svoje zapise
payment://new?amount=10000&description=Invoice%20%231234&metadata=%7B%22order_id%22%3A%221234%22%2C%22location%22%3A%22Store%20A%22%7DAutomatska obrada s povratnim pozivom
Preskoči početni zaslon i vrati se u aplikaciju kada završiš
payment://new?amount=3500&autoprocess=true&callback=myapp://payment-completeAutomatski povratak na rezultat
Pokreni povratni poziv čim rezultat postane poznat, umjesto čekanja da trgovac odbaci dijalog s rezultatima
payment://new?amount=3500&autoprocess=true&auto_return=true&callback=myapp://payment-completeFaktura sa stavkama
Izradite račun s proizvodima iz vašeg Stripe kataloga
payment://cart?prices=price_coffee:2,price_muffin:1&[email protected]Plaćanje postojeće fakture (iOS)
Naplati osobno za postojeći Stripe račun. U slučaju uspjeha vraća invoice_id i payment_intent_id.
payment://invoice?id=in_1ABC123xyz&autoprocess=true&callback=myapp://invoice-paidPotpuni primjer
Svi parametri kombinirani za potpuno integrirani protok
payment://new?amount=15000¤cy=usd&description=Service%20Fee&customer=cus_ABC123xyz&metadata=%7B%22invoice%22%3A%22INV-2024-001%22%7D&autoprocess=true&callback=myapp://payment-resultKodiranje URL-ova
Ne zaboravite kodirati posebne znakove za URL u vrijednostima parametara. Razmaci postaju %20, vitičaste zagrade postaju %7B i %7D.
Spremni za integraciju?
Preuzmite aplikaciju i počnite testirati svoju integraciju već danas.