Integrace platební brány: co to skutečně obnáší
Integrovat platební bránu není technicky obtížné — moderní poskytovatelé mají dobrou dokumentaci a funkční příklady. Obtížné je všechno mimo šťastnou cestu: neúspěšné platby, vratky, zpětné zúčtování, duplicitní objednávky a to, co se stane, když zákazník zavře panel uprostřed placení.
Tento průvodce prochází samotnou integraci a podrobněji hraniční případy, kde se skutečně ztrácejí peníze.
Vyberte metody, které váš trh používá#
Platební preference jsou silně regionální. Nabídnout špatné metody znamená ztratit prodej v košíku, což je nejdražší místo, kde někoho ztratit.
| Metoda | Kde záleží | Na co dát pozor |
|---|---|---|
| Platební karta | Nezbytná téměř všude | Vyšší náklad, riziko zpětného zúčtování |
| Rychlý bankovní převod | Velmi rozšířený v Česku | Okamžité potvrzení, nízké riziko |
| Dobírka | Stále žádaná v Česku | Vyšší míra nepřevzetí, náklady na vrácení |
| Apple Pay a Google Pay | Mobilně, znatelně zvyšuje konverzi | Vyžaduje HTTPS a ověření domény |
| Odložená platba | Roste v řadě segmentů | Riziko nese poskytovatel, za procento |
| PayPal | Mezinárodně, známá značka | Vyšší náklad, vlastní proces sporů |
| Bankovní převod | B2B a vysoké částky | Pomalé potvrzení; objednávky čekají |
Začněte se dvěma až třemi metodami, které váš trh skutečně používá. Každá další je jedna volba navíc v košíku a, jemněji, další cesta k testování po každé aktualizaci.
Jak integrace funguje#
Tvar je prakticky stejný u všech moderních poskytovatelů a stojí za pochopení, protože z něj plynou způsoby selhání.
- Váš server vytvoří platební záměr s částkou, měnou a odkazem na objednávku.
- Zákazník je odeslán na platební stránku poskytovatele, nebo vyplní vložený formulář.
- Zákazník potvrdí u své banky nebo vydavatele karty, často se silným ověřením.
- Poskytovatel vrátí zákazníka na vaši návratovou adresu — kterou nikdy nesmíte brát jako důkaz platby.
- Poskytovatel odešle webhook na váš server s konečným stavem. Tohle je pravda.
- Váš server ověří podpis webhooku, aktualizuje objednávku a odešle potvrzení.
- Údaje z karty se nikdy nedotknou vašeho serveru — což vás drží mimo nejtěžší část PCI.
Kroky čtyři a pět soustřeďují nejvíc chyb. Zákazník může zavřít prohlížeč dřív, než se vrátí; webhook přijde tak jako tak. Stavte na webhooku, ne na návratu.
Hraniční případy, kde mizí peníze#
Neobjeví se při testech a objeví se v prvním opravdu rušném týdnu.
| Situace | Co se pokazí | Zpracování |
|---|---|---|
| Webhook přijde dvakrát | Objednávka zpracována dvojmo | Idempotence: zpracovat každou událost jednou |
| Webhook před návratem | Souběh přepíše stav objednávky | Explicitní přechody stavů, nikdy zpět |
| Zákazník zavře panel po platbě | Zaplaceno, žádná objednávka | Vytvořit objednávku na webhooku, ne na návratu |
| Platba selže po rezervaci skladu | Sklad blokován bez prodeje | Nechat rezervaci vypršet po pevném okně |
| Částečná vratka | Účetnictví přestane sedět | Modelovat vratky jako prvotřídní událost |
| Zpětné zúčtování | Peníze pryč, zboží odesláno | Uchovávat důkazy; riziková pravidla u vysokých částek |
| Poskytovatel je mimo provoz | Nulové tržby, ne menší tržby | Druhá metoda jako záloha |
Soulad a testování#
Krátký seznam pokrývající to, co se prodraží, když chybí.
- Použijte hostovaná pole nebo přesměrování, aby se údaje z karty nikdy nedotkly vašeho serveru — výrazně to zmenší rozsah PCI.
- Silné ověření zákazníka je v Evropě povinné; otestujte cestu kartou, která ho vynutí.
- Ověřujte podpis každého webhooku. Neověřený webhook je veřejný koncový bod schopný označit objednávky jako zaplacené.
- Zobrazujte spotřebitelům ceny s DPH a zpřístupněte cenu dopravy před posledním krokem.
- Uchovávejte data objednávek a plateb po zákonnou dobu a osobní údaje ne déle, než je nutné.
- Otestujte vratky a částečné vratky před spuštěním, ne až o ně požádá první zákazník.
- Proveďte skutečnou transakci v produkci skutečnou kartou a vraťte si ji. Testovací režim nepokryje všechno.
Časté dotazy
Kterou platební bránu vybrat?
Vybírejte podle metod, které podporuje na vašem trhu, podle poplatků při vašem obratu a podle toho, jak dobře se integruje s vaší platformou. Pro český e-shop je prvním filtrem podpora karet a rychlého bankovního převodu. Cenové rozdíly mezi velkými poskytovateli jsou při skromném obratu dost malé, aby nebyly rozhodující.
Potřebuji soulad s PCI?
Ano, ale rozsah zcela závisí na způsobu integrace. Pokud používáte hostovaná platební pole nebo přesměrování tak, že se údaje z karty nikdy nedotknou vašeho serveru, vaše povinnost klesne na nejjednodušší sebehodnocení. Pokud údaje z karty zpracováváte sami, jste v úplně jiném režimu — téměř žádný e-shop by to dělat neměl.
Proč potřebuji webhooky, když existuje návratová adresa?
Protože návrat závisí na prohlížeči zákazníka. Když zavře panel, ztratí spojení, nebo uvízne na stránce banky, návrat nikdy nepřijde — ale peníze byly stržené. Webhook přichází ze serveru poskytovatele a dorazí tak jako tak. Stavte objednávku na webhooku a návrat používejte jen k zobrazení něčeho zákazníkovi.
Jak se vyhnout duplicitním objednávkám?
Udělejte zpracování webhooků idempotentní: ukládejte identifikátor každé zpracované události a opakování ignorujte. Poskytovatelé webhooky opakují, když nedostanou potvrzení, takže duplicitní doručení je normální chování, ne porucha. Bez této kontroly pošlete dva potvrzovací e-maily a dvakrát odečtete sklad.
integrace platební brányplatby v e-shopuplatební bránawebhook platbysoulad pcionline platby
