Předautorizované platby umožňují vytvoření blokace (předautorizace) finančních prostředků na kartě zákazníka namísto stržení.
Vytvořenou blokaci držíme po dobu 4 dnů. Během této doby můžete platbu buď strhnout nebo uvolnit.
Předautorizované platby se hodí například pro platby za zboží, u kterého v době nákupu není jisté, zda bude dostupné.
💡 Tip GoPay:
Funkce předautorizovaných plateb je standardně dostupná na testovacím prostředí platební brány. V případě, že chcete předautorizované platby aktivovat pro vaše prodejní místo na provozním prostředí, kontaktujte prosím technickou podporu GoPay na integrace@gopay.cz.
Založení předautorizované platby
Předautorizovaná platba je založena požadavkem na REST API, kdy je parametr preauthorization nastaven na hodnotu true.
Po založení platby je vrácen objekt popisující její stav a parametry.
Součástí odpovědi je i parametr gw_url, který využijete pro vyvolání platební brány, buď ve formátu inline nebo redirect.
Poté, co zákazník předautorizovanou platbu uhradí, platba přechází do stavu AUTHORIZED.
O změně stavu platby informujeme prodejní místo prostřednictvím automatické HTTP notifikace na notifikační URL adresu, kterou jste předali při založení platby.
Více informací o notifikacích naleznete v článku postup integrace platební brány.
Stržení předautorizované platby
Plné stržení předautorizované platby se provádí požadavkem na API, který strhne blokaci z účtu zákazníka a finanční prostředky připíše na GoPay obchodní účet obchodníka.
Platbu je možné strhnout v plné výši nebo pouze částečně prostřednictvím požadavku částečného stržení předautorizované platby.
V případě částečného stržení předautorizované částky dochází k aktualizaci údajů původní platby dle nového volání. Zbylá částka je zákazníkovi automaticky odblokována.
Platba přechází do stavu PAID. O změně stavu informujeme prostřednictvím HTTP notifkace.
Upozorňujeme, že možnost částečného stržení předautorizované platby nemusí být v některých případech pro dané prodejní místo dostupná, a to s ohledem na technické možnosti partnera zajišťujícího platby kartou. Děkujeme za pochopení.
Zrušení předautorizované platby
Při nedostupnosti zboží nebo nemožnosti poskytnutí služby zákazníkovi je nutné provést zrušení předautorizované platby prostřednictvím požadavku na API.
Blokace finančních prostředků na účtu zákazníka je následně uvolněna a platba přechází do stavu CANCELED.
O změně stavu informujeme prostřednictvím HTTP notifikace.