API pro vývojáře
Integrace s schémata URL
Spusťte aplikaci Payment for Stripe z vaší aplikace nebo webových stránek pro zpracování transakcí. Předejte zákaznická data, částky a informace o produktech – po dokončení pak zpracujte zpětné volání.
Jak to funguje
Vaše aplikace otevře platba:// URL s parametry
Platba za Stripe spustí a zpracuje transakci.
Po dokončení aplikace přesměruje na vaši URL adresu zpětného volání s výsledkem.
Koncové body
Vytvořit poplatek
payment://new?Zpracujte jednorázovou platbu s uvedením částky, měny a popisu.
Parametry
| Jméno | Typ | Požadovaný | Popis |
|---|---|---|---|
amount | integer | Ano | Částka v centech (např. 1000 = 10,00 USD) |
currency | string | Žádný | Třípísmenný kód měny ISO (výchozí: USD) |
description | string | Žádný | Popis poplatku kódovaný v URL |
customer | string | Žádný | Stávající ID zákazníka Stripe |
email | string | Žádný | E-mail zákazníka pro potvrzení |
name | string | Žádný | Jméno zákazníka kódované pomocí URL |
metadata | string | Žádný | Vlastní páry klíč-hodnota (JSON s kódováním URL) |
callback | string | Žádný | URL adresa pro návrat po dokončení |
autoprocess | boolean | Žádný | Přeskočit domovskou obrazovku a okamžitě zahájit nabíjení |
auto_return | boolean | Žádný | Spustí zpětné volání při načtení výsledku, místo čekání na zavření dialogového okna s výsledky obchodníkem. Výchozí hodnota je false. |
Vytvořit fakturu
payment://cart?Vytvořte fakturu Stripe s položkami z katalogu produktů.
Parametry
| Jméno | Typ | Požadovaný | Popis |
|---|---|---|---|
prices | string | Ano | Čárkami oddělená ID cen s množstvím (např. price_abc:2,price_xyz:1) |
customer | string | Žádný | Stávající ID zákazníka Stripe |
email | string | Žádný | E-mail zákazníka pro potvrzení |
name | string | Žádný | Jméno zákazníka kódované pomocí URL |
callback | string | Žádný | URL adresa pro návrat po dokončení |
auto_return | boolean | Žádný | Spustí zpětné volání při načtení výsledku, místo čekání na zavření dialogového okna s výsledky obchodníkem. Výchozí hodnota je false. |
Zaplacení existující faktury (pouze pro iOS)
payment://invoice?Osobně si vyzvedněte platbu na základě existující faktury Stripe. Částka, měna, zákazník a daň pocházejí z faktury – přepsání kteréhokoli z těchto údajů je odmítnuto. Obchodník přiloží kartu přes čtečku / platbu dotykem / ruční zadání; v případě úspěchu je faktura označena jako zaplacená mimo pásmo a propojena pomocí metadat charge_id a payment_intent_id. Faktury s předplatným, default_payment_method nebo stavem „neotevřeno“ jsou odmítnuty s chybou, která vyžaduje akci.
Parametry
| Jméno | Typ | Požadovaný | Popis |
|---|---|---|---|
id | string | Ano | ID faktury Stripe (musí začínat na in_) |
callback | string | Žádný | URL adresa pro návrat po dokončení. V případě úspěchu obdrží invoice_id a payment_intent_id. |
metadata | string | Žádný | Vlastní páry klíč-hodnota (JSON s kódováním URL) sloučené do metadat PaymentIntent |
autoprocess | boolean | Žádný | Přeskočit domovskou obrazovku a okamžitě zahájit nabíjení |
auto_return | boolean | Žádný | Spustí zpětné volání při načtení výsledku, místo čekání na zavření dialogového okna s výsledky obchodníkem. Výchozí hodnota je false. |
Zpracování zpětných volání
Po dokončení transakce služba Payment for Stripe přesměruje na vaši URL adresu zpětného volání s parametry dotazu, které udávají výsledek. Ve výchozím nastavení se přesměrování spustí poté, co obchodník zavře dialogové okno s výsledkem, aby mohl provést další akce po platbě (odeslat potvrzení e-mailem, vrátit peníze). Pro spuštění, jakmile je výsledek znám, zadejte parametr auto_return=true. Podporováno pro iOS a Android.
Parametry zpětného volání
| Parametr | Hodnoty | Popis |
|---|---|---|
status | success | error | cancelled | Výsledek transakce |
charge_id | string | ID platby Stripe (v případě úspěchu) |
invoice_id | string | ID faktury Stripe (v případě úspěchu pouze platba://tok faktury) |
payment_intent_id | string | ID záměru platby Stripe (v případě úspěchu pouze tok platby://faktura) |
error | string | Chybová zpráva (při chybě) |
Příklady
Jednoduché nabíjení
Účtujte 10,00 USD pouze určitou částkou
payment://new?amount=1000Poplatek s popisem
Účtujte 25,00 € s popisem
payment://new?amount=2500¤cy=eur&description=Coffee%20and%20pastryÚčtování u nového zákazníka
Účtujte 50,00 USD a vytvořte záznam zákazníka
payment://new?amount=5000&name=John%20Smith&[email protected]Účtovat stávajícímu zákazníkovi
Účtovat 75,00 USD stávajícímu zákazníkovi Stripe
payment://new?amount=7500&customer=cus_ABC123xyzNabíjení pomocí metadat
Účtujte si 100,00 USD za vlastní metadata pro vaše záznamy
payment://new?amount=10000&description=Invoice%20%231234&metadata=%7B%22order_id%22%3A%221234%22%2C%22location%22%3A%22Store%20A%22%7DAutomatické zpracování s voláním
Přeskočit domovskou obrazovku a po dokončení se vrátit do aplikace
payment://new?amount=3500&autoprocess=true&callback=myapp://payment-completeAutomatické vrácení výsledku
Spusťte zpětné volání, jakmile je znám výsledek, namísto čekání, až obchodník zavře dialog s výsledkem.
payment://new?amount=3500&autoprocess=true&auto_return=true&callback=myapp://payment-completeFaktura s položkami
Vytvořte fakturu s produkty z vašeho katalogu Stripe
payment://cart?prices=price_coffee:2,price_muffin:1&[email protected]Zaplatit existující fakturu (iOS)
Osobně vyzvedne platbu za existující fakturu Stripe. V případě úspěchu vrátí invoice_id a payment_intent_id.
payment://invoice?id=in_1ABC123xyz&autoprocess=true&callback=myapp://invoice-paidKompletní příklad
Všechny parametry kombinované pro plně integrovaný tok
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-resultKódování URL
Nezapomeňte v hodnotách parametrů kódovat speciální znaky do URL. Mezery se stanou %20, složené závorky %7B a %7D.
Připraveni k integraci?
Stáhněte si aplikaci a začněte testovat svou integraci ještě dnes.