The major reason for this fork is for the adoption of typescript and type support in the Flutterwave NodeJS Project (see: Flutterwave#156, Flutterwave#139, Flutterwave#69, Flutterwave#64, Flutterwave#25 - Since 2020).
This repo has two branches: This branch uses .d.ts files and JSDoc for adding type intellisense to the code. For a full typescript implementation see the ts branch.
The Node library provides easy access to Flutterwave for Business (F4B) v3 APIs for your Node apps. 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, Apple Pay, Google Pay, Fawry Pay, eNaira.
- Payouts and Beneficiaries.
- Recurring payments: Tokenization and Subscriptions.
- Split payments
- Card issuing
- Transactions dispute management: Refunds and Chargebacks.
- Transaction reporting: Collections, Payouts, Settlements, Refunds, Chargebacks and Transaction timeline.
- Bill payments: Airtime, Data bundle, Cable, Power, Toll, E-bills, and Remitta.
- Identity verification: Resolve bank account, resolve BVN information and generate OTP.
- Flutterwave for business (F4B) API Keys
- Node 12 or higher.
To install the package, run the following command in your Node terminal:
npm install flutterwave-node-v3
const Flutterwave = require('flutterwave-node-v3');
const flw = new Flutterwave(
process.env.FLW_PUBLIC_KEY,
process.env.FLW_SECRET_KEY,
);
For staging (Test environment), use the TEST API Keys and for production (Live environment), use LIVE API KEYS. You can get your process.env.FLW_PUBLIC_KEY and process.env.FLW_SECRET_KEY from the Flutterwave dashboard. Read the requirement section for more information on how to get your API keys.
- Collections
- Tokenization
- Subscriptions
- Transfers
- Virtual Account
- Bill payments
- Transactions and reporting
- Beneficiaries
- Banks
- Settlements
- OTP
- Ebills
- Misc
- Virtual Cards
- Collection Subaccounts
- Payment-plan
All of the libraries tests are run on Mocha. Available tests include rave.bank.test
, rave.beneficiaries.test
, rave.bills.test
, rave.charge.test
, rave.ebills.test
, rave.settlements.test
, rave.subscriptions.test
. They can be run by running the test command in your terminal.
npm run test or npm test
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.
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 😊.
Read more about our community contribution guidelines here
By contributing to this library, you agree that your contributions will be licensed under its MIT license. Copyright (c) Flutterwave Inc.