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 klientského portálu a postupovať podľa nasledujúceho návodu.
V rámci používateľského rozhrania konfigurácie Checkout SDK je uvedených mnoho doplňujúcich informácií, ktoré sa vzťahujú výhradne ku knižnici Web Checkout SDK. Tieto informácie nie sú relevantné pre Mobile Checkout SDK. Ignorujte ich preto a zamerajte sa iba na aktiváciu Checkout API podľa tejto dokumentácie.
Aktivácia
-
V hornom menu vyberte Integrácia a v časti Nastavenie obchodov vyberte obchod, pre ktorý chcete aktivovať Checkout API.
-
V hornej časti stránky vyberte kartu Prepojenie obchodu a následne vyberte na editáciu prepojenie, cez ktoré chcete spracovávať platby.
-
Nájdite položku Mobil SDK a zakliknite ju.
- Dojde k rozbaleniu ďalších nastavení pre Mobil SDK. Do poľa Povolené aplikácie pridajte zoznam package name vašich mobilných aplikácií — každý package name na samostatný riadok.
- 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:
- Prejdite na zoznam prepojení obchodu, viď kroky 1 a 2 vyššie v časti Aktivácia.
- V zozname prepojení obchodu nájdite požadované prepojenie a kliknite na symbol oka pre zobrazenie detailu.
- Na stránke detailu zíďte nadol a v sekcii Mobil SDK nastavenia nájdite pole CheckoutId.
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.
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.