Založení a integrace platební brány ThePay ve FAPI
ThePay je česká platební brána, která umožňuje přijímat online platby od zákazníků. Ve FAPI ji můžete propojit se svým účtem a následně používat v prodejních formulářích pro pohodlné online placení, jak platební kartou, tak expresními bankovními převody.
Tento článek pojednává o integraci platební brány ThePay do FAPI. Více informací o platební bráně najdete na webových stránkách provozovatele.
ThePay nepovoluje zpracovávání plateb přes iframe. Proto pokud používáte WIX, vyberte prosím jiného poskytovatele platební brány.
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 (společnosti ThePay.cz s.r.o.), a není tedy součástí ceny za licenci FAPI.
Návod vám pomůže se:
- Založením ThePay účtu
- Napojením ThePay do FAPI
- Aktivací ThePay v prodejním formuláři
1. Založení účtu ThePay
Proces založení účtu ThePay je velmi intuitivní. První registraci vyřídíte online prostřednictvím tohoto jednoduchého registračního formuláře.
Použijte tento náš odkaz pro registraci, bude tak jasné, že ThePay budete používat s FAPI, které je certifikované řešení pro ThePay.
a obdržíte e-mail k ověření.a obdržíte e-mail k ověření.
Ihned po registraci, jste na stránce obeznámeni, že proběhla v pořádku.
Rovněž v zápětí obdržíte e-mail k přihlášení.
Odkaz vás povede na vytvoření hesla.
Následně se ověřuje vaše telefonní číslo.
Tím jste se dostali do prostředí platební brány, kde si můžete svou platební bránu založit.
Zde již přichází na řadu vyplnění všech potřebných náležitostí, aby s vámi ThePay mohli podepsat smlouvu.
Pro úspěšné vytvoření spojení platební brány si připravte občanský průkaz, druhý průkaz totožnosti a výpis z bankovního účtu.
Online registrace se skládá z následujících kroků:
- načtení a kontrola údajů na základě zadaného IČ,
- zadání údajů o zástupci a majiteli firmy,
- zadání adresy vašich prodejních stránek/e-shopu,
- zobrazení cenové nabídky,
- konfigurace služeb,
- zobrazení a potvrzení obchodních podmínek,
- ověření totožnosti (zadání 3 dokumentů),
- zaslání autorizační platby,
- zpracování registrace,
- dokončení registrace (po přijetí schvalovacího e-mailu),
- závěrečná rekapitulace a ověření smlouvy,
- zaslání e-mailu a SMS s přihlašovacími údaji.
Přístupové údaje, které obdržíte od ThePay, využijete pro nastavení propojení s FAPI (popsáno dále).
Platby online bankovním převodem, tzv. expresní platby můžete využívat ihned po založení účtu. Povolení pro platby kartou nicméně podléhá schvalovacímu procesu, který obvykle trvá 5 až 15 dní.
2. Vytvoření propojení s ThePay ve FAPI
Ve FAPI v nabídce Nastavení -> Propojení aplikací stiskněte tlačítko Nové propojení s ThePay.
Na následující stránce vyplňte údaje nezbytné pro vytvoření propojení se službou ThePay.
Do zobrazeného formuláře vyplňte všechny potřebné údaje:
- doména - webová doména, na které budete platební bránu ThePay používat (ve tvaru fapi.cz)
- Verzi API - zvolte Nová platební brána
- režim - pro "ostrý" provoz zvolte produkční režim, režim testovací je pouze pro testovací platby
- MERCHANT ID -
- PROJECT ID -
- HESLO -
Přístupové údaje pro Starou a Novou platební bránu jsou rozdílné!
Chcete-li používat platební bránu v testovacím režimu, přepněte volbu režim na hodnotu testovací režim. Platební brána v testovacím režimu pracuje s fiktivními platbami, k reálným finančním tokům zde tedy nedochází. Využijete ji při testování svého prodejního procesu.
Přístupové údaje najdete ve svém účtu ThePay v sekci Implementace.
Vyplněné hodnoty uložte stiskem tlačítka Uložit.
Dále je potřeba v platební bráně ThePay nastavit IP adresy, ze kterých se budou požadavky na vytvoření platby akceptovat. Špatně vyplněné IP adresy mohou zapříčinit nefunkčnost propojení mezi FAPI a platební branou ThePay.
Pro správnou funkčnost platební brány je potřeba mít u propojení obchodu v účtu platební brány ThePay (nabídka Integrace) povoleny tyto IP adresy:
83.167.243.140
178.238.37.32
18.158.192.220
Pokud nejsou vyplněny správné údaje, nemusí platební brána ThePay fungovat správně.
Automatické strhávání z karty - při přechodu ze Staré na Novou platební bránu
Pokud používáte automatické strhávání z karty, budou se vám nové platby ke strhnutí nadále vytvářet pod původní platební branou. Aby se začala používat nová platební brána, je potřeba, aby klient znovu provedl platbu kartou u šablony pravidelných faktur. K tomu je potřeba u šablony pravidelných faktur zrušit automatické strhávání z karty.
Celý postup najdete zde, Jak na změnu platební brány.
3. Nastavení platební brány ThePay 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 ThePay 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 ThePay.
Změny provedené v nastavení prodejního formuláře uložte tlačítkem Uložit formulář.
Pokud jste úspěšně došli až sem, gratulujeme! Váš prodejní formulář je nyní propojen s platební bránou ThePay a vaši zákazníci vám mohou začít platit online.
Mnoho užitečných návodů o ThePay najdete pod tímto odkazem, mimo to ThePay má českou podporu: