Založení a integrace platební brány Stripe ve FAPI

Služba Stripe je jedním z nejrozšířenějších řešení pro přijímání online plateb. Na rozdíl od ostatních platebních bran, které je možné s FAPI propojit, má Stripe celosvětovou působnost. Pokud působíte na globálním trhu, je to ten pravý nástroj pro vás.

Tento článek vás provede integrací platební brány Stripe do FAPI.

Platební brána není součástí FAPI. Pokud nechcete poskytovat svým zákazníkům možnost platit online, nemusíte ji do FAPI integrovat. Poplatek za používání platební brány je hrazen přímo jejímu provozovateli, a není tedy součástí ceny za licenci FAPI.

Návod vám pomůže se:

Založením Stripe účtu
Napojením Stripe do FAPI
Aktivací Stripe v prodejním formuláři

1. Založení účtu Stripe

Účet Stripe si založíte na registrační stránce služby. Stačí vyplnit pouze e-mailovou adresu, jméno a příjmení, zvolit si heslo a Stát, pro přihlášení do účtu.

Jelikož je Stripe americký, jejich komunikace i stránky jsou výhradně v anglickém jazyce.

Následně vás to vyzve k vyplnění další údajů na několika kartách, které můžete přeskočit a vyplnit je později.

Minimální výše platby, kterou platební brána Stripe dokáže zpracovat je 15 Kč, resp. 0,5 EUR.

Důležité doporučení

Při komunikaci se Stripe uveďte, že budete bránu používat s FAPI. jako certifikovaným dodavatelem a ověřeným řešením, může to urychlit ověřování nebo řešení technických dotazů.

Účet Stripe je ve výchozím stavu v testovacím režimu, tzv. Sandbox. Testovací propojení můžete v budoucnu využít pro testování online plateb.

Pro přechod do ostrého režimu (live account) je potřeba provést ještě několik dalších úkonů:

1. ověřit e-mailovou adresu - pokyn vám přijde ihned do vašeho emailu,

doplnit fakturační údaje atd. - více informací najdete přímo ve svém účtu Stripe.

Pro produkční režim (live account) doporučujeme na straně FAPI vytvořit nové propojení s použitím produkčních (live) API klíčů.

2. Vytvoření propojení se Stripe ve FAPI

Ve FAPI v nabídce Nastavení - Propojení aplikací stiskněte tlačítko Nové propojení se Stripe.

Na následující stránce vyplňte údaje nezbytné pro vytvoření propojení se službou Stripe.

DOMÉNA - webová doména, na které budete platební bránu Stripe používat (jde pouze o interní pojmenování propojení ve FAPI),
PUBLISHABLE KEY - veřejný klíč z účtu Stripe,
SECRET KEY - tajný klíč z účtu Stripe.

Zadané údaje ve FAPI uložte stiskem tlačítka Uložit.

Při uložení se na pozadí automaticky vytvoří a na obou stranách uloží i tzv. webhook, který slouží pro správné zpracování platby. Pomocí webhooku předává Stripe do FAPI informaci o změně stavu platby.

Kde klíče najdete ve Stripe?

Veřejný (publishable) i tajný (secret) klíč najdete ve svém účtu Stripe v nabídce Developers - API keys - sekce Standard keys.

Pro zobrazení tajného klíče je potřeba kliknout na tlačítko Reveal key token, resp. Reveal test key token.

Stripe má oddělený testovací a produkční režim a každý z nich používá vlastní API klíče. Pokud tedy do FAPI omylem vložíte testovací klíče místo produkčních, propojení nebude fungovat a FAPI může hlásit chybu v přístupu a že přihlašovací údaje nejsou správné.

3. Nastavení platební brány Stripe v prodejním formuláři

Nakonec už jen zbývá propojenou platební bránu přidat do prodejního formuláře, v němž si přejete platební bránu využívat.

V nabídce Prodej -> Prodejní formuláře, vyberte formulář, u kterého chcete nabídnout online platby zprostředkované pomocí platební brány Stripe a stiskněte tlačítko Upravit prodejní formulář.

Na záložce 3. Platba, doprava a fakturace v úpravě prodejního formuláře vyberte v sekci Platební brána příslušné propojení s platební bránou Stripe.

Změny provedené v nastavení prodejního formuláře uložte tlačítkem Uložit formulář.

Nejde vám STRIPE napojit a chyba jsou neplatné přihlašovací údaje?

Pokud máte svou platební bránu Stripe připojenou ještě někde jinde, kromě FAPI, pak si pro ně potřebujete vygenerovat unikát Secret Key pro připojení.

Tento screen vás navede, jak na to.

Dostupné platební metody u Stripe

Přes Stripe lze používat i PayPal obchodní účet, pokud jej do Stripe připojíte. PayPal se pak ve FAPI zobrazí jako nový možný způsob platby.

POZOR!!!

Platební brána STRIPE je jediná, která platební metody Google a Apple Pay nabízí přímo v platbě kartou. Jelikož z jejich pohledu jde o platbu kartou. Tedy se vám v prodejních formulářích nebudou nabízet jako samotný způsob platby. Ale zobrazí se vždy až při platbě kartou.

Platební údaje v prodejním formuláři

Při napojení na platební bránu Stripe je možné volitelně zobrazit pole pro zadání platebních údajů z karty přímo v prodejním formuláři. Klient tak není při platbě přesměrován na platební bránu, což zjednodušuje a zkracuje celý proces nákupu.

Zobrazení platebních údajů v prodejním formuláři aktivujete pomocí volby Umožnit zadat kartu v prodejním formuláři na záložce 3. Platba, doprava a fakturace (volba je viditelná pouze při aktivním propojení s platební bránou Stripe).

Více máme v této FAPI nápovědě: https://napoveda.fapi.cz/article/282-zadani-udaju-z-karty-primo-v-prodejnim-formulari

Ještě pár tipů:

Pokud chcete aktivovat Apple Pay pro Stripe:

https://napoveda.fapi.cz/article/294-jak-aktivovat-apple-pay-v-platebni-brane-stripe

Pokud chcete vystavit fakturu až po platbě ve Stripe:

https://napoveda.fapi.cz/article/227-vystaveni-faktury-z-platby-ve-stripe

Pokud jste úspěšně došli až sem, gratulujeme! Váš prodejní formulář je nyní propojen s platební bránou Stripe a vaši zákazníci vám mohou začít platit online.