izipay_payment #

A Flutter plugin to integrate the official Izipay SDKs on Android and iOS, allowing payments directly in Flutter applications.

📌 Official documentation:

• Android SDK
• iOS SDK

Platform Support #

This package supports the following platforms:

✅ Android
✅ iOS
❌ Windows (Not Supported)
❌ macOS (Not Supported)
❌ Linux (Not Supported)
❌ Web (Not Supported)

This plugin is designed to work exclusively on Android and iOS.
For more details, refer to the official documentation.

🚀 Configuration on Android #

1. Pre-configuration #

Some configurations are necessary before using the SDK on Android.

2. Configure build.gradle (app module) #

Add the following lines in android/app/build.gradle:

plugins {
  id 'kotlin-kapt'
  id 'dagger.hilt.android.plugin'
}

dependencies {
   implementation "com.google.dagger:hilt-android:2.44"
   kapt "com.google.dagger:hilt-compiler:2.44"
}

javaCompileOptions {
   sourceCompatibility JavaVersion.VERSION_17
   targetCompatibility JavaVersion.VERSION_17
}

3. Configure settings.gradle #

Add in android/settings.gradle:

plugins {
   id "com.google.dagger.hilt.android" version "2.44" apply false
}

4. Create the SDKExampleApp.kt class #

Create the file SDKExampleApp.kt at the path android/app/src/main/kotlin/{your_package}/SDKExampleApp.kt:

import android.app.Application
import dagger.hilt.android.HiltAndroidApp

@HiltAndroidApp
class SDKExampleApp : Application() {
   override fun onCreate() {
      super.onCreate()
   }
}

5. Configure AndroidManifest.xml #

Add the reference to SDKExampleApp within the <application> tag in AndroidManifest.xml:

<application
   android:name=".SDKExampleApp"
   ...>
</application>

🍏 Implementation on iOS #

📌 Requires a minimum of iOS 13:

platform :ios, '13.0'

🛠 Usage in Flutter #

1. Add the dependency in pubspec.yaml #

Add the library in pubspec.yaml:

dependencies:
  izipay_payment_flutter:
   path: ../izipay_payment_flutter

2. Import the library and use the plugin #

In the Flutter code, import the package and call the payment initiation method:

import 'package:izipay_payment_flutter/izipay_payment_flutter.dart';

Future<void> initPaymentIzipay() async {
   final config = {
    "environment": "SBOX", // SBOX, TEST, PROD
    "action": "register",
    "clientId": "<MERCHANT CODE>",
    "merchantId": "<public key>",
    "order": {
      "currency": "PEN",
      "amount": "11.00",
      "email": "[email protected]"
    },
    "billing": {
      "firstName": "Juan",
      "lastName": "Quispe",
      "email": "[email protected]",
      "phone": "930292619",
      "address": "Av. flores",
      "city": "Lima",
      "region": "Lima",
      "country": "PE",
      "postalCode": "33065",
      "idType": "DNI",
      "idNumber": "55555555"
    },
    "shipping": {
      "firstName": "Juan",
      "lastName": "Quispe",
      "email": "[email protected]",
      "phone": "930292619",
      "address": "Av. Alamo",
      "city": "Lima",
      "region": "Lima",
      "country": "PE",
      "postalCode": "33065",
      "idType": "DNI",
      "idNumber": "55555555"
    },
    "appearance": {
      "language": "ESP",
      "themeColor": "green",
      "primaryColor": "#333399",
      "secondaryColor": "#333399",
      "tertiaryColor": "#333399",
      "logoUrl": "https://logowik.com/content/uploads/images/shopping-cart5929.jpg"
    }
   };
   final paymentConfig = PaymentConfig.fromJson(config);
   try {
    response = await _izipayPaymentFlutterPlugin.startPayment(paymentConfig);
    // Send the response to the service
    print(response);
   } on PlatformException {
    response = 'Failed to get platform version.';
    setState(() {});
   }
}

✅ Example of a successful response #

{
  "code": "00",
  "message": "OK",
  "header": {
   "transactionStartDatetime": "2025-02-06 09:40:40.879",
   "transactionEndDatetime": "2025-02-06 09:41:15.552",
   "millis": 34674
  },
  "response": {
   "merchantCode": "<public key>",
   "facilitatorCode": "",
   "merchantBuyerId": "MB101738852840885",
   "card": {
    "brand": "VS",
    "pan": "497010**0014"
   },
   "token": {
    "cardToken": "118ea63399a6fb4e06d41789189d1bc8bf480f6470be169ba2b54c70d36cfd94"
   },
   "transactionId":"DMKTL1738960727033",
    "orderNumber":"1738960727033"
  },
  "result": {
   "messageFriendly": "Operación exitosa"
  }
}

📌 Notes:

• Verify that the configuration values are correct according to the environment (sandbox, test, production).
• Properly handle platform errors to improve user experience.

🎯 Ready! Now you can integrate Izipay payments into your Flutter app. 🚀