flutterwave-node-v3
v1.1.12
Published
The official Node.JS library for Flutterwave v3 payment APIs
Downloads
13,958
Keywords
Readme
Flutterwave v3 NodeJS Library
Introduction
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.
Table of Content
- Requirements
- Installation
- Initialization
- Usage
- Testing
- Debugging Errors
- Support
- Contribution guidelines
- License
- Changelog
Requirements
- Flutterwave for business (F4B) API Keys
- Node 12 or higher.
Installation
To install the package, run the following command in your Node terminal:
npm install flutterwave-node-v3
Initialization
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.
Usage
- Collections
- Tokenization
- Subscriptions
- Transfers
- Virtual Account
- Bill payments
- Transactions and reporting
- Beneficiaries
- Banks
- Settlements
- OTP
- Ebills
- Misc
- Virtual Cards
- Collection Subaccounts
- Payment-plan
Testing
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
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.