Úvod
Mobilní SDK umožňuje přijímat karetní platby a platby prostřednictvím Google Pay přímo v nativní Android aplikaci. Knihovna zajišťuje bezpečné zadávání karetních údajů, jejich ochranu během zpracování a komunikaci s platební bránou Comgate — včetně plné podpory 3D Secure autentizace.
Upozornění
Tato dokumentace je aktuálně ve fázi průběžného dopracování. Některé informace a ukázky se mohou v čase měnit.
Funkce
- Karetní platby — zabezpečené zadávání čísla karty, data expirace a CVV/CVC kódu pomocí komponent Secure Fields
- Google Pay — integrované tlačítko s automatickou kontrolou dostupnosti a zpracováním platebního tokenu
- 3D Secure — kompletní podpora 3DS autentizace včetně challenge obrazovky s plně přizpůsobitelným vzhledem
- Ochrana karetních dat — citlivé údaje nikdy neopustí knihovnu v nechráněné podobě
- Validace — automatická validace vstupů (Luhn kontrola čísla karty, kontrola expirace, délka CVV)
- Detekce karetní sítě — automatické rozpoznání značky karty (Visa, Mastercard) s odpovídajícím formátováním
Bezpečnostní model
Knihovna je navržena tak, aby hostitelská aplikace nikdy neměla přístup k nechráněným karetním údajům:
- Vstupní pole (
SecurePanField,SecureExpiryField,SecureCvvField) pracují s citlivými údaji v chráněném režimu a po použití je bezpečně vyčistí - Ochrana dat i transportu je zajištěna interně knihovnou a není potřeba ji v aplikaci ručně implementovat
Podporované karetní sítě
| Karetní síť | Délky PAN | Délka CVV |
|---|---|---|
| Visa | 16, 19 | 3 |
| Mastercard | 16 | 3 |
Požadavky
| Požadavek | Hodnota |
|---|---|
| Minimální Android SDK | 28 (Android 9.0) |
| Compile SDK | 34 |
| Kotlin | 1.9+ |
| Java compatibility | 11 |
Informace
Pro využití Mobilního SDK je nutné mít aktivovaný Checkout API v klientském portálu Comgate a k dispozici hodnotu checkoutId. Postup aktivace je popsán v sekci Aktivace Checkout API.