Aktivácia Checkout API
Pro používaní Mobilného SDK je nezbytné mít aktivované Checkout API v klientskom portáli Comgate. Aktivácia je velice jednoduchá — stačí se přihlásit do klientského portálu a postupovat podle následujícího návodu.
V rámci používateľského rozhraní konfigurace Checkout SDK je uvedeno mnoho doplňujících informací, které se vztahují výhradne ke knihovně Javascript Checkout SDK. Tieto informace nejsou relevantní pro Mobilné SDK. Ignorujte je proto a zaměřte se iba na aktivaci Checkout API dle této dokumentácia.
Aktivácia
-
V horním menu vyberte Integrace a v části Nastavenie obchodů vyberte obchod, pro který chcete aktivovat Checkout API.
-
V horní části stránky vyberte kartu Propojení obchodu a následně vyberte k editaci propojení, přes které chcete zpracovávat platby.
-
Najděte položku Mobil SDK a zakliknite ji.
- 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.
- Klikněte na tlačidlo Uložit.
Tím je celá aktivace dokončena.
Získání checkoutId
Pro využití Checkout API je nutné získat hodnotu checkoutId, která slouží k jednoznačné identifikaci propojení obchodu:
- Přejděte na seznam propojení obchodu, viz kroky 1 a 2 výše v části Aktivácia.
- V seznamu propojení obchodu nájdite požadované propojení a kliknite na symbol oka pro zobrazení detailu.
- Na stránce detailu sjeďte dolů a v sekcii Mobil SDK nastavenia nájdite pole CheckoutId.
Získanou hodnotu checkoutId následně odovzdáte do konstruktoru ComgateSecureSession pri inicializaci knižnice.
Registrace Android aplikace
Knižnica pri inicializaci ověřuje, zda je volající aplikace oprávněna používat dané propojení obchodu. Aby inicializace proběhla úspěšně, je nutné přidat package name vašej aplikace do seznamu povolených aplikací — toto nastavenie se nachází na stejném místě v klientskom portáli jako výše popsané získání 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 aplikace není v seznamu povolených, knižnica inicializaci odmítne a vrátí chybu.