Metody platební brány

Platební tlačítka

Zrychlené bankovní převody (platební tlačítka) poskytujeme od všech významných bank v Česku, Polsku a na Slovensku. Seznam dostupných metod zjistíte voláním endpointu /methods.

Pokud se platební brána otevře v okně (iframe) přímo na stránce e-shopu a zákazník si zvolí platbu přes tlačítko (například banku nebo jinou službu), bude přesměrován přímo na stránku dané platební instituce. Z bezpečnostních důvodů totiž nelze tyto stránky zobrazit přímo v iframe v rámci e-shopu – vždy dojde k vyskočení a otevření stránky na nejvyšší úrovni.

Platba kartou

Platební brána akceptuje platby kartou VISA, VISA Electron, Mastercard, Maestro. Platby jsou dostupné v měnách CZK, EUR, GBP, USD, PLN, HUF RON, NOK a SEK. Je k dispozici ve všech podporovaných jazycích.

V rámci platby kartou je možné využít mnoho funkcionalit. Mezi ně patří refundace platby, storno nedokončené platby, opakované platby (například pro předplatné s pravidelným strháváním prostředků z karty plátce) nebo předautorizace. Platbu kartou lze také zobrazit přímo v e-shopu (iframe).

Platba QR kódem

Platební brána může zobrazit tři typy QR kódů pro konkrétní plátce. Pro správné zobrazení QR kódu je nutné zakládat platby s odpovídající konfigurací. V případě nesprávné konfigurace platby může mít zákazník potíže se zaplacením prostřednictvím QR kódu. Požadovaná konfigurace plateb pro jednotlivé typy QR kódů je následující:

Typ QR kódu	Konfigurace platby	Poznámka
CZ	měna CZK	QR pro Českou republiku
EUR	měna EUR, všechny země vyjma SK ( i parametr ALL )	QR pro ostatní země
SK	měna EUR, země SK	QR pro Slovenskou republiku

Více informací o konfiguraci platby naleznete v naší API dokumentaci ( parametry: curr a country ).

Výběr platební metody

Doporučujeme v rámci nákupního procesu v e-shopu zobrazit plátci výběr platebních metod a na základě jeho výběru založit platbu s vyplněním parametru "method" na jednu konkrétní hodnotu (např. platba kartou nebo platba převodem apod). Poté dojde k přímému zobrazení stránky poskytovatele konkrétní platební metody.

V případě, že parametr "method" není vyplněn jednou konkrétní hodnotou, dojde k zobrazení nabídky všech platebních metod na platební bráně. Nabídka platebních metod může být specifikována jednoduchým výrazem, který se zadává do parametru "method". Výraz se vždy vyhodnocuje na základě metod, které má e-shop povolené.

Aritmetika metod:

Zobrazené platební metody je možné jednoduchou aritmetikou i dynamicky měnit. Povolené oddělovače identifikátorů metod jsou „+“ pro přičtení metody a „-“ pro odečtení metody z/do výběru.

Příklad:

BANK_ALL + CARD_CZ_COMGATE – BANK_CZ_KB_PSD2 = všechny bankovní metody včetně platby kartou bez bankovního tlačítka Komerční banky.

BANK_CZ_FB_PSD2 + BANK_CZ_KB_PSD2 + BANK_CZ_RB_PSD2 = pouze bankovní tlačítka u Fio banky, Komerční banky a Raiffeisen Bank (pouze tyto 3 na rozdíl od BANK_ALL, který by vybral všechny povolené bankovní metody e-shopu).

Skupiny metod:

V následující tabulce jsou uvedy dostupné skupiny metod, které lze využít k filtrování. Pro získání pro Vás dostupných metod doporučuje využívat endpoint /methods, ve kterém lze filtrovat metody pomocí parametrů.

Název skupiny	popis
ALL	všechny metody
BANK_ALL	všechny bankovní metody (včetně LATER_ALL, LOAN_ALL, PART_ALL )
BANK_ONLY	pouze bankovní tlačítka
CARD_ALL	všechny karetní metody
LATER_ALL	všechny metody odložených plateb
LOAN_ALL	všechny metody plateb na splátky
PART_ALL	všechny metody plateb po částech