Introduction
The Mobile SDK allows you to accept card payments and payments via Google Pay directly in a native Android app. The library ensures secure card data entry, protects the data during processing, and communicates with the Comgate payment gateway, including full support for 3D Secure authentication.
Warning
This documentation is currently being finalized continuously. Some information and examples may change over time.
Features
- Card payments - secure entry of card number, expiry date, and CVV/CVC code using Secure Fields components
- Google Pay - integrated button with automatic availability check and payment token processing
- 3D Secure - complete support for 3DS authentication, including the challenge screen with fully customizable appearance
- Card data protection - sensitive data never leaves the library in unprotected form
- Validation - automatic input validation (Luhn card number check, expiry validation, CVV length)
- Card network detection - automatic card brand recognition (Visa, Mastercard) with corresponding formatting
Security model
The library is designed so that the host application never has access to unprotected card data:
- Input fields (
SecurePanField,SecureExpiryField,SecureCvvField) handle sensitive data in protected mode and securely clear it after use - Data and transport protection are handled internally by the library and do not need to be implemented manually in the application
Supported card networks
| Card network | PAN lengths | CVV length |
|---|---|---|
| Visa | 16, 19 | 3 |
| Mastercard | 16 | 3 |
Requirements
| Requirement | Value |
|---|---|
| Minimum Android SDK | 28 (Android 9.0) |
| Compile SDK | 34 |
| Kotlin | 1.9+ |
| Java compatibility | 11 |
Information
To use the Mobile SDK, you must have Checkout API activated in the Comgate client portal and have a checkoutId value available. The activation process is described in Activate Checkout API.