Overview & Prerequisites
The Fiuu Mobile XDK provides a seamless payment gateway integration experience for mobile applications. It supports payment initiation, status tracking, and in-app redirection across native and hybrid platforms.
Supported Platforms
Only public SDK repositories are listed below. Use these links from the FiuuPayment GitHub organization.
| Platform | SDK / Repository |
|---|---|
| Android Native (Java) | Mobile-XDK-Fiuu_Android_Library |
| Android Native (Kotlin) | Mobile_XDK_Fiuu_Android_Kotlin |
| iOS (Swift / SwiftUI) | Mobile-XDK-Fiuu_Swift |
| iOS (Objective-C) | Mobile-XDK-Fiuu_Objective-C |
| iOS (CocoaPods) | Mobile-XDK-Fiuu_Cocoapods_Framework |
| Flutter | Mobile-XDK-Fiuu_Flutter |
| React Native | Mobile-XDK-Fiuu_React_Native |
| Expo | Mobile-XDK-Fiuu_Expo |
| Ionic Capacitor | Mobile-XDK-Fiuu-Ionic-Capacitor |
| Cordova | Mobile-XDK-Fiuu_Cordova |
| .NET MAUI | Mobile_XDK_Fiuu_DotNetMAUI |
| Channel list & sample CSS | Mobile-XDK-Fiuu_Examples |
Use the public Swift SDK (FiuuXDKSwift) with a UIViewControllerRepresentable wrapper. See the SwiftUI guide.
Recommended Configurations
Requirements vary by framework. Use the table below as a quick reference — always check your framework's specific guide for the latest values.
General (Node & Cross-Platform)
| Requirement | React Native | Expo | Cordova |
|---|---|---|---|
| Node.js | 22.13.0+ (RN 0.87 example) | 18.20.5+ | 20.14.0+ |
| Java | — | 21.0.7 | — |
| npm plugin | fiuu-mobile-xdk-reactnative 1.0.27+ | fiuu-mobile-xdk-expo 1.0.2+ | See Cordova wiki |
Android
| Requirement | Android Library | React Native | Ionic Capacitor | Flutter |
|---|---|---|---|---|
| minSdkVersion | 26+ | 26+ | 26+ | 26+ |
| targetSdkVersion | 37+ | 37+ | Android 8.0+ | 37+ |
| compileSdk | 37+ | 37+ | 37+ | 37+ |
| Android Gradle Plugin | 9.1.1+ | — | — | 9.1.1+ |
| Gradle | 9.0+ | — | — | 9.0+ |
| JDK | 17 | — | — | 17 |
| Current native library | 3.34.41 | 3.34.41 (via plugin) | via Capacitor plugin | 3.34.41 (via plugin) |
iOS
| Requirement | Swift / SwiftUI | React Native / Expo | CocoaPods | Cordova | Ionic Capacitor |
|---|---|---|---|---|---|
| Minimum iOS | 16.0+ | 16+ | 16+ | 16.0+ | 13+ |
| Xcode | 14+ | 15+ | 13+ | — | 15+ |
| Swift | 5.0+ | — | — | — | — |
| Current native SDK | FiuuXDKSwift 1.1.1 | 1.1.1 (via RN plugin) | fiuu-mobile-xdk-cocoapods 3.34.10 | — | via Capacitor plugin |
Framework Specifics
| Framework | Version |
|---|---|
| React Native | 0.76+ (example app: 0.87) |
| Flutter | 3.24.5+ (Dart 3.4.0+), plugin 3.34.36 on pub.dev |
| Ionic Capacitor | Capacitor plugin fiuuxdk-capacitor-plugin 1.0.5+ |
| Cordova SDK | 12.0.0+ |
| .NET MAUI | Visual Studio Community 2022 (Android) |
iOS Info.plist Requirements
Most iOS integrations require the following keys in Info.plist:
- App Transport Security Settings → Allow Arbitrary Loads →
YES - NSPhotoLibraryUsageDescription →
Payment images - NSPhotoLibraryAddUsageDescription →
Payment images
Android ProGuard Rules
For release builds on Android, add these rules to proguard-rules.pro:
# For WebView / Javascript bridge
-keepclassmembers class * {
@android.webkit.JavascriptInterface <methods>;
}
# Keep XDK classes (prevents obfuscation of JS bridge / payment result handling)
-keep class com.fiuu.xdk.** { *; }
Channel List Reference
Payment channel codes (e.g. maybank2u, TNG-EWALLET, credit) are documented in the channel list.