Flutterwave
Flutterwave is a pan-African payment infrastructure company providing the rails for businesses to accept, send, and manage money across Africa and globally. The Flutterwave for Business (F4B) v4 API exposes a unified surface for collections (cards, mobile money, bank transfer, USSD, OPay, virtual NUBANs), payouts (bank, mobile money, wallet-to-wallet across 30+ countries), real-time FX conversion, settlements, refunds, chargebacks, multi-currency wallets, KYC, card issuing, and bill payments. Flutterwave is one of the most valuable African fintech companies (unicorn status) and processes 20M+ API calls and 500k+ payments per day.
APIs
Flutterwave Payments API
Collect payments across cards, mobile money (M-Pesa, MTN, Airtel, Tigo), bank transfers, USSD, OPay, and virtual NUBANs. Includes customers, charges, payment methods, orchestrat...
Flutterwave Transfers API
Disburse funds globally across bank account transfers, mobile money transfers, and wallet-to-wallet transfers spanning 30+ African countries plus US/UK/EU/Asia corridors. Manage...
Flutterwave Settlements API
Reconcile transaction volume with merchant payouts. Manage settlements, refunds, chargebacks (dispute handling), and fee computation for cards, mobile money, and other rails. Th...
Flutterwave Wallets API
Inspect multi-currency wallet balances, retrieve wallet statements, and resolve mobile money wallet account details. Backs the FAAS (Finance as a Service) and capital flows for ...
Flutterwave Banks API
Reference data for banks, bank branches, and mobile networks supported by country, plus bank account name-enquiry endpoints. Used to populate checkout dropdowns and validate des...
Flutterwave Webhooks API
Outbound webhook callbacks delivered by Flutterwave for charges, transfers, refunds, chargebacks, and virtual account funding. Receivers validate the `verif-hash` header against...
Collections
Flutterwave Banks API
POSTMANFlutterwave Payments API
POSTMANFlutterwave Settlements API
POSTMANFlutterwave Transfers API
POSTMANFlutterwave Wallets API
POSTMANFlutterwave Webhooks API
POSTMANArazzo Workflows
Flutterwave Bank Directory Then Payout
Look up supported banks for a country, resolve the destination account, then create a recipient and send a payout.
ARAZZOFlutterwave Charge And Verify Status
Initiate a charge then poll the charge object to confirm its final settled status.
ARAZZOFlutterwave Charge Then Dispute Chargeback
Confirm a charge succeeded, raise a chargeback against it, and submit evidence to contest it.
ARAZZOFlutterwave Charge Then Refund
Verify a charge succeeded, then create a refund against it and confirm the refund status.
ARAZZOFlutterwave Create Recipient Transfer And Verify
Create a transfer recipient, send a payout to it, then verify the transfer reached a final status.
ARAZZOFlutterwave Cross-Border Rate-Locked Transfer
Lock an FX rate, create a sender and recipient, then send a transfer at the locked rate and verify it.
ARAZZOFlutterwave Direct Orchestrator Transfer And Verify
Initiate a one-call Orchestrator transfer with inline sender and recipient, then verify the payout status.
ARAZZOFlutterwave Mobile Money Payout
Resolve a mobile money wallet, create a mobile money recipient, then send and verify the payout.
ARAZZOFlutterwave Orchestrator Charge And Verify
Initiate a one-call Orchestrator charge then verify the resulting charge status.
ARAZZOFlutterwave Orchestrator Order And Verify
Initiate an order in one call with the Orchestrator helper, then retrieve it to confirm its status.
ARAZZOFlutterwave Order Checkout And Verify
Create a customer, place a server-side order for them, then retrieve the order to confirm its status.
ARAZZOFlutterwave Quote Fee Then Charge
Retrieve the processing fee for an amount, create the customer, then charge and verify it.
ARAZZOFlutterwave Resolve Account Then Payout
Resolve a destination bank account name, create a recipient for it, then send and verify a transfer.
ARAZZOFlutterwave Reuse Recipient Payout
Retrieve a saved recipient to confirm it exists, then send a transfer to it and verify the payout.
ARAZZOFlutterwave Settlement Reconciliation Refund
Retrieve a settlement, confirm a charge within it succeeded, then refund the charge and verify the refund.
ARAZZOFlutterwave Tokenized Recurring Charge
Tokenize a payment method, charge it for a customer, then verify the recurring charge status.
ARAZZOFlutterwave Transfer Verify And Retry
Send a transfer, verify its status, and retry it automatically when it failed.
ARAZZOFlutterwave Upsert Customer And Charge
Search for a customer by email, create one only if missing, then charge that customer and verify it.
ARAZZOFlutterwave Virtual Account Collection
Create a customer, issue a dedicated virtual account for them, then verify the account is active.
ARAZZOFlutterwave Wallet Balance Guarded Payout
Check a currency wallet balance, then only send a transfer to an existing recipient when funds are sufficient.
ARAZZOGraphQL
Flutterwave GraphQL Schema
This document describes a GraphQL schema representation of the Flutterwave Payments API. Flutterwave's native interface is REST-based; this schema is a conceptual mapping of cor...
GRAPHQL