pelpay_flutter

Description:

pelpay flutter

Pelpay Flutter SDK #
Welcome to Pelpay's Flutter SDK. This library will help you accept card and alternative payments in your iOS & Android apps.
The Pelpay Flutter SDK permits a deployment target of Android version 21 or higher & iOS version 9.0 and higher.
Features #

Highly customizable: Change look & feel of the SDK to suit your brand, set your own logo
Multiple payment methods
3D-Secure & many more




Pay VIA Credit Card
Pay VIA Bank Payment
Pay VIA Bank Transfer










Installation #


Add the Pelpay package to the dependencies section of your pubspec.yaml file. The code below makes the Dart API of the pelpay_flutter plugin available in your application
dependencies:
pelpay_flutter: ^1.0.0
copied to clipboard


Run the following command in your terminal after navigating to your project directory, to download the package
flutter pub get
copied to clipboard


Using the Pelpay SDK #
Step 1: Import the Pelpay sdk files
import 'package:pelpay_flutter/models/customer.dart';
import 'package:pelpay_flutter/models/transaction.dart';
import 'package:pelpay_flutter/pelpay_flutter.dart';

copied to clipboard
Step 2: Complete integration with makePayment method. Provide your own values, where needed
try {
var result = await PelpayFlutter.makePayment(
clientId: "CLIENT_ID_FROM_MERCHANT_DASHBOARD",
clientSecret: "CLIENT_SECRET_FROM_MERCHANT_DASHBOARD",
transaction: Transaction(
integrationKey: "INTEGRATION_KEY_FROM_MERCHANT_DASHBOARD",
amount: 50,
merchantReference: UniqueKey().toString(),
narration: "Sample payment from Flutter",
customer: Customer(
customerId: "xxx",
customerLastName: "olajuwon",
customerFirstName: "adeoye",
customerEmail: "[email protected]",
customerPhoneNumber: "07039544295",
customerAddress: "Lekki 1, Road",
customerCity: "Lagos",
customerStateCode: "LA",
customerPostalCode: "123456")
.toMap(),
),
isProduction: false);

if (result.isTransactionSuccessful) {
// ignore: avoid_print
print("Successful, Your Advice Reference: ${result.adviceReference}");
} else {
// ignore: avoid_print
print(result.errorMessage);
}
} on PlatformException catch (e) {
var error = "Pelpay Error: '${e.message}'.";
// ignore: avoid_print
print(error);
}
copied to clipboard
Note : Ensure when going live, you change the implementation from Staging isProduction : false to production isProduction: true.
Also ensure you don't use staging credentials on production
Demo
Use the 5061 2000 0000 0000 195 test card number to trigger an OTP payment flow with CVV/CVC: 109 future expiration date: 12/2025, Pin: 1234
Use the 4456 5300 0000 0007 test card number to trigger a 3D Secure payment flow with CVV/CVC: 444 future expiration date: 12/2025, Pin: 1234
Use the WEMA BANK with Account number 0238681912 to test bank transactions.
OTP: 123456

Configuration (Android) #
Note : There are extra conditions required for the SDK to work on Android

Step 1: Go to the manifest of your android project within your Flutter project, and add tools:replace="android:label" to the <application> e.g
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools">
<application
tools:replace="android:label">
copied to clipboard
Step 2: Go to the styles file of the android app within your flutter project, and ensure the app theme inherits from Theme.MaterialComponents e.g
<style name="NormalTheme" parent="Theme.MaterialComponents.Light.DarkActionBar">
<item name="android:windowBackground">?android:colorBackground</item>
</style>

copied to clipboard
**If you have any issues, check the example app within the the Pelpay SDK **
Example #
To run the example project, clone the repo, and run the following command in your terminal:
flutter run
copied to clipboard
License #
Pelpay SDK is available under the MIT license. See the LICENSE file for more info.

License

For personal and professional use. You cannot resell or redistribute these repositories in their original state.

Share

• Share on Facebook
• Share on Twitter