Přijímání plateb přes Global Payments
Global Payments je mezinárodní poskytovatel plateb, kompatibilní s Desjardins (Québec). Vaši uživatelé platí platební kartou na zabezpečené platební stránce Global Payments, která zajišťuje také ověření 3-D Secure. Poplatky se řídí vaší smlouvou s Global Payments. OpenResa si z těchto plateb nestrhává žádnou provizi.
Požadavky
Aby vaše organizace mohla přijímat skutečné platby, musí mít obchodní účet Global Payments, například prostřednictvím Desjardins v Québecu. Váš správce účtu vám pak předá dva identifikátory určené pro vaši aplikaci: App ID a App Key.
Pokud si chcete bránu vyzkoušet před podpisem smlouvy, vytvořte si zdarma účet na vývojářském portálu Global Payments (developer.globalpayments.com). Vytvoří se tam testovací aplikace s vlastním App ID a vlastním App Key.
Nastavení Global Payments na fakturačním účtu
Každý fakturační účet má vlastní platební bránu. Global Payments tak můžete vyhradit jen pro část svých aktivit a ostatní ponechat na jiném účtu.
- Přejděte do Administrace›Nastavení›Fakturace›Fakturační účty, otevřete příslušný fakturační účet a přepněte na kartu Platby.
- Povolte Online platby a v seznamu platebních bran vyberte Global Payments.
- Vložte své App ID a App Key. App Key se ukládá v šifrované podobě a už se nikdy nezobrazí celý.
- Ponechte Adresa API na hodnotě
apis.globalpay.com. Hodnotuapis.eu.globalpay.comzvolte pouze tehdy, pokud vám to Global Payments sdělil. - Pole Název účtu nechte prázdné: OpenResa sám vybere účet, který se má použít (viz níže).
- Zaškrtněte Testovací prostředí (sandbox), pokud zadáváte identifikátory testovací aplikace.
- Klikněte na Uložit a poté na Otestovat připojení.
Ve svém prostředí Global Payments nemusíte nastavovat žádnou adresu pro oznámení: OpenResa při každé platbě sám předává své návratové adresy. Tyto kroky shrnuje také odkaz Online nápověda ve formuláři.
Pokud test odpoví, že identifikátory byly odmítnuty, nejprve zkontrolujte políčko testovacího prostředí. Testovací identifikátory fungují pouze se zaškrtnutým políčkem a produkční identifikátory pouze s nezaškrtnutým políčkem.
Výběr účtu pro zpracování
Aplikace Global Payments může zahrnovat několik účtů pro zpracování plateb. Pokud je pole Název účtu prázdné, OpenResa použije jediný dostupný účet, nebo v případě více účtů jediný účet vyhrazený pro platební stránku, jehož název končí na _hpp. Test připojení vám zobrazí vybraný účet, například Připojení ke Global Payments OK — automaticky vybraný účet pro zpracování plateb: transaction_processing_hpp.
Pokud OpenResa nedokáže vybrat účet sám, zpráva testu vypíše dostupné účty. Zkopírujte název účtu, který vám určil Global Payments, do pole Název účtu. Uložte nastavení a poté test spusťte znovu.
Vyzkoušení v testovacím prostředí
S identifikátory testovací aplikace a se zaškrtnutým políčkem Testovací prostředí (sandbox) jsou platby fiktivní: žádná karta není zatížena a zaplacené objednávky vytvářejí faktury řady SPECIMEN, které nemají účetní hodnotu.
Chcete-li provést zkušební platbu, zaplaťte objednávku testovací kartou Visa 4263970000005262 s datem platnosti 05/39 a bezpečnostním kódem 599: platba bude přijata. Další testovací karty jsou popsány v dokumentaci Global Payments.
Pro přechod do produkčního provozu nahraďte App ID a App Key svými produkčními identifikátory. Zrušte zaškrtnutí políčka a uložte nastavení. Poté znovu spusťte test připojení.
Jak probíhá platba na straně uživatele
Při placení uživatel zvolí Online platba s označením přes Global Payments. Poté je přesměrován na platební stránku Global Payments, ve francouzštině nebo angličtině podle svého jazyka. Tam zadá údaje své karty a platbu potvrdí, případně ověřením 3-D Secure, pokud to jeho banka vyžaduje.
Poté se vrátí do OpenResa, který čeká na potvrzení od Global Payments: zpráva Platba potvrzena se obvykle zobrazí přibližně deset sekund po platbě. OpenResa mu pak, stejně jako u každé platební brány, zašle potvrzení a fakturu.
Pro Global Payments platí několik specifických pravidel:
- E-mailová adresa. Global Payments vyžaduje e-mailovou adresu plátce. Uživatel proto musí mít na objednávce nebo ve svém účtu platnou adresu o délce nejvýše 50 znaků. V opačném případě mu bude online platba odmítnuta se zprávou Pro platbu online je nutná platná e-mailová adresa. Zkontrolujte svůj účet.
- Měna. Platba probíhá v měně objednávky, například v kanadských dolarech u klubu v Québecu. Tato měna musí být na vašem účtu Global Payments aktivována: jinak uživatel uvidí zprávu o nedostupnosti a vy budete po několika neúspěších upozorněni.
- Jeden pokus na stránku. Po odmítnutí karty se uživatel vrátí do OpenResa a platbu spustí znovu: vytvoří se nová platební stránka.
Platební stránka Global Payments zůstává platná 24 hodin. Pokud ji uživatel opustí, jeho objednávka zůstane ve stavu čekající na platbu. Může ji pak zaplatit znovu, přes Global Payments nebo jinou platební metodou, kterou nabízíte.
Dohledání platby
Ve vašem portálu Global Payments nese každá platba referenci, která kombinuje číslo objednávky bez pomlček a číslo pokusu o platbu: například BJ2026000123T15349533 odpovídá objednávce 2026-000123. Toto číslo objednávky vyhledejte v části Administrace›Dashboard›Fakturace›Faktury & transakce a objednávku otevřete.
V detailu objednávky transakce uvádí ID transakce od Global Payments, Autorizační číslo a Odkaz. Možnost Protokol událostí fakturačního účtu zobrazuje odpovědi přijaté od Global Payments a výsledek kontroly, včetně důvodu případného neúspěchu. U neúspěšného řádku tlačítko Znovu přehrát znovu ověří platbu u Global Payments a zaeviduje ji, pokud byla úspěšná.
Vrácení peněz za platbu
Vrácení peněz se spouští z části Administrace›Dashboard›Fakturace›Faktury & transakce: otevřete objednávku a klikněte na Vrátit peníze. Poté zvolte úplné nebo částečné vrácení peněz. S dlaždicí Global Payments OpenResa aktualizuje objednávku a předá vrácení peněz do Global Payments, který částku vrátí na kartu plátce.
Úplné vrácení peněz odebere dodané položky (odebrané kredity, zrušené předplatné) a převede objednávku do stavu vrácená. Částečné vrácení peněz ponechá objednávku jako zaplacenou a pouze sníží přijatou částku. Global Payments neumožňuje vrátit víc, než činila částka platby.
Pokud Global Payments vrácení peněz nepotvrdí, například kvůli výpadku spojení, objednávka se přesto aktualizuje. Zpráva Vrácení platby k ověření na straně Global Payments vás vyzve, abyste ve svém portálu ověřili, že vrácení peněz proběhlo, a pokud ne, abyste jej provedli.
