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 sekci Peněženky a SDK je uvedeno i nastavení, které se vztahuje výhradně ke knihovně Web Checkout SDK (Checkout SDK (web), Apple Pay, Google Pay, povolené adresy webu). Tyto položky nejsou pro Mobile Checkout SDK relevantní. Ignorujte je proto a zaměřte se pouze na aktivaci Checkout API dle této dokumentace.
Aktivace
-
V menu vyberte Služby → Platební brány a otevřete platební bránu (obchod), pro kterou chcete aktivovat Checkout API.
-
Na záložce Propojení obchodu klikněte na propojení, přes které chcete zpracovávat platby. Otevře se jeho detail, kde zvolte Upravit.
-
V sekci Peněženky a SDK zaškrtněte položku Mobilní SDK.
- Zobrazí se seznam Povolené aplikace. Tlačítkem Přidat aplikaci do něj přidejte package name všech vašich mobilních aplikací — každou aplikaci jako samostatnou položku.
- 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 krok 1 výše v části Aktivace.
- V seznamu propojení obchodu klikněte na požadované propojení – zobrazí se jeho detail.
- V sekci Peněženky a SDK najděte pole Checkout ID. Hodnotu zkopírujete ikonou vedle pole.
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.