Reference

Create Virtual Account

Generates a unique virtual account number for receiving direct bank transfers from customers, enabling you to track payments by individual buyer or project.

Create Bulk Virtual Account Numbers

Generate multiple virtual account numbers simultaneously to assign unique payment accounts to your customers for receiving payments.

Get Bulk Virtual Account

Retrieve details for multiple virtual accounts you've created in batch, including account numbers and account information for each generated account.

Get Virtual Account Number

Retrieve the virtual account details associated with a specific transaction or order, including account number and bank routing information needed for payment collection.

Get All Wallet Balances

Retrieve your current wallet balances across all supported currencies in one API call. This helps you track available funds and plan transactions without manually checking each currency account.

Get Balances per Currency

Retrieve your wallet balance for a specific currency to see how much money you have available and your ledger balance. Use this after completing transactions to verify your current funds.

Get Bank Branches

Retrieves branch codes for a specific bank, enabling accurate routing of transfers in countries that require branch-level information for transactions.

Get Banks by Country

Retrieves a complete list of banks operating in a specific country to enable accurate payment routing and transfer processing. Use this to ensure you're offering customers the correct banking options for their location.

Resolve Bank Account

Verify bank account ownership and retrieve the account holder's name by providing a Nigerian bank account number and bank code. This helps confirm that payment recipients are legitimate before processing transactions.

Create Beneficiary

Add a new recipient to your transfer list so you can send money to them quickly in the future. This streamlines your payment workflow by pre-registering accounts you frequently transfer to.

Delete Beneficiary

Remove a saved recipient from your transfer list when you no longer need to send them money, keeping your beneficiary database clean and current.

Fetch Beneficiary

Retrieve complete details of a specific beneficiary account using their ID, allowing you to verify recipient information before processing transfers or payments.

List All Beneficiaries

Retrieve all your saved transfer beneficiaries in one view, making it easy to manage who you regularly send money to.

Get Bill Categories

Retrieve all available bill payment categories supported by Flutterwave to display payment options to your customers or users.

List Biller Products

Retrieve all available products for a specific biller to display payment options to your customers. This helps you show the right bills and services customers can pay through your platform.

List Billers

Retrieves all available billers from Flutterwave so you can display bill payment options to your customers. This helps you build a complete bill payment experience within your platform.

List Recurring Bills

Retrieve all your scheduled and active recurring bill payments in one place to monitor your ongoing subscription commitments and billing arrangements.

Validate Bill Item

Verify that a customer's bill account number or identifier is valid and retrieve their details before processing a payment. This prevents payment failures and ensures you're charging the correct account.

Resolve Card BIN

Look up card issuer details, card type, and country information using a 6-digit card BIN to verify customer payment methods and assess transaction risk.

Create Bulk Tokenized Charge

Process multiple recurring charges across several customer cards in a single batch operation, ideal for managing subscription payments or recurring billing cycles efficiently.

Get Bulk Tokenized Charge Status

Check the processing status and results of a bulk tokenized charge operation you've initiated, helping you track whether customer payments were successfully collected. This is essential for monitoring automated recurring payments or bulk customer billing campaigns.

List Chargebacks

Retrieve and review all chargebacks associated with your Flutterwave account, with the ability to filter by specific transaction references to quickly locate disputed payments.

Create Payment Link

Generates a shareable payment URL that customers can use to complete transactions without needing to build a custom checkout experience. This is ideal for quickly collecting payments from clients through email, social media, or messaging platforms.

Disable Payment Link

Deactivate an active payment link to stop accepting new payments through it, useful when you need to retire a link after reaching a sales goal or switching to a new payment method.

List Payout Subaccounts

Retrieve all payout subaccounts linked to your Flutterwave account so you can manage and track where funds are being distributed.

Create Payment Plan

Set up recurring payment schedules for customers who prefer to pay in installments rather than upfront, making it easier to manage cash flow for both you and your clients.

Cancel Payment Plan

Stops a recurring payment plan and prevents all future charges from being processed under that plan. Use this when you need to halt a subscription or installment agreement immediately.

Get Payment Plan

Retrieve detailed information about a specific payment plan including its status, amount, and payment schedule from Flutterwave.

Get Payment Plans

Retrieves all your configured payment plans so you can view, manage, and present your billing options to customers.

Update Payment Plan

Modify the details of an existing payment plan, such as changing its name or updating its status to accommodate business needs or customer requests.

Create Refund

Initiate a refund for a completed transaction by specifying the transaction ID and refund amount. Use this when you need to return customer payments due to cancellations, returns, or billing errors.

Get Multiple Refund Transactions

Retrieve a list of refund transactions processed through your Flutterwave account, with filtering and pagination options to manage large volumes of refund data efficiently.

Get Refund

Retrieve the details and current status of a refund transaction using its ID, helping you track refund processing and verify completion with customers.

List Payout Subaccount Refunds

Retrieve a complete history of refunds issued to your payout subaccounts, helping you track money returned to your merchant partners or vendor accounts.

List all settlements

Retrieve all payment settlements from your Flutterwave account to view transaction payouts and track when funds were disbursed to your bank account. This helps you reconcile payments received from customers with actual deposits.

Get Wallet Statement

Retrieve your transaction history and balance changes from your Flutterwave wallet, with the ability to filter by specific time periods or criteria to analyze your payment activity.

Create Subaccount

Set up a separate account under your main Flutterwave account to automatically split and route payments to different team members, vendors, or business units. This is essential for managing multi-party transactions and automating fund distribution.

Delete Subaccount

Permanently removes a subaccount from your Flutterwave account when you no longer need it or want to consolidate your payment operations. This helps you clean up inactive accounts and streamline your payment setup.

Fetch Subaccount

Retrieve detailed information about a specific subaccount, including balance, verification status, and split settings. This helps you manage multiple business accounts or vendor payouts through a single integration.

List All Subaccounts

Retrieve all your collection subaccounts to view and manage payment recipients for split disbursements. This helps you track which accounts are set up to receive portions of customer payments.

Update Subaccount

Modify an existing subaccount's settings and business details, including split disbursement configurations for payment distribution.

Get All Subscriptions

Retrieves a complete list of all your subscriptions including active and cancelled ones, allowing you to view your full subscription history and status at any time.

Retrieve all transactions

Retrieve a complete list of all transactions from your Flutterwave account with optional filtering and pagination capabilities. This helps you access your full transaction history for analysis, reconciliation, and reporting purposes.

Verify Transaction by Reference

Confirms the status and retrieves full details of a payment transaction using its reference ID, helping you verify that customer payments have been successfully processed.

Generate Transaction Reference

Creates a unique transaction reference to safely initiate Flutterwave payments without risk of duplicate charges or processing errors.

Get Transaction

Retrieve detailed information about a specific transaction, including payment status, amount, and customer details. Use this to verify payment completion and access transaction records for accounting or customer service purposes.

Get Transaction Fee

Retrieves the fee amount for a specific transaction so you can see the exact cost before processing payment. This helps you understand the total charge and make informed decisions about whether to proceed with the transaction.

View Transaction Timeline

Retrieve the complete event timeline for a transaction to track all status changes and activities from creation through completion. This helps you understand exactly when and how a payment was processed.

List Transfers

Retrieve and view all bulk transfers from your Flutterwave account, including their statuses and details. Use this to track payment history, monitor transaction progress, and verify successful payouts to your team or vendors.

Get Transfer Fee

Calculate the exact fee charged for a transfer before you send money, helping you know the total cost upfront and avoid surprises.

Get Transfer Rates

Retrieve real-time exchange rates for converting between different currencies when sending international transfers. This helps you understand the exact conversion costs before committing to a cross-border payment.

Initiate Mobile Money Tanzania

Charge customers directly through Tanzania's mobile money networks by initiating a payment transaction after collecting their payment details. This enables you to accept payments from Tanzanian customers using their mobile money accounts without requiring traditional bank accounts.

Initiate BVN Verification

Starts the BVN verification process by requesting customer consent to access their Bank Verification Number, which redirects them to approve the identity verification request.