Aktivace Checkout API
Pro používání Mobilního SDK je nezbytné mít aktivované Checkout API v klientském portálu Comgate. Aktivace 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 uživatelského rozhraní konfigurace Checkout SDK je uvedeno mnoho doplňujících informací, které se vztahují výhradně ke knihovně Javascript Checkout SDK. Tyto informace nejsou relevantní pro Mobilní SDK. Ignorujte je proto a zaměřte se pouze na aktivaci Checkout API dle této dokumentace.
Aktivace
- V horním menu vyberte Integrace a v části Nastavení 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 Checkout SDK a zaklikněte ji.
- Dojde k rozbalení dalších nastavení pro Checkout SDK. V této části povolte všechny služby, které chcete prostřednictvím Checkout API provozovat (například Google Pay).
- Klikněte na tlačítko 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 Aktivace.
- V seznamu propojení obchodu najděte požadované propojení a klikněte na symbol oka pro zobrazení detailu.
- Na stránce detailu sjeďte dolů a najděte položku Identifikátor Checkout SDK.
Získanou hodnotu checkoutId následně předáte do konstruktoru ComgateSecureSession při inicializaci knihovny.
Registrace Android aplikace
Knihovna při 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ší aplikace do seznamu povolených aplikací — toto nastavení se nachází na stejném místě v klientském portálu jako výše popsané získání hodnoty checkoutId.
Správnou hodnotu package name vaší aplikace naleznete v konfiguračním souboru build.gradle(.kts) jako applicationId, nebo v souboru AndroidManifest.xml jako atribut package.
Pokud aplikace není v seznamu povolených, knihovna inicializaci odmítne a vrátí chybu.