Flutterwave Flutter SDK (Standard)

The Flutter library helps you create seamless payment experiences in your dart mobile app. By connecting to our modal, you can start collecting payment in no time.

Available features include:

Collections: Card, Account, Mobile money, Bank Transfers, USSD.
Recurring payments: Tokenization and Subscriptions.
Split payments.

Requirements
Installation
Usage
Support
Contribution guidelines
License

Requirements

Flutterwave for business API Keys
Supported Flutter version >= 1.17.0
Dart SDK >= 2.17.0
For Android development, ensure the NDK version >= 27.0.12077973 on your project's android/app/build.gradle.kts file with android { ndkVersion = "27.0.12077973" }.

Installation

Add the dependency to your project. In your pubspec.yaml file add: flutterwave_standard: 1.1.0
Run flutter pub get.

Usage

Initializing a Flutterwave instance

To create an instance, you should call the Flutterwave constructor. This constructor accepts a mandatory instance of the following:

publicKey
Customer
amount
email
fullName
txRef
isTestMode
paymentOptions
redirectUrl
Customization

It returns an instance of Flutterwave which we then call the async method .charge() on.

handlePaymentInitialization() async {
	 final Customer customer = Customer(
	 name: "Flutterwave Developer",
	 phoneNumber: "1234566677777",
     email: "customer@customer.com"
 );
    final Flutterwave flutterwave = Flutterwave(
        publicKey: "Public Key-here",
		currency: "currency-here",
        redirectUrl: "add-your-redirect-url-here",
        txRef: "add-your-unique-reference-here",
        amount: "3000",
        customer: customer,
        paymentOptions: "ussd, card, bank transfer",
        customization: Customization(title: "My Payment"),
        isTestMode: true );

         final ChargeResponse response = await flutterwave.charge(context);

    // Handle the response
    if (response.success == true) {
    // Payment was successful
    } else {
    // Payment failed or was cancelled
    }
 }

Handling the response

Calling the .charge() method returns a Future of ChargeResponse which we await for the actual response as seen above.

final ChargeResponse response = await flutterwave.charge(context);

Call the verify transaction endpoint with the transactionID returned in response.transactionId or the txRef you provided to verify transaction before offering value to customer

Note

ChargeResponse can be null, depending on if the user cancels the transaction by pressing back.
You need to confirm the transaction status is successful. Ensure that the txRef, amount, and status are correct and successful. Be sure to verify the transaction details before providing value.
Some payment methods are not instant, such a Pay with Bank Transfers, Pay with Bank, and so you would need to rely on webhooks or call the transaction verification service using the transactionId, or transaction reference you created(txRef)
For such long payments like the above, closing the payment page returns a cancelled status, so your final source of truth has to be calling the transaction verification service.

Support

For additional assistance using this library, contact the developer experience (DX) team via email or on slack.

You can also follow us @FlutterwaveEng and let us know what you think 😊.

Contribution guidelines

Read more about our community contribution guidelines here.

License

By contributing to the Flutter library, you agree that your contributions will be licensed under its MIT license.

Flutterwave Flutter SDK (Standard)

Table of Contents

Requirements

Installation

Usage

Initializing a Flutterwave instance

Handling the response

Note

Support

Contribution guidelines

License

Built Using

Other Resources

Libraries

flutterwave_standard package