Pomocí opakovaných plateb je možné periodicky nebo na vyžádání strhávat finanční prostředky z karty zákazníka poté, co zákazník autorizoval počáteční platbu. Opakované platby se hodí např. pro různé předplatné nebo služby s měsíčními poplatky.
Platební brána umožňuje provedení dvou typů opakovaných plateb.
automatické opakované platby - s počáteční platbou se nastaví perioda opakování a částka a platby již dále probíhají automaticky
opakované platby na vyžádání - každou následnou platbu je potřeba strhávat požadavkem na REST API ze strany obchodníka, výhodou je možnost řídit si částku a čas stržení dalších plateb
💡 Tip GoPay:
Funkce opakovaných plateb je standardně dostupná na testovacím prostředí platební brány. V případě, že chcete opakované platby aktivovat pro vaše prodejní místo na provozním prostředí, kontaktujte prosím podporu GoPay na podpora@gopay.cz.
Automatické opakované platby
Automatická opakovaná platba je založena požadavkem na REST API ze strany portálu obchodníka.
Nastavení opakované platby určuje objekt recurrence, jehož parametry jsou:
recurrence_cycle - definuje cyklus opakované platby a může nabývat hodnot
DAY,WEEK,MONTHrecurrence_period - definuje periodu opakovaní v daném cyklu
například pokud bude recurrence_cycle nastaven na hodnotu
DAYa recurrence_period na 3, bude opakovaná platba provedena každý 3. den
recurrence_date_to - definuje platnost opakované platby
do tohoto data ji bude systém platební brány automaticky strhávat
musí obsahovat hodnotu datumu vetší než je aktuální datum a menší než 2099-12-31
💡 Tip GoPay:
Založení opakované platby je nutné autorizovat pomocí tokenu. Více informací o procesu získání tokenu zjistíte v článku popisujícím postup integrace platební brány.
Využití plateb
Automatické opakované platby se hodí pro služby s pravidelnou platbou ve stejné výši, např. předplatné časopisu, jehož cena se nemění.
Opakované platby na vyžádání
Opakovaná platba na vyžádání je zakládána stejným požadavkem na REST API, jako platba automatická, ale liší se v nastavení parametru recurrence_cycle.
U platby na vyžádání recurrence_cycle nabývá pouze hodnoty ON_DEMAND. Naopak recurrence_period se v tomto případě nepoužije.
Strhávání následných plateb je prováděno prostřednictvím požadavku na API, který umožní u následné platby specifikovat:
vlastní částku
amountčíslo objednávky
order_numberpopis objednávky
order_descriptionpoložky nákupu (items)
dodatečné volitelné parametry platby (additional_params)
Jako odpověď na vytvoření následné platby je vrácen objekt popisující stav a parametry nově vzniklé následné platby.
💡 Tip GoPay:
V případě neúspěšné platby doporučujeme provést alespoň 3 pokusy o stržení. Pokud žádný z pokusů nebude úspěšný, opakování může být zrušeno.
Využití plateb
Opakované platby na vyžádání se hodí pro služby s nepravidelnou platbou nebo platbou podle čerpání služby.
Uhrazení platby
Odpovědí na založení opakované platby je objekt popisující stav nově vzniklé platby, jehož součástí je i parametr gw_url, kterou použijete pro vyvolání platební brány ve formě inline nebo redirect.
Je nutné, aby zákazník uhradil tuto nově vzniklou zakládající opakovanou platbu, čímž autorizuje provádění dalších následných automatických opakovaných plateb.
Notifikace
Následné platby jsou notifikovány pomocí standardních http notifikací, viz sekce notifikace v článku popisujícím postup integrace platební brány.
Notifikace následné platby navíc obsahuje GET parametr parent_id, který obsahuje id zakládající platby.
💡 Tip GoPay:
HTTP notifikace lze odesílat i v případě, že zákazník zruší opakování platby. Pokud chcete být o této akci zákazníka informováni, kontaktujte prosím technické oddělení GoPay na integrace@gopay.cz.