All integrations

Flutterwave

BUSINESS · COMMERCE & FINANCE

Charges, transfers, refunds, and payouts on the connected merchant account.

Acts as the person, not as itself

Each user connects their own account. Every call carries both identities — the agent and the person it is acting for — so the agent can never reach past what that individual can already do.

Credentials never touch the agent

Tokens live in the vault and attach server-side at call time. The agent holds a session, not a secret, and revoking access does not mean rotating a key.

Every call on the record

Who asked, which agent acted, which action ran, and the verdict that let it through — one audit trail across every integration, not one per vendor.

What an agent can do

Each action is granted on its own. An agent allowed to read is not thereby allowed to write, and the scope beside each row is what the acting user must have connected for it to run at all.

flutterwave_delete_beneficiaries_by_idWRITE

Delete a transfer beneficiary via DELETE /beneficiaries/{id}

api
flutterwave_delete_payout_subaccounts_by_account_referenceWRITE

This section describes how to delete a Payout Subaccount on Flutterwave. via DELETE /payout-subaccounts/{account_reference}

api
flutterwave_delete_subaccounts_by_idWRITE

This section describes how to delete a collection subaccount on Flutterwave. via DELETE /subaccounts/{id}

api
flutterwave_get_accounts_token_by_referenceREAD

Fetch the Bank Account Token. via GET /accounts/token/{reference}

api
flutterwave_get_balancesREAD

Query the balances for your wallet in all currencies. via GET /balances

api
flutterwave_get_balances_by_currencyREAD

Query your wallet balance for a specific currency. via GET /balances/{currency}

api
flutterwave_get_banks_by_countryREAD

Query all supported Banks in a specified country. via GET /banks/{country}

api
flutterwave_get_banks_by_id_branchesREAD

Query the branch code for a specific Bank. via GET /banks/{id}/branches

api
flutterwave_get_beneficiariesREAD

Get all beneficiaries via GET /beneficiaries

api
flutterwave_get_beneficiaries_by_idREAD

Get a single transfer beneficiary details via GET /beneficiaries/{id}

api
flutterwave_get_bill_items_by_item_code_validateREAD

This document shows you how to validate customer's details. Supported input include: meter number, smartcard number, internet account number, etc. via GET /bill-items/{item_code}/validate

api
flutterwave_get_billersREAD

Get all government agencies you can pay into via GET /billers

api
flutterwave_get_billers_by_biller_code_itemsREAD

This document shows you how to fetch all bill categories on your account via GET /billers/{biller_code}/items

api
flutterwave_get_billers_by_biller_code_productsREAD

Get all products under a government agency. via GET /billers/{biller_code}/products

api
flutterwave_get_billers_by_biller_code_products_by_product_codeREAD

Get the amount to be paid for a product via GET /billers/{biller_code}/products/{product_code}

api
flutterwave_get_bills_by_category_billersREAD

This document shows you how to fetch all bill categories on your account via GET /bills/{category}/billers

api
flutterwave_get_bills_by_referenceREAD

This document shows you how to get the status of a bill purchase via GET /bills/{reference}

api
flutterwave_get_bills_historyREAD

This document shows you how to retrieve a history of all purchased bill services including commission earned via GET /bills/history

api
flutterwave_get_bills_summaryREAD

This document shows you how to retrieve a history of all purchased bill services including commission earned via GET /bills/summary

api
flutterwave_get_bulk_ratesREAD

Verify bulk transfer rates via GET /bulk-rates

api
flutterwave_get_bulk_tokenized_charges_by_bulk_idREAD

Get status of bulk Tokenized Charges via GET /bulk-tokenized-charges/{bulk_id}

api
flutterwave_get_bulk_tokenized_charges_by_bulk_id_transactionsREAD

This endpoint allows you to get the status of a bulk tokenized charge via GET /bulk-tokenized-charges/{bulk_id}/transactions

api
flutterwave_get_bulk_virtual_account_numbers_by_batch_idREAD

Query virtual account information using the batch ID from the batch creation response. via GET /bulk-virtual-account-numbers/{batch_id}

api
flutterwave_get_bvn_verifications_by_referenceREAD

Verify a customer's consent and fetch their BVN information. via GET /bvn/verifications/{reference}

api
flutterwave_get_card_bins_by_binREAD

Retrieve the customer's card information using BINs. via GET /card-bins/{bin}

api
flutterwave_get_chargebacksREAD

This allows you to fetch all chargebacks on your account via GET /chargebacks

api
flutterwave_get_chargebacks_by_flw_refREAD

Fetch logs for a single chargeback. via GET /chargebacks?{flw_ref}=

api
flutterwave_get_payment_plansREAD

This section describes how to fetch all payment plans on your account. via GET /payment-plans

api
flutterwave_get_payment_plans_by_idREAD

This section describes how to get a single payment plan via GET /payment-plans/{id}

api
flutterwave_get_payout_subaccountsREAD

Fetch all Payout Sub Accounts on your Flutterwave Account via GET /payout-subaccounts

api
flutterwave_get_payout_subaccounts_by_account_referenceREAD

Fetch details for a wallet. via GET /payout-subaccounts/{account_reference}

api
flutterwave_get_payout_subaccounts_by_account_reference_balancesREAD

To fetch available balance on a payout subaccount. via GET /payout-subaccounts/{account_reference}/balances

api
flutterwave_get_payout_subaccounts_by_account_reference_static_accountREAD

Fetch the static virtual accounts for a payout subaccount via GET /payout-subaccounts/{account_reference}/static-account

api
flutterwave_get_payout_subaccounts_by_account_reference_transactionsREAD

Fetch transaction/balance history on a payout sub account via GET /payout-subaccounts/{account_reference}/transactions

api
flutterwave_get_payout_subaccounts_refundsREAD

Retrieve all wallet funding reversals and refunds. via GET /payout-subaccounts/refunds

api
flutterwave_get_refundsREAD

This endpoint allows developers to query previously initiated refunds. You can get information for multiple refunded transactions using the query filters. via GET /refunds

api
flutterwave_get_refunds_by_idREAD

This endpoint helps you query the details of a refunded transaction. it only supports querying one transaction per API call. via GET /refunds/{id}

api
flutterwave_get_rfq_by_idREAD

This endpoint allows you to fetch the status of your quote request. via GET /rfq/{id}

api
flutterwave_get_settlementsREAD

Query information for multiple settled transactions. via GET /settlements

api
flutterwave_get_settlements_by_idREAD

Query and retrieve information for a single settlement. via GET /settlements/{id}

api
flutterwave_get_subaccountsREAD

This section describes how to list all collection subaccounts on Flutterwave. via GET /subaccounts

api
flutterwave_get_subaccounts_by_idREAD

This section describes how to fetch a collection subaccount on Flutterwave. via GET /subaccounts/{id}

api
flutterwave_get_subscriptionsREAD

This endpoint allows the developers to query all subscribers (cancelled subscriber included). You can do a single or bulk query with the endpoint depending on your use case. via GET /subscriptions

api
flutterwave_get_top_bill_categoriesREAD

This document shows you how to query the supported bill categories by country via GET /top-bill-categories

api
flutterwave_get_trade_by_idREAD

This endpoint allows you to fetch the status of a trade request. via GET /trade/{id}

api
flutterwave_get_transactionsREAD

This endpoint allows developers to query previously initiated transactions. You can do a single or bulk query with the endpoint depending on your use case. via GET /transactions

api
flutterwave_get_transactions_by_id_eventsREAD

Review the timeline for a transaction from initiation to completion. via GET /transactions/{id}/events

api
flutterwave_get_transactions_by_id_verifyREAD

This endpoint helps developers to query the final status of a transaction. This can be used to check transactions of all payment types after they have been attempted. via GET /transactions/{id}/verify

api
flutterwave_get_transactions_feeREAD

This endpoint helps developers query the fees expected to be paid for a particular transaction. This endpoint only returns fees for collections i.e. inflows. via GET /transactions/fee

api
flutterwave_get_transactions_verify_by_referenceREAD

Verify transactions using the Merchant's transaction reference. via GET /transactions/verify_by_reference

api
flutterwave_get_transfersREAD

Fetch all transfers on your account via GET /transfers

api
flutterwave_get_transfers_batch_idREAD

Get the status of a bulk transfer on your account via GET /transfers?batch_id

api
flutterwave_get_transfers_by_idREAD

Fetch a single transfer on your account via GET /transfers/{id}

api
flutterwave_get_transfers_by_id_retriesREAD

Fetch transfer retry attempts for a single transfer on your account. via GET /transfers/{id}/retries

api
flutterwave_get_transfers_feeREAD

Get applicable transfer fee via GET /transfers/fee

api
flutterwave_get_transfers_ratesREAD

This endpoint helps you understand transfer rates when making international transfers via GET /transfers/rates

api
flutterwave_get_virtual_account_numbers_by_order_refREAD

Retrieve virtual account information using its order reference. via GET /virtual-account-numbers/{order_ref}

api
flutterwave_get_wallet_statementREAD

Fetch your wallet's transaction history for your system of records. via GET /wallet/statement

api
flutterwave_post_accounts_resolveWRITE

Resolve a bank account to get the account holder's details via POST /accounts/resolve

api
flutterwave_post_accounts_tokenizeWRITE

Generate a bank account token via E-mandate. via POST /accounts/tokenize

api
flutterwave_post_beneficiariesWRITE

Create a transfer beneficiary via POST /beneficiaries

api
flutterwave_post_billers_by_biller_code_items_by_item_code_paymentWRITE

This document shows you how to create bill payments via POST /billers/{biller_code}/items/{item_code}/payment

api
flutterwave_post_billers_by_biller_code_products_by_product_code_ordersWRITE

Create an order using the biller code and the product code via POST /billers/{biller_code}/products/{product_code}/orders

api
flutterwave_post_bulk_billsWRITE

This document shows you how to create bulk bills payment via POST /bulk-bills

api
flutterwave_post_bulk_ratesWRITE

Query bulk transfer rates via POST /bulk-rates

api
flutterwave_post_bulk_tokenized_chargesWRITE

Tokenize multiple cards at once. Please read our overview on bulk tokenizations before you continue. via POST /bulk-tokenized-charges

api
flutterwave_post_bulk_transfersWRITE

This document shows you how to initiate a bulk transfer via POST /bulk-transfers

api
flutterwave_post_bulk_virtual_account_numbersWRITE

Create Virtual Account Numbers in Bulk. via POST /bulk-virtual-account-numbers

api
flutterwave_post_bvn_verificationsWRITE

Request consent for BVN verification. via POST /bvn/verifications

api
flutterwave_post_charges_by_flw_ref_captureWRITE

Capture funds for initiated pre-authorization payments. via POST /charges/{flw_ref}/capture

api
flutterwave_post_charges_by_flw_ref_refundWRITE

Refund pre-authorization transactions. via POST /charges/{flw_ref}/refund

api
flutterwave_post_charges_by_flw_ref_voidWRITE

Release hold (lien) on pre-authorized transactions. via POST /charges/{flw_ref}/void

api
flutterwave_post_charges_type_account_ach_ukWRITE

Charge customers using their UK and European bank accounts. We recommend reading the [method overview](/v3.0.0/docs/uk-and-eu) before proceeding. via POST /charges?type=account-ach-uk

api
flutterwave_post_charges_type_ach_paymentWRITE

Collect ACH payments for USD and ZAR transactions. We recommend you read the [method overview](/v3.0.0/docs/ach-payment) before you proceed. via POST /charges?type=ach_payment

api
flutterwave_post_charges_type_bank_transferWRITE

Generate dynamic virtual accounts for instant payments via bank transfers. We recommend you read the method [overview](/v3.0.0/docs/bank-transfer-1) before you proceed. via POST /charges?type=bank_transfer

api
flutterwave_post_charges_type_capitecWRITE

Collect capitec payments with Flutterwave. we recommend you read the [overview](/v3.0.0/docs/south-africa-account-charge) before you proceed. via POST /charges?type=capitec

api
flutterwave_post_charges_type_cardWRITE

Collect card payments with Flutterwave. We recommend you read the method [overview](/v3.0.0/docs/direct-card-charge) before you proceed. via POST /charges?type=card

api
flutterwave_post_charges_type_enairaWRITE

Accept payment from eNaira wallets. We recommend you read the [method overview](/v3.0.0/docs/enaira-payment) before you proceed. via POST /charges?type=enaira

api
flutterwave_post_charges_type_fawry_payWRITE

Receive Fawry payments from customers in Egypt. Read the [overview](/v3.0.0/docs/fawry-pay) for this payment method before proceeding. via POST /charges?type=fawry_pay

api
flutterwave_post_charges_type_mobile_money_francoWRITE

Collect mobile money payments from customers in Francophone countries. This method supports payment from Cameroon, Cote d'Ivoire, Mali and Senegal. We recommend you read the [method overview](/v3.0.0/docs/francophone) before you proceed. via POST /charges?type=mobile_money_franco

api
flutterwave_post_charges_type_mobile_money_ghanaWRITE

Collect mobile money payments from customers in Ghana. We recommend you read the [method overview](/v3.0.0/docs/ghana) before you proceed. via POST /charges?type=mobile_money_ghana

api
flutterwave_post_charges_type_mobile_money_rwandaWRITE

Collect mobile money payments from customers in Rwanda. We recommend you read the [method overview](/v3.0.0/docs/rwanda) before you proceed. via POST /charges?type=mobile_money_rwanda

api
flutterwave_post_charges_type_mobile_money_tanzaniaWRITE

This document describes how to collect payments via Tanzania mobile money. via POST /charges?type=mobile_money_tanzania

api
flutterwave_post_charges_type_mobile_money_ugandaWRITE

Receive mobile money payments from customers in Uganda. We recommend you read the [method overview](/v3.0.0/docs/uganda) before you proceed. via POST /charges?type=mobile_money_uganda

api
flutterwave_post_charges_type_mobile_money_zambiaWRITE

This document describes how to collect payments via Zambia mobile money. via POST /charges?type=mobile_money_zambia

api
flutterwave_post_charges_type_monoWRITE

Charge Nigerian bank accounts using Flutterwave. We recommend you read the [method overview](/v3.0.0/docs/nigeria) before you proceed. via POST /charges?type=mono

api
flutterwave_post_charges_type_mpesaWRITE

Collect Mpesa payments from customers in Kenya. We recommend you read the [method overview](/v3.0.0/docs/m-pesa) before you proceed. via POST /charges?type=mpesa

api
flutterwave_post_charges_type_opayWRITE

Collect payments from OPay wallets. We cover this payment method in more details in the [method overview](/v3.0.0/docs/opay). via POST /charges?type=opay

api
flutterwave_post_charges_type_qrWRITE

Generate QR images for NQR payments. We recommend you read the [method overview](/v3.0.0/docs/nibss-qr) before you proceed. via POST /charges?type=qr

api
flutterwave_post_charges_type_ussdWRITE

Collect USSD payments from customers in Nigeria. We recommend you read the [method overview](/v3.0.0/docs/ussd) before you proceed. via POST /charges?type=ussd

api
flutterwave_post_charges_type_voucher_paymentWRITE

Charge South African customers via 1Voucher. We recommend you read the [method overview](/v3.0.0/docs/1voucher) before you proceed. via POST /charges?type=voucher_payment

api
flutterwave_post_otpsWRITE

Create OTP strings of varying lengths. via POST /otps

api
flutterwave_post_otps_by_reference_validateWRITE

Validate an OTP. via POST /otps/{reference}/validate

api
flutterwave_post_payment_plansWRITE

Create a payment plan for your customers. via POST /payment-plans

api
flutterwave_post_paymentsWRITE

Generate Flutterwave checkout to receive payments from customers. Learn more about our [checkout](/v3.0.0/docs/flutterwave-standard-1) via POST /payments

api
flutterwave_post_payout_subaccountsWRITE

This document shows you how to create a payout/transfer subaccount on Flutterwave. via POST /payout-subaccounts

api
flutterwave_post_payout_subaccounts_refundsWRITE

Make wallet funding reversals via POST /payout-subaccounts/refunds

api
flutterwave_post_rfqWRITE

This page shows you how to create a request for quote. via POST /rfq

api
flutterwave_post_subaccountsWRITE

This document shows you how to create a subaccount on Flutterwave via POST /subaccounts

api
flutterwave_post_tokenized_chargesWRITE

Create a tokenized charge with a card or bank account token. We recommend that you read our [overview](/v3.0.0/docs/tokenization) before you proceed with your integration. via POST /tokenized-charges

api
flutterwave_post_tradesWRITE

This endpoint is used to initiate trade using created quotes. via POST /trades

api
flutterwave_post_transactions_by_id_refundWRITE

This endpoint allows you to create a refund for any transaction that is being disputed. Kindly note that refunds initiated usually take between 3-15 working days to be completed. via POST /transactions/{id}/refund

api
flutterwave_post_transactions_by_id_resend_hookWRITE

This endpoint helps you resend webhooks from failed sending queues to your server. via POST /transactions/{id}/resend-hook

api
flutterwave_post_transfersWRITE

This will show you how to initiate a transfer via POST /transfers

api
flutterwave_post_transfers_by_id_retriesWRITE

This helps you retry a previously failed transfer. via POST /transfers/{id}/retries

api
flutterwave_post_upload_imageWRITE

Submit evidence to dispute chargebacks. via POST /upload_image

api
flutterwave_post_validate_chargeWRITE

Validate a pending transaction using an OTP. via POST /validate-charge

api
flutterwave_post_virtual_account_numbersWRITE

Create a Virtual Account for Your Customer. via POST /virtual-account-numbers

api
flutterwave_post_virtual_account_numbers_by_order_refWRITE

This section explains how to deactivate and reactivate `static virtual accounts`. Reactivation is only supported for NGN virtual accounts generated by Flutterwave MFB. via POST /virtual-account-numbers/{order_ref}

api
flutterwave_put_accounts_token_by_referenceWRITE

Update the status of a customer's account token. via PUT /accounts/token/{reference}

api
flutterwave_put_chargebacks_by_idWRITE

Action chargebacks raised against your account. via PUT /chargebacks/{id}

api
flutterwave_put_payment_plans_by_idWRITE

This endpoint help the merchant/developer update an existing payment plan. via PUT /payment-plans/{id}

api
flutterwave_put_payment_plans_by_id_cancelWRITE

This endpoint help the merchant/developer cancel an existing payment plan. via PUT /payment-plans/{id}/cancel

api
flutterwave_put_payout_subaccounts_by_account_referenceWRITE

Update a customer's wallet details. via PUT /payout-subaccounts/{account_reference}

api
flutterwave_put_product_orders_by_referenceWRITE

Create an order using the biller code and the product Id via PUT /product-orders/{reference}

api
flutterwave_put_subaccounts_by_idWRITE

This section describes how to update a collection subaccount on Flutterwave. via PUT /subaccounts/{id}

api
flutterwave_put_subscriptions_by_id_activateWRITE

This section describes how to activate a previously cancelled subscription. via PUT /subscriptions/{id}/activate

api
flutterwave_put_subscriptions_by_id_cancelWRITE

This section describes how to deactivate an active subscription. via PUT /subscriptions/{id}/cancel

api
flutterwave_put_tokens_by_tokenWRITE

This endpoints allow developers update the details tied to a customer's card token. via PUT /tokens/{token}

api
flutterwave_put_virtual_account_numbers_by_order_refWRITE

Update the BVN of existing virtual accounts. via PUT /virtual-account-numbers/{order_ref}

api

Put Flutterwave behind one governed endpoint.

Same permissions, same audit trail, whatever else you connect next.