Integrate easily the Paygate Global Platform into your Flutter app

Features

• Implement payment with the Paygate Global Platform.
• Support for two payment providers : T-Money and Moov Money.

Defining terms uses

• Transaction identifier : identifier you generate yourself (or let this plugin generate) and with which you will be able to identify the transaction and check it's status.
• Transaction amount : amount of money you want to take from user mobile money account.
• Transaction callbackUrl : url you want to be called when the transaction is completed.
• Transaction provider : providers are (at this instant) MoovAfrica (MoovMoney) and Togocom (TMoney).
• Transaction Reference : reference generated by Paygate Global itself. You can also use it to check transaction status.

Getting started

Before you start to use this package, you need to have a Paygate API Key. Create an account on the Paygate Website, fill your E-Commerce platform informations and you will receive your account APi Key.

Usage

First of all you need to initialize the plugin. Just call the Paygate.init() method. This method require your production Paygate API Key. You can also configure the API version you want to use per default when you call the pay method without specifying the version to use (if not specified the second method is used per default).

Paygate.init(
  apiKey: 'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX',
  apiVersion: PaygateVersion.v1, // default PaygateVersion.v2
  apiKeyDebug: 'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX', // optional
  identifierLength: 20, // optional, default 20
);

You can initialize with a additionnal API key used when you are in debug. You can also specify the default length of the identifiers generated by the plugin (default = 20).

Init a new transaction

Paygate has two API versions. Depends on when you want to make a request post, or use the preconfigured payment page with a get request.

1. You make a post request and Paygate return the payment transaction reference with which you can check later the transaction status.

NewTransactionResponse response = await Paygate.payV1(
    amount: 1000,
    provider: PaygateProvider.moovMoney, // required : PaygateProvider.moovMoney or PaygateProvider.tMoney
    identifier: 'TR000000010', // optional : if empty, the transaction identifier will be generated by the plugin.
    description: 'My awesome transaction', // optional : description of the transaction
    phoneNumber: '90010203', // required : phone number of the user
);

2.You make a get request to a payment page provided and secured by Paygate.

NewTransactionResponse response = await Paygate.payV2(
    amount: 1000,
    callbackUrl: 'https://myapp.com/callback',
    provider: PaygateProvider.moovMoney, // required : PaygateProvider.moovMoney or PaygateProvider.tMoney
    identifier: 'TR000000010', // optional : if empty, the transaction identifier will be generated by the plugin.
    description: 'My awesome transaction', // optional : description of the transaction
    phoneNumber: '90010203', // required : phone number of the user
);

Once payment is made by the customer, PayGateGlobal will send a confirmation message to the e-commerce return URL (If previously provided). The message is HTTP Post Method, served with JSON payload, structured as follows:

Property	Description
tx_reference	Unique identifier generated by PayGateGlobal for the transaction
identifier	Internal identifier of the e-commerce transaction.
payment_reference	Payment reference code generated by Flooz.
amount	Amount paid by customer
datetime	Payment Date and Time
phone_number	Telephone number of the customer who made the payment.
payment_method	Payment method used by the customer. Possible values: FLOOZ, T-Money.

With either method 1 or 2, user never quit the application. This package use the custom_tabs package to open the Paygate Global payment page, when you the API version 2.

Check the transaction status

After you have initialized a transaction, you can check the status of the transaction with the verify method, called on the response (NewTransactionResponse) object. Or either juste the static method verifyTransaction, which require the transaction reference or the identifier.

if (response.ok) {
    saveReference(response.txReference); // or save the identifier in your database saveIdentifier(response.identifier);
} else {
    // Retry or debug (a message will be displayed in the console).
    /// You can access the exception with response.exception .
}

// After a delay, you can check the transaction status.
Transaction transaction = await response.verify(); 

// or 

Transaction transaction = await Paygate.verifyTransaction(txReference: response.txReference); // or Paygate.verifyTransaction(trxIdentifier: response.identifier);

Please check the example directory for a complete example with suitable UI implementations.

Additional information

I have wrote a article about this package on my blog which contains more detailled informations.

File free to contribute or fill issues when you use this package.