Flutterwave v3 Java Library

Introduction

The Java library provides easy access to Flutterwave for Business (F4B) v3 APIs for your Java codebase. It abstracts the complexity involved in direct integration and allows you to make quick calls to the APIs.

Available features include:

• Collections: Card, Account, Mobile money, Bank Transfers, USSD, Barter, NQR.
• Payouts and Beneficiaries.
• Recurring payments: Tokenization and Subscriptions.
• Split payments
• Card issuing
• Transactions dispute management: Refunds and Chargebacks.
• Transaction reporting: Collections, Payouts, Settlements, Refunds and Chargebacks.
• Bill payments: Airtime, Data bundle, Cable, Power, Toll, E-bills, and Remitta.
• Identity verification: Resolve bank account, resolve BVN information and generate OTP.

Heads Up!

This Library cannot be used on a project with a file named "base.properties" in project path.

Table of Content

1. Requirements
2. Installation
3. Initialization
4. Usage
5. Testing
6. Debugging Errors
7. Support
8. Contribution guidelines
9. License
10. Changelog

Requirements

1. Flutterwave for business API Keys
2. Java

Installation

Maven users

Add this dependency to your project's POM:

<dependency>
 <groupId>com.flutterwave</groupId>
    <artifactId>f4b-java</artifactId>
    <version>3.0</version>
</dependency>

Gradle users

Add this dependency to your project's build file:

compile("com.flutterwave:f4b-java:3.0")

Environment Variables

The foloowing environment variables need to be set before calling any method

  Environment.setSecretKey("FLWSECK_TEST-92e*******-X");
  Environment.setPublicKey("FLWSECK_TEST-92e*******-X");
  Environment.setEncryptionKey("FLWSECK_TE********c1f2");

For staging, Use TEST API Keys and for production, use LIVE API KEYS. You can get your keys from the Flutterwave dashboard.

Read the requirement section for more information on how to get your API keys.

Usage

1. Collections
2. Tokenization
3. Split payments
4. Scheduled payments
5. Transfers
6. Card Issuing
7. Virtual Account
8. Bill payments
9. Transactions and reporting
10. Beneficiaries
11. Banks
12. Settlements
13. OTP
14. Misc
15. Subscriptions
16. PaymentPlans

Debugging Errors

We understand that you may run into some errors while integrating our library. You can read more about our error messages here.

For authorization and validation error responses, double-check your API keys and request. If you get a server error, kindly engage the team for support.

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 this library, you agree that your contributions will be licensed under its MIT license.

Copyright (c) Flutterwave Inc.