Implementace nového vzhledu platební brány pro stávající zákazníky

Platební brána GoPay nově umožňuje využít platbu přes inline variantu i na starších verzích API platební brány. Nová integrace umožňuje obchodníkům zaimplementovat inline platební bránu do stávajícího řešení tak, aby nebyla narušena jeho dostupnost či stabilita.

Tip GoPay:
Před začátkem používání inline platební brány, prosím, kontaktujte technické oddělení na e-mailu integrace@gopay.cz, abychom ověřili správnost vašeho nastavení. 

Implementace nového vzhledu platební brány pro stávající prodejní místa

Nový vzhled platební brány je pro naše obchodníky připraven tak, aby při jeho implementaci nebyla narušena dostupnost či stabilita stávající integrace, tedy standardní platební brány. Integrace nového vzhledu platební brány je v takovém případě výrazně rychlejší a levnější.

Veškeré funkcionality využívající webovou službu GoPay jsou nadále plně dostupné. 

Inicializace nového vzhledu platební brány

Rozdílná část integrace spočívá ve vyvolání inline platební brány namísto provedení přesměrování na platební bránu GoPay. Inline platební brána je vyvolána za použití formuláře s javascriptovou knihovnou, šifrovaným podpisem a paymentSessionId předem založené platby. U redirect varianty platební brány je provedeno přesměrování se stejným designem jako u inline brány, avšak bez použití javascriptové knihovny.

Testovací prostředí

V testovacím režimu platební brány můžete plně doladit úpravu své stávající integrace pro verzi s novým vzhledem.

Ukázka formuláře pro inicializaci inline platební brány v testovacím prostředí

<form action="https://gw.sandbox.gopay.com/gw/v3/3100000099" method="post" id="gopay-payment-button">
  <input type="hidden" name="signature" value="25ee53a1ec­cc253a8310f5267d2de6b483f58a­f9676d883e26600ce3316ai"/>
  <button name="pay" type="submit">Zaplatit</button>
  <script type="text/javascript" src="https://gw.sandbox.gopay.com/gp-gw/js/embed.js"></script>
</form>

Ukázka formuláře pro inicializaci hostované platební brány v testovacím prostředí

<form action="https://gw.sandbox.gopay.com/gw/v3/3100000099" method="post" id="gopay-payment-button">
  <input type="hidden" name="signature" value="25ee53a1ec­cc253a8310f5267d2de6b483f58a­f9676d883e26600ce3316ai"/>
  <button name="pay" type="submit">Zaplatit</button>
</form>

Produkční prostředí

V produkčním režimu platební brány, který je zpřístupněn po provedení nezbytných testů a podpisu smlouvy, je ve formulářích nutné změnit adresy z https://gw.sandbox.gopay.com na https://gate.gopay.cz spolu s adresou webové služby a údaji goId a secureKey.

Ukázka formuláře pro inicializaci inline platební brány v produkčním prostředí

<form action="https://gate.gopay.cz/gw/v3/3100000099 method="post" id="gopay-payment-button">
  <input type="hidden" name="signature" value="25ee53a1ec­cc253a8310f5267d2de6b483f58a­f9676d883e26600ce3316ai"/>
  <button name="pay" type="submit">Zaplatit</button>
  <script type="text/javascript" src="https://gate.gopay.cz/gp-gw/js/embed.js"></script>
</form>

Ukázka formuláře pro inicializaci hostované platební brány v produkčním prostředí

<form action="https://gate.gopay.cz/gw/v3/3100000099 method="post" id="gopay-payment-button">
  <input type="hidden" name="signature" value="25ee53a1ec­cc253a8310f5267d2de6b483f58a­f9676d883e26600ce3316ai"/>
  <button name="pay" type="submit">Zaplatit</button>
</form>

Řetězec pro sestavení podpisu
targetGoId+|+pa­ymentSessionId+|+se­cureKey

Vzorovou implementaci pro sestavení podpisu v PHP naleznete níže.

$encryptedSignature = GopayHelper::encrypt(
                      GopayHelper::hash(
                      GopayHelper::concatPaymentCommand($targetGoId,
                                                        $paymentSessionId,
                                                        $secureKey)
                                                     ), $secureKey);