Skip to main content

Aktivácia Checkout API

Na používanie Mobilného SDK je nevyhnutné mať aktivované Checkout API v klientskom portáli Comgate. Aktivácia je veľmi jednoduchá — stačí sa prihlásiť do klientskeho portálu a postupovať podľa nasledujúceho návodu.

Tip

V sekcii Peňaženky a SDK je uvedené aj nastavenie, ktoré sa vzťahuje výhradne na knižnicu Web Checkout SDK (Checkout SDK (web), Apple Pay, Google Pay, povolené adresy webu). Tieto položky nie sú pre Mobile Checkout SDK relevantné. Ignorujte ich preto a zamerajte sa iba na aktiváciu Checkout API podľa tejto dokumentácie.

Aktivácia​

  1. V menu vyberte Služby → Platobné brány a otvorte platobnú bránu (obchod), pre ktorú chcete aktivovať Checkout API.

  2. Na záložke Prepojenie obchodu kliknite na prepojenie, cez ktoré chcete spracovávať platby. Otvorí sa jeho detail, kde zvoľte Upraviť.

  3. V sekcii Peňaženky a SDK zaškrtnite položku Mobilné SDK.

https://app.comgate.eu/

alt text

  1. Zobrazí sa zoznam Povolené aplikácie. Tlačidlom Pridať aplikáciu doň pridajte package name všetkých vašich mobilných aplikácií — každú aplikáciu ako samostatnú položku.
https://app.comgate.eu/

alt text

  1. Kliknite na tlačidlo Uložiť.

Tým je celá aktivácia dokončená.

Získanie checkoutId​

Na využitie Checkout API je nutné získať hodnotu checkoutId, ktorá slúži na jednoznačnú identifikáciu prepojenia obchodu:

  1. Prejdite na zoznam prepojení obchodu, viď krok 1 vyššie v časti Aktivácia.
  2. V zozname prepojení obchodu kliknite na požadované prepojenie – zobrazí sa jeho detail.
  3. V sekcii Peňaženky a SDK nájdite pole Checkout ID. Hodnotu skopírujete ikonou vedľa poľa.
https://app.comgate.eu/

alt text

Tip

Získanú hodnotu checkoutId následne odovzdáte do konštruktora ComgateSecureSession pri inicializácii knižnice.

Registrácia Android aplikácie​

Knižnica pri inicializácii overuje, či je volajúca aplikácia oprávnená používať dané prepojenie obchodu. Aby inicializácia prebehla úspešne, je nutné pridať package name vašej aplikácie do zoznamu povolených aplikácií — toto nastavenie sa nachádza na rovnakom mieste v klientskom portáli ako vyššie popísané získanie hodnoty checkoutId.

Informácie

Správnou hodnotu package name vašej aplikace nájdete v konfiguračnom súboru build.gradle(.kts) jako applicationId, alebo v súboru AndroidManifest.xml jako atribút package.

Ak aplikácia nie je v zozname povolených, knižnica inicializáciu odmietne a vráti chybu.