Úvod
Mobilné SDK umožňuje prijímať karetní platby a platby prostredníctvom Google Pay priamo v natívnej Android aplikácii. Knižnica zabezpečuje bezpečné zadávanie karetních údajov, ich ochranu počas spracovania a komunikaci s platobnou bránou Comgate — vrátane plné podpory 3D Secure autentifikácie.
Upozornenie
Táto dokumentácia je aktuálne vo fáze priebežného dopracovania. Niektoré informácie a ukážky sa môžu v čase meniť.
Funkcie
- Kartové platby — zabezpečené zadávanie čísla karty, data expirace a CVV/CVC kódu pomocí komponent Secure Fields
- Google Pay — integrované tlačidlo s automatickou kontrolou dostupnosti a spracovaniam platebního tokenu
- 3D Secure — kompletní podpora 3DS autentifikácie vrátane challenge obrazovky s plně přizpůsobitelným vzhledem
- Ochrana karetních dat — citlivé údaje nikdy neopustia knihovnu v nechráněné podobě
- Validácia — automatická validace vstupů (Luhn kontrola čísla karty, kontrola expirace, délka CVV)
- Detekcia kartové siete — automatické rozpoznání značky karty (Visa, Mastercard) s odpovídajícím formátováním
Bezpečnostní model
Knižnica je navržena tak, aby hostitelská aplikace nikdy neměla přístup k nechráněným karetním údajovm:
- Vstupní pole (
SecurePanField,SecureExpiryField,SecureCvvField) pracují s citlivými údaji v chráněném režimu a po použitie 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é kartové siete
| Kartová sieť | Délky PAN | Délka CVV |
|---|---|---|
| Visa | 16, 19 | 3 |
| Mastercard | 16 | 3 |
Požiadavky
| Požiadavka | Hodnota |
|---|---|
| Minimálne Android SDK | 28 (Android 9.0) |
| Compile SDK | 34 |
| Kotlin | 1.9+ |
| Java compatibility | 11 |
Informácie
Pro využití Mobilného SDK je nutné mať aktivované Checkout API v klientskom portáli Comgate a k dispozícii hodnotu checkoutId. Postup aktivácie je popsán v sekcii Aktivácia Checkout API.