Stripe API je technické rozhraní pro integraci plateb na vlastní web nebo aplikaci. Z mé praxe: nejvíc se využívá u projektů cílících na západní trhy - Německo, Rakousko, USA. Stripe je obrovská globální platforma a její API je dnes dobře připravené pro rychlou implementaci, většinou bez průtahů a s dostupnými platebními metodami pro EU i mimo ni. Než se ale rozhodnete, je třeba zvážit poplatky.
Pro obecný úvod, srovnání s českými platebními bránami a aktuální podmínky viz heslo Stripe. Tento článek se zaměřuje na technickou integraci přes API a praktické aspekty Implementace.
Pro koho dává Stripe API smysl
Stripe API se vyplatí, pokud projekt:
- cílí na zahraniční trhy (DACH region, západní Evropa, USA)
- nabízí předplatné, opakované platby nebo marketplace model
- potřebuje rychlou implementaci bez dlouhého schvalování
- pracuje s digitálními produkty nebo SaaS
- požaduje API-first přístup (rychlé Iterace, vlastní checkout)
Pro čistě český e-shop s českou cílovkou často vyjdou levněji domácí brány (Comgate, GoPay) a integrace přes API Comgate bývá pro lokální trh praktičtější.
Poplatky - co spočítat předem
Stripe účtuje za každou transakci procento z částky plus fixní poplatek. Pro karty z EHP zhruba 1,5 % + 6,50 Kč, pro karty mimo EHP vyšší sazba plus měnové konverze a další příplatky za FX. Pro vysoké průměrné objednávky (1 000+ Kč) to vychází podobně jako Comgate. Pro nízké hodnoty (pod 500 Kč) je Stripe relativně dražší kvůli fixní složce.
Před rozhodnutím doporučuji spočítat reálnou efektivní sazbu na vzorku 100 typických objednávek. Často to dopadne jinak, než člověk čeká.
Registrace do Stripe
Založení účtu je plně online a poměrně rychlé. Během registrace je potřeba:
- mít aktivní bankovní účet vedený na podnikatele nebo firmu
- ověřit identitu a základní podnikatelské údaje
- doplnit informace o webu a nabízených produktech nebo službách
Po schválení získáte přístup do administrace a API klíčů (publishable + secret), které slouží k napojení platební brány na váš web nebo aplikaci.
Implementace Stripe API na web
Propojení vyžaduje technickou přípravu. V rámci tvorby webu nebo technických úprav připravím:
- napojení platebního procesu přes Stripe Checkout nebo vlastní Elements
- nastavení webhooks pro reliable potvrzování plateb (orders, refunds, disputes)
- signing secret a IP whitelist pro bezpečnost
- testovací prostředí (test mode) a ověření funkčnosti
- napojení na účetnictví (Fakturoid, iDoklad) pro automatické fakturování
- opakované platby pro subscription model
U projektů s opakovanými platbami nebo marketplace modelem je důležité správně nastavit webhook handling a idempotenci, jinak hrozí duplicitní zaúčtování. To je oblast, kde se hodně projektů nakažuje.
Co Stripe API podporuje
- karty (Visa, Mastercard, Amex)
- Apple Pay, Google Pay
- SEPA inkaso a bankovní převody
- okamžité převody (instant payouts)
- BNPL (Klarna, Afterpay)
- 3D Secure 2 (SCA compliance pro EU)
- opakované platby (subscriptions, invoicing)
- marketplace modely (Connect)
Pokud potřebujete poradit s integrací Stripe API nebo zvážit, jestli je pro váš projekt lepší Stripe nebo česká platební brána, napište mi. Projdeme váš model a poradím konkrétně podle čísel.
Pavel Szabo
Programátor webů, eshopů a informačních systémů s více než 23 lety praxe. Pomáhám firmám i jednotlivcům s online podnikáním, automatizacemi a využitím AI v praxi.