Požadavky na integraci pro dodavatele

V tomto článku najdete seznam požadavků pro integraci platební brány GoPay do dodavatelských obchodních platforem (např. e-shopová řešení typu Shoptet nebo Eshop-rychle.cz).

Jednotlivé požadavky vychází z dlouhodobých zkušeností GoPay s integracemi platební brány GoPay do těchto řešení. Jejich cílem je zajistit optimální zobrazení a fungování platební brány GoPay pro koncové uživatele a dosáhnout maximálního konverzního výkonu celého objednávkového procesu.

Tip GoPay: Chcete se stát Certifikovaným dodavatelem GoPay? Integrujte GoPay podle uvedených požadavků, nechte si integraci posoudit a získejte označení Certifikovaný dodavatel GoPay. Více informací najdete v článku Jak získám označení Certifikovaný dodavatel GoPay?

Technické požadavky

• Integrujte aktuální verzi platební brány.

• Provádějte dotaz na stav platby po přesměrování zákazníka zpět na prodejní místo a po každém přijetí http notifikace dle článku Ověření stavu platby v systému platební brány prostřednictvím REST API.
• Před vyvoláním platební metody v objednávce použijte funkci “Získání seznamu povolených platebních metod”, která jako výsledek vrátí seznam aktuálně povolených platebních metod pro konkrétní GoID, viz dokumentace. Zajistěte, aby funkce byla použita pouze jednou během platby, aby nedocházelo k nadbytečnému zatížení platebního systému.

• Pokud po vyvolání platební brány dojde ke zpětnému přesměrování do obchodu (například v případě zavření inline brány přes křížek /close, zobrazte finální stránku s objednávkou a to v závislosti na stavu platby, nebo zvolené platební metodě. Zohledněte přitom na stránce tyto situace:
  • platba zaplacena
  • platba nezaplacena
    • stránka před zvednutím brány
    • nesmazaný košík
    • vytvořená objednávka, odeslaný e-mail, aby bylo možno znovu zaplatit neuhrazenou platbu
  • zvolena platba klasickým bankovním příkazem (bankou offline), čeká se na uhrazení

• Umožněte provoz vašeho řešení na zabezpečených stránkách. Pokud vaše řešení nebude provozováno na HTTPS, nebude možné na něm vyvolat inline variantu platební brány.

• Pokud znáte e-mailový a telefonní kontakt zákazníka (vyplnění údajů u objednávky na e-shopu, registrace uživatel atd.), předávejte jej v požadavku založení platby v objektu payer parametr contact, viz dokumentace.

• Zajistěte, aby se koncovému zákazníkovi zobrazila platební brána v jazykové lokalizaci v závislosti na jazyku, v jakém vytvořil objednávku.

Požadavky na prezentaci platebních metod v objednávce

• Jednotlivé platební metody prezentujte v objednávce odděleně. Například platbu kartou nebo platbu bankovním převodem zobrazte v objednávce zvlášť a ne pod jednou volbou. Toto doporučení se nevztahuje na online bankovní převody, resp. bankovní tlačítka, které je možné s ohledem na jejich vysoký počet prezentovat v objednávce pod jednou volbou s tím, že výběr konkrétní banky provede zákazník na platební bráně.

• Při prezentaci platebních metod v objednávce vycházejte z variant A. Přímá varianta a B. Částečně agregovaná varianta, které jsou popsány v článku Jak správně zobrazovat platební metody?
• Po výběru platební metody v objednávce a po dokončení zbývajících částí objednávky nasměrujte platícího zákazníka na stránku platební brány, která odpovídá zvolené platební metodě. Pokud např. zákazník zvolí v objednávce platbu kartou, směrujte ho po dokončení objednávky rovnou na stránku platební brány pro platbu kartou, viz příklad

  { 
  "default_payment_instrument": "PAYMENT_CARD"
  }

  Analogicky postupujte i u ostatních platebních metod. 

• K prezentaci platebních metod v objednávce využijte jejich oficiální loga. Všechna loga platebních metod, která GoPay podporuje, jsou dostupná ke stažení v článku Jaká používat loga a názvy platebních metod? Loga i oficiální názvy platebních metod jsou zároveň předávána také prostřednictvím GoPay REST API.

​Požadavky na prezentaci platebních metod v administraci

• Dodatečné zpoplatnění platebních metod, které GoPay nabízí, je zakázáno. Respektujte tuto zásadu a neumožněte zpoplatnění v administraci nastavit.

• Používejte přesné názvy testovacích a provozních údajů, tedy GoID, ClientID a ClientSecret.

• Zobrazujte korektní stavy plateb u objednávek ve výpisu objednávek a zajistěte, aby tyto stavy byly zobrazovány koncovému zákazníkovi po přesměrování na return_url obchodního místa, viz dokumentace.

Požadavky na registraci ke GoPay

• Pokud je to možné, umožněte GoPay předávat provozní údaje obchodníků do administrace vaší platformy. Ideálním řešením je zajištění přístupu přes přihlášení na doméně zákazníka pod www.eshop.cz/gopay-login. Po přihlášení bude moci technik GoPay zadat do formuláře potřebné údaje.

• Zajistěte, aby se uživatelé vašeho řešení mohli registrovat u GoPay prostřednictvím vám přiděleného registračního formuláře se specifickou URL adresou. Díky registraci přes tento formulář rozpoznáme, že daný obchodník používá vaše řešení. Odkaz na registrační formulář prezentujte na viditelném místě v administraci vašeho řešení i na vašich webových stránkách, v případě, že na nich uvádíte informace o GoPay.

Požadavky na prezentaci GoPay

• Pro prezentaci informací o GoPay na vašich stránkách nebo v administraci vašeho řešení vycházejte výhradně z článku Jaké informace o GoPay můžete prezentovat zákazníkům? Pokud chcete prezentovat informace nad rámec toho, co je v článku uvedeno, vždy o tom GoPay informujte a výsledný záměr s námi konzultujte.​