API

Jednoduché a snadno použitelné schéma URL pro integraci vašeho podnikání s Payment for Stripe.

Snadno přesměrujte z libovolné aplikace nebo webu pro iOS přímo do aplikace Platba a nechte si zaplatit.

Vyplňte nový poplatek

Předání dat do služby Payment pro vytvoření poplatků: payment://new?

Přidejte částku v centech: payment://new?amount=2000

Vyberte podporovanou měnu: payment://new?currency=usd

Přidejte popis poplatku zakódovaný do adresy URL: payment://new?description=Cat+Sweater

Vytvořte fakturu s řádkovými položkami

Případně vytvořte řádkovou fakturu Stripe: payment://cart?

Předejte pár ID ceny a množství: payment://cart?line_items=price_xxx:3

Nebo předejte více ID cen a množství: payment://cart?line_items=price_abc:3,price_xyz:2

Navíc můžete uplatnit kupón: payment://cart?coupon=kZjFzekm

Poskytnout informace o zákazníkovi (volitelné)

Přidejte pro zákazníka název zakódovaný v adrese URL: payment://new?name=John+Doe

Zadejte e-mailovou adresu pro potvrzení: payment://new?[email protected]

Zadejte adresu URL zpětného volání

Po úspěšné transakci se aplikace Platba vrátí do vaší aplikace. payment://new?callback=https://foo.bar.com/hook

Kromě toho, že vás systém iOS automaticky vrátí zpět na váš web, vrátíme vám také několik informací, včetně: https://foo.bar.com/hook?success=true&
  amount=2000&currency=usd&
  chargeId=pi_xxxxxx

V případě chyby můžete obdržet zprávu ve formátu: https://foo.bar.com/hook?error[message]=Card+declined

https://foo.bar.com/hook?cancelled=true

Použijte stávajícího zákazníka

Použijte stávajícího zákazníka Stripe předáním jeho ID: payment://new?customer_id=cus_xxxxxx

Tím se předem vybere zákazník pro transakci, takže budou k dispozici jeho uložené platební metody.

Zahrnout vlastní metadata

Předejte vlastní metadata, která se mají zahrnout do poplatku Stripe: payment://new?metadata[order_id]=12345

V případě potřeby přidejte více polí metadat: payment://new?metadata[order_id]=12345&
  metadata[source]=pos

Automatické zpracování plateb

Přeskočte domovskou obrazovku a okamžitě spusťte nabíjení: payment://new?amount=2000&auto=true

Platba začne automaticky po otevření aplikace. Pokud je připojena čtečka karet, aplikace vás k platbě ihned vyzve.

Kompletní příklad

Zde je příklad, který vše spojuje dohromady:

payment://new?amount=2000&
  currency=usd&
  customer_id=cus_xxxxxx&
  metadata[order_id]=12345&
  callback=myapp://payment&
  auto=true

Chcete od API něco víc?
Dej nám vědět