Návod krok za krokem · díl 10

Platba kartou

Váš obchod z dílu 9 umí převod, dobírku a hotovost. Teď přidáme kartu. Zákazník po odeslání objednávky klikne na „Zaplatit kartou“ a vám se objednávka sama označí jako zaplacená.

Kód je v obchodě už hotový. Potřebujete jen účet u platební brány a klíče od ní. Ukážeme dvě cesty: Stripe (rychle) a Fio banku (levněji, se smlouvou).

Stripe asi hodina · Fio dva týdny čekání na banku · Bez programování

Rolujte dolů

Okno 1 · Výběr

Stripe, nebo banka?

Stripe

Účet si založíte sami za jeden večer. Poplatek 1,5 % + 6,50 Kč za evropskou kartu, bez měsíčních plateb. Peníze posílá na váš účet, první výplata ale až po 7–14 dnech.

Fio banka (GP webpay)

Poplatek 0,59 % do obratu milion měsíčně (akční ceník Fio do konce roku 2026). Potřebujete podnikatelský účet u Fio a smlouvu na pobočce. U nás to v bance trvalo 12 dní.

Začátek: Stripe. Když se obchod rozjede a karty budou chodit často, vyplatí se přejít na banku. V obchodě se to přepne jedním nastavením.

Okno 1 · Výběr

Brána se podívá na váš web.

Než vám brána dovolí brát peníze, zkontroluje, že na webu je kontakt, obchodní podmínky a pravidla vracení. Obchod z dílu 9 to všechno má, jen tam musí být vaše skutečné jméno, adresa a e-mail. Web musí jít otevřít bez hesla.

Zkontrolujte ve správě obchodu Nastavení → Kdo prodává, že tam nic nechybí. Kontrola ve správě (Pomoc) vás na prázdnou adresu nebo IČO upozorní.

Okno 2 · Stripe

Účet zakládáte vy.

Na dashboard.stripe.com/register vyplníte e-mail, jméno, heslo a zemi. Stripe pak pošle ověřovací mail. Pro ostré platby bude chtít ještě adresu, telefon, bankovní účet, adresu webu a popis toho, co prodáváte. Tohle Claude neudělá za vás: je to smlouva mezi vámi a Stripe, s vaším heslem a osobními údaji.

Kudy dál v nástěnce Stripe, vám ukáže vaše AI: řekněte jí, co právě vidíte na obrazovce, a zeptejte se, kam kliknout.

Stripe může fungovat i pro fyzickou osobu. Kdo ale prodává pravidelně, potřebuje živnost. To je otázka zákona, ne Stripe.

Prohlížeč

Registrační formulář Stripe: e-mail, jméno, heslo, země

Registrace u Stripe. Heslo si vymyslete a nikomu ho nedávejte.

Okno 2 · Stripe

Nejdřív nanečisto.

Stripe má testovací režim, ve kterém se peníze nepohnou. V nástěnce Stripe najděte Developers → API keys se zapnutým testovacím režimem a zkopírujte tajný klíč. Začíná sk_test_.

Vložte ho do souboru pristupy.txt ve složce obchodu, ne do chatu. Políčko „Stripe — tajný klíč“ je v něm připravené. Pak Claudovi řekněte:

Zapni v obchodě platbu kartou přes Stripe podle dílu 10.
Klíč je v pristupy.txt. Nejdřív v testovacím režimu.

Okno 2 · Stripe

Zaplaťte kartou, která neexistuje.

Udělejte si v obchodě objednávku a zvolte platbu kartou. Na platební stránce Stripe zadejte testovací kartu:

Číslo 4242 4242 4242 4242

Platnost jakékoli datum v budoucnosti

CVC jakákoli tři čísla

Po zaplacení se vrátíte do obchodu a objednávka musí být zaplacená. Ověřte to ve správě, ne jen na stránce s poděkováním. Přijde vám i mail „Zaplaceno kartou“.

Poctivě: u Stripe jsme v obchodě ověřili kontrolu podpisu zpráv od Stripe a to, že s neplatným klíčem obchod nic nezaplatí a řekne to. Celou platbu kartou jsme na vlastním účtu Stripe zatím nezkoušeli. Tahle zkušební platba na vašem testovacím účtu je proto kontrola, která rozhoduje. Když neprojde, ve správě klikněte na Pomoc → Napsat podpoře.

Prohlížeč

Stránka objednávky s tlačítkem Zaplatit kartou

Tlačítko pošle zákazníka na platební stránku. Údaje o kartě obchod nevidí.

Okno 2 · Stripe

Ostrý klíč a malá platba.

Až Stripe účet schválí, zkopírujte stejným postupem ostrý tajný klíč (sk_live_) a vyměňte ho v pristupy.txt. Claude ho dá do obchodu.

Pak zaplaťte skutečnou kartou nejmenší objednávku. To je jediný důkaz, že to jede naostro. Platbu pak můžete v nástěnce Stripe vrátit.

Ostrý klíč je jako PIN k vašim tržbám. Kdo ho má, může jménem obchodu vracet peníze. Nikam ho neposílejte.

Okno 3 · Fio banka

Žádost a smlouva.

Na fio.cz v části Platební karty → Platební terminály a platební brána vyplníte formulář pro nového klienta. Pak podepíšete smlouvu na pobočce a založíte si podnikatelský účet u Fio, pokud ho nemáte. To všechno děláte vy, banka chce majitele.

Od banky (přesněji od firmy GPE, která bránu provozuje) přijde číslo e-shopu a přístup do testovacího portálu. U nás to od žádosti trvalo 12 dní.

Okno 3 · Fio banka

Dva klíče, které se pletou.

Váš klíč V portálu ho vytvoříte a stáhnete i s heslem. Znovu stáhnout nejde, uložte si soubor i heslo.

Vložit V portálu potvrdíte „Vložit klíče“. Ověřovací kód přijde na váš e-mail, takže tenhle krok je váš.

Klíč banky V portálu v Ke stažení je veřejný klíč GPE. Testovací a ostrý jsou dva různé soubory.

Soubory dejte do složky obchodu. Do pristupy.txt zapište číslo e-shopu od banky a heslo ke klíči, políčka na ně tam jsou. Pak Claudovi řekněte, ať zapne platbu přes GP webpay podle dílu 10. Klíče nahraje do zamčené části obchodu, kam se z prohlížeče nedostane nikdo.

Okno 3 · Fio banka

Test, mail, ostrý provoz.

Test Karta 4056 0700 0000 0008, platnost 12/2028, CVC 481. Objednávka aspoň za 10 Kč.

Hotovo? Objednávka je ve správě zaplacená, ne jen „vrátila se stránka“.

Mail Napíšete na gpwebpay@gpe.cz, že je test hotový. Pošlou postup do ostrého provozu.

Ostře V ostrém portálu se klíče vytvářejí a vkládají znovu. Stáhněte i ostrý klíč banky.

Důkaz Skutečná platba skutečnou kartou na malou částku.

Okno 4 · Provoz

Zaplaceno se zapíše samo.

Po zaplacení kartou se objednávka sama označí jako zaplacená a vám přijde mail. Obchod to ale zapíše, až když platbu ověří u brány. To, že se zákazník vrátil na stránku, nestačí. Údaje o kartě obchod nikdy nevidí, zadávají se rovnou u brány.

Ve správě v Nastavení → Platba vidíte, jestli je brána nastavená a jestli běží v testovacím, nebo v ostrém režimu.

Správa obchodu

Nastavení platby kartou ve správě obchodu

Brána v testovacím režimu. Peníze se nepohnou, dokud ji nepřepnete na ostrý klíč.

Srovnání na jednom místě

	Stripe	Fio banka (GP webpay)
Kdo může	I fyzická osoba (prodej pravidelně = živnost)	Podnikatel s účtem u Fio
Poplatek	1,5 % + 6,50 Kč (evropská karta)	0,59 % do obratu 1 mil. Kč měsíčně, akce do 31. 12. 2026
Měsíční platba	žádná	samostatný měsíční poplatek ceník Fio neuvádí
Nejmenší platba	15 Kč	10 Kč
Jak dlouho	účet za večer, první výplata po 7–14 dnech	u nás 12 dní v bance + den práce
Co vkládáte	jeden tajný klíč	číslo e-shopu, váš klíč s heslem, klíč banky
Testovací karta	`4242 4242 4242 4242`	`4056 0700 0000 0008`, 12/2028, CVC 481

Když něco nefunguje

„Platba kartou teď nejde (brána není nastavená)“	Chybí klíč. Ve správě Nastavení → Platba je napsáno, co přesně.
Zaplaceno, ale objednávka ne	Zákazník zavřel prohlížeč dřív, než se vrátil. Podívejte se do nástěnky brány a objednávku ve správě označte jako zaplacenou ručně. U Stripe tomu předejde webhook: řekněte Claudovi „nastav webhook Stripe podle CLAUDE.md“.
Banka vrací kód 31	Klíč v portálu není vložený, nebo jde o klíč z jiného prostředí (test × ostrý).
Banka vrací kód 14	Opakovaný pokus se stejným číslem. Obchod posílá pokaždé nové, takže to znamená starou verzi obchodu. Aktualizujte.
Stripe nechce účet schválit	Na webu chybí jméno, adresa nebo obchodní podmínky. Viz krok 2.

Bezpečně

Tajný klíč brány je jako PIN k tržbám. Patří do pristupy.txt u vás a do zamčené části obchodu. Do mailu, chatu ani na papír na monitor ne.

Testovací a ostrý režim mají jiné klíče. Obchod vám ve správě vždycky ukáže, který právě běží.

Nerozumíte něčemu? Zeptejte se svojí AI

Čtu 10. díl návodu na aitop.cz — „Platba kartou“. Nerozumím tomu, jak …
Vysvětli mi to jednoduše a zeptej se mě, co přesně mi nejde.

A u poplatků a podmínek platí: číslo si ověřte přímo u Stripe nebo u banky. Ceníky se mění.