ipg_flutter is a Flutter plugin that allows merchants registered with Spemai (Pvt) Ltd to securely save their customers’ card details and retrieve them later for fast and secure payments.

Features

• Securely save customer card details
• Retrieve saved cards
• Perform card-based payments with previously saved cards
• Three powerful callback handlers:
  • addCardEventCallback – card addition status
  • getCustomersEventCallback – returns saved cards
  • customerPaymentEventCallback – returns payment results

Getting started

Add the dependency in your pubspec.yaml:

dependencies:
  ipg_flutter: ^1.1.3

Usage

var ipg = Ipg.init(
appToken: 'your_token',
appId: 'your_app_id',
firstName: 'John',
lastName: 'Doe',
email: 'john.doe@sample.com',
phoneNumber: '0000000000',
);

// Start card addition flow
ipg.addNewCard(context);

// Callback when card add flow completes
ipg.addCardEventCallback = (status, errorMessage) {
print("Adding card result: $status - $errorMessage");
};

// Retrieve customer list (saved cards)
ipg.getCustomers();

// Callback when customers are retrieved
ipg.getCustomersEventCallback = (customerList, errorMessage) {
print("Customers: $customerList");
};

// Make customer payment
// Valid Currency codes: LKR, USD
ipg.makeCustomerPayment(amount, currencyCode, customerCardToken);

// Listen to payment status
ipg.customerPaymentEventCallback = (status, errorMessage ) {
print("Payment Status: $status - $errorMessage");
};

---

Android Setup

Since this package communicates with the internet, make sure you have added the following permission in your AndroidManifest.xml file:

<uses-permission android:name="android.permission.INTERNET" />

---

📦 Example

Clone the repo and run the example:

cd example
flutter create
flutter run

You can also view the code in the example/ folder.

---

🧩 API Reference

Method	Description
Ipg.init(...)	Initializes the IPG with merchant/user
ipg.addNewCard(context)	Launches secure add-card flow
ipg.makeCustomerPayment(amount, currencyCode, customerCardToken)	Make Customer payment using tokenized card
ipg.getCustomers()	Fetches list of saved customer cards
addCardEventCallback	Callback for add card result
getCustomersEventCallback	Callback for saved customers
paymentStatusCallback	Callback for payment completion status

---

⚠️ Special Instruction

Make sure to use the same environment appId (dev, staging, or production) when adding cards and when making payments.

For example, if you use your development app_id when calling:

var ipg = Ipg.init(
appToken: 'your_token',
appId: 'your_app_id',
);
ipg.addNewCard(context);

then you must also use the same environment app_id with customer_token when calling:

ipg.makeCustomerPayment(amount, currencyCode, customerCardToken);

---

If you instead use a different environment (e.g., dev app_id to add card, then prod app_id to pay), Spemai backend will reject the request because the card was added under a different environment.---

❓ FAQ

Is this plugin secure?

Yes, it uses encrypted communication and secure storage through Spemai's backend.

Can any app use this?

Only merchants registered with Spemai (Pvt) Ltd can use this plugin via provided credentials.

Which platforms are supported?

• ✅ Android
• ✅ iOS
• ❌ Web (planned)

📄 License

MIT License

---

🔗 Links

• Homepage
• Repository
• Issue Tracker
• Documentation