BUSINESS · COMMERCE & FINANCE
Charges, transfers, refunds, and payouts on the connected merchant account.
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.
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.
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.
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_idWRITEDelete a transfer beneficiary via DELETE /beneficiaries/{id}
flutterwave_delete_payout_subaccounts_by_account_referenceWRITEThis section describes how to delete a Payout Subaccount on Flutterwave. via DELETE /payout-subaccounts/{account_reference}
flutterwave_delete_subaccounts_by_idWRITEThis section describes how to delete a collection subaccount on Flutterwave. via DELETE /subaccounts/{id}
flutterwave_get_accounts_token_by_referenceREADFetch the Bank Account Token. via GET /accounts/token/{reference}
flutterwave_get_balancesREADQuery the balances for your wallet in all currencies. via GET /balances
flutterwave_get_balances_by_currencyREADQuery your wallet balance for a specific currency. via GET /balances/{currency}
flutterwave_get_banks_by_countryREADQuery all supported Banks in a specified country. via GET /banks/{country}
flutterwave_get_banks_by_id_branchesREADQuery the branch code for a specific Bank. via GET /banks/{id}/branches
flutterwave_get_beneficiariesREADGet all beneficiaries via GET /beneficiaries
flutterwave_get_beneficiaries_by_idREADGet a single transfer beneficiary details via GET /beneficiaries/{id}
flutterwave_get_bill_items_by_item_code_validateREADThis 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
flutterwave_get_billersREADGet all government agencies you can pay into via GET /billers
flutterwave_get_billers_by_biller_code_itemsREADThis document shows you how to fetch all bill categories on your account via GET /billers/{biller_code}/items
flutterwave_get_billers_by_biller_code_productsREADGet all products under a government agency. via GET /billers/{biller_code}/products
flutterwave_get_billers_by_biller_code_products_by_product_codeREADGet the amount to be paid for a product via GET /billers/{biller_code}/products/{product_code}
flutterwave_get_bills_by_category_billersREADThis document shows you how to fetch all bill categories on your account via GET /bills/{category}/billers
flutterwave_get_bills_by_referenceREADThis document shows you how to get the status of a bill purchase via GET /bills/{reference}
flutterwave_get_bills_historyREADThis document shows you how to retrieve a history of all purchased bill services including commission earned via GET /bills/history
flutterwave_get_bills_summaryREADThis document shows you how to retrieve a history of all purchased bill services including commission earned via GET /bills/summary
flutterwave_get_bulk_ratesREADVerify bulk transfer rates via GET /bulk-rates
flutterwave_get_bulk_tokenized_charges_by_bulk_idREADGet status of bulk Tokenized Charges via GET /bulk-tokenized-charges/{bulk_id}
flutterwave_get_bulk_tokenized_charges_by_bulk_id_transactionsREADThis endpoint allows you to get the status of a bulk tokenized charge via GET /bulk-tokenized-charges/{bulk_id}/transactions
flutterwave_get_bulk_virtual_account_numbers_by_batch_idREADQuery virtual account information using the batch ID from the batch creation response. via GET /bulk-virtual-account-numbers/{batch_id}
flutterwave_get_bvn_verifications_by_referenceREADVerify a customer's consent and fetch their BVN information. via GET /bvn/verifications/{reference}
flutterwave_get_card_bins_by_binREADRetrieve the customer's card information using BINs. via GET /card-bins/{bin}
flutterwave_get_chargebacksREADThis allows you to fetch all chargebacks on your account via GET /chargebacks
flutterwave_get_chargebacks_by_flw_refREADFetch logs for a single chargeback. via GET /chargebacks?{flw_ref}=
flutterwave_get_payment_plansREADThis section describes how to fetch all payment plans on your account. via GET /payment-plans
flutterwave_get_payment_plans_by_idREADThis section describes how to get a single payment plan via GET /payment-plans/{id}
flutterwave_get_payout_subaccountsREADFetch all Payout Sub Accounts on your Flutterwave Account via GET /payout-subaccounts
flutterwave_get_payout_subaccounts_by_account_referenceREADFetch details for a wallet. via GET /payout-subaccounts/{account_reference}
flutterwave_get_payout_subaccounts_by_account_reference_balancesREADTo fetch available balance on a payout subaccount. via GET /payout-subaccounts/{account_reference}/balances
flutterwave_get_payout_subaccounts_by_account_reference_static_accountREADFetch the static virtual accounts for a payout subaccount via GET /payout-subaccounts/{account_reference}/static-account
flutterwave_get_payout_subaccounts_by_account_reference_transactionsREADFetch transaction/balance history on a payout sub account via GET /payout-subaccounts/{account_reference}/transactions
flutterwave_get_payout_subaccounts_refundsREADRetrieve all wallet funding reversals and refunds. via GET /payout-subaccounts/refunds
flutterwave_get_refundsREADThis endpoint allows developers to query previously initiated refunds. You can get information for multiple refunded transactions using the query filters. via GET /refunds
flutterwave_get_refunds_by_idREADThis endpoint helps you query the details of a refunded transaction. it only supports querying one transaction per API call. via GET /refunds/{id}
flutterwave_get_rfq_by_idREADThis endpoint allows you to fetch the status of your quote request. via GET /rfq/{id}
flutterwave_get_settlementsREADQuery information for multiple settled transactions. via GET /settlements
flutterwave_get_settlements_by_idREADQuery and retrieve information for a single settlement. via GET /settlements/{id}
flutterwave_get_subaccountsREADThis section describes how to list all collection subaccounts on Flutterwave. via GET /subaccounts
flutterwave_get_subaccounts_by_idREADThis section describes how to fetch a collection subaccount on Flutterwave. via GET /subaccounts/{id}
flutterwave_get_subscriptionsREADThis 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
flutterwave_get_top_bill_categoriesREADThis document shows you how to query the supported bill categories by country via GET /top-bill-categories
flutterwave_get_trade_by_idREADThis endpoint allows you to fetch the status of a trade request. via GET /trade/{id}
flutterwave_get_transactionsREADThis 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
flutterwave_get_transactions_by_id_eventsREADReview the timeline for a transaction from initiation to completion. via GET /transactions/{id}/events
flutterwave_get_transactions_by_id_verifyREADThis 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
flutterwave_get_transactions_feeREADThis 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
flutterwave_get_transactions_verify_by_referenceREADVerify transactions using the Merchant's transaction reference. via GET /transactions/verify_by_reference
flutterwave_get_transfersREADFetch all transfers on your account via GET /transfers
flutterwave_get_transfers_batch_idREADGet the status of a bulk transfer on your account via GET /transfers?batch_id
flutterwave_get_transfers_by_idREADFetch a single transfer on your account via GET /transfers/{id}
flutterwave_get_transfers_by_id_retriesREADFetch transfer retry attempts for a single transfer on your account. via GET /transfers/{id}/retries
flutterwave_get_transfers_feeREADGet applicable transfer fee via GET /transfers/fee
flutterwave_get_transfers_ratesREADThis endpoint helps you understand transfer rates when making international transfers via GET /transfers/rates
flutterwave_get_virtual_account_numbers_by_order_refREADRetrieve virtual account information using its order reference. via GET /virtual-account-numbers/{order_ref}
flutterwave_get_wallet_statementREADFetch your wallet's transaction history for your system of records. via GET /wallet/statement
flutterwave_post_accounts_resolveWRITEResolve a bank account to get the account holder's details via POST /accounts/resolve
flutterwave_post_accounts_tokenizeWRITEGenerate a bank account token via E-mandate. via POST /accounts/tokenize
flutterwave_post_beneficiariesWRITECreate a transfer beneficiary via POST /beneficiaries
flutterwave_post_billers_by_biller_code_items_by_item_code_paymentWRITEThis document shows you how to create bill payments via POST /billers/{biller_code}/items/{item_code}/payment
flutterwave_post_billers_by_biller_code_products_by_product_code_ordersWRITECreate an order using the biller code and the product code via POST /billers/{biller_code}/products/{product_code}/orders
flutterwave_post_bulk_billsWRITEThis document shows you how to create bulk bills payment via POST /bulk-bills
flutterwave_post_bulk_ratesWRITEQuery bulk transfer rates via POST /bulk-rates
flutterwave_post_bulk_tokenized_chargesWRITETokenize multiple cards at once. Please read our overview on bulk tokenizations before you continue. via POST /bulk-tokenized-charges
flutterwave_post_bulk_transfersWRITEThis document shows you how to initiate a bulk transfer via POST /bulk-transfers
flutterwave_post_bulk_virtual_account_numbersWRITECreate Virtual Account Numbers in Bulk. via POST /bulk-virtual-account-numbers
flutterwave_post_bvn_verificationsWRITERequest consent for BVN verification. via POST /bvn/verifications
flutterwave_post_charges_by_flw_ref_captureWRITECapture funds for initiated pre-authorization payments. via POST /charges/{flw_ref}/capture
flutterwave_post_charges_by_flw_ref_refundWRITERefund pre-authorization transactions. via POST /charges/{flw_ref}/refund
flutterwave_post_charges_by_flw_ref_voidWRITERelease hold (lien) on pre-authorized transactions. via POST /charges/{flw_ref}/void
flutterwave_post_charges_type_account_ach_ukWRITECharge 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
flutterwave_post_charges_type_ach_paymentWRITECollect 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
flutterwave_post_charges_type_bank_transferWRITEGenerate 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
flutterwave_post_charges_type_capitecWRITECollect 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
flutterwave_post_charges_type_cardWRITECollect 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
flutterwave_post_charges_type_enairaWRITEAccept 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
flutterwave_post_charges_type_fawry_payWRITEReceive 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
flutterwave_post_charges_type_mobile_money_francoWRITECollect 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
flutterwave_post_charges_type_mobile_money_ghanaWRITECollect 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
flutterwave_post_charges_type_mobile_money_rwandaWRITECollect 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
flutterwave_post_charges_type_mobile_money_tanzaniaWRITEThis document describes how to collect payments via Tanzania mobile money. via POST /charges?type=mobile_money_tanzania
flutterwave_post_charges_type_mobile_money_ugandaWRITEReceive 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
flutterwave_post_charges_type_mobile_money_zambiaWRITEThis document describes how to collect payments via Zambia mobile money. via POST /charges?type=mobile_money_zambia
flutterwave_post_charges_type_monoWRITECharge 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
flutterwave_post_charges_type_mpesaWRITECollect 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
flutterwave_post_charges_type_opayWRITECollect 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
flutterwave_post_charges_type_qrWRITEGenerate 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
flutterwave_post_charges_type_ussdWRITECollect 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
flutterwave_post_charges_type_voucher_paymentWRITECharge 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
flutterwave_post_otpsWRITECreate OTP strings of varying lengths. via POST /otps
flutterwave_post_otps_by_reference_validateWRITEValidate an OTP. via POST /otps/{reference}/validate
flutterwave_post_payment_plansWRITECreate a payment plan for your customers. via POST /payment-plans
flutterwave_post_paymentsWRITEGenerate Flutterwave checkout to receive payments from customers. Learn more about our [checkout](/v3.0.0/docs/flutterwave-standard-1) via POST /payments
flutterwave_post_payout_subaccountsWRITEThis document shows you how to create a payout/transfer subaccount on Flutterwave. via POST /payout-subaccounts
flutterwave_post_payout_subaccounts_refundsWRITEMake wallet funding reversals via POST /payout-subaccounts/refunds
flutterwave_post_rfqWRITEThis page shows you how to create a request for quote. via POST /rfq
flutterwave_post_subaccountsWRITEThis document shows you how to create a subaccount on Flutterwave via POST /subaccounts
flutterwave_post_tokenized_chargesWRITECreate 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
flutterwave_post_tradesWRITEThis endpoint is used to initiate trade using created quotes. via POST /trades
flutterwave_post_transactions_by_id_refundWRITEThis 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
flutterwave_post_transactions_by_id_resend_hookWRITEThis endpoint helps you resend webhooks from failed sending queues to your server. via POST /transactions/{id}/resend-hook
flutterwave_post_transfersWRITEThis will show you how to initiate a transfer via POST /transfers
flutterwave_post_transfers_by_id_retriesWRITEThis helps you retry a previously failed transfer. via POST /transfers/{id}/retries
flutterwave_post_upload_imageWRITESubmit evidence to dispute chargebacks. via POST /upload_image
flutterwave_post_validate_chargeWRITEValidate a pending transaction using an OTP. via POST /validate-charge
flutterwave_post_virtual_account_numbersWRITECreate a Virtual Account for Your Customer. via POST /virtual-account-numbers
flutterwave_post_virtual_account_numbers_by_order_refWRITEThis 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}
flutterwave_put_accounts_token_by_referenceWRITEUpdate the status of a customer's account token. via PUT /accounts/token/{reference}
flutterwave_put_chargebacks_by_idWRITEAction chargebacks raised against your account. via PUT /chargebacks/{id}
flutterwave_put_payment_plans_by_idWRITEThis endpoint help the merchant/developer update an existing payment plan. via PUT /payment-plans/{id}
flutterwave_put_payment_plans_by_id_cancelWRITEThis endpoint help the merchant/developer cancel an existing payment plan. via PUT /payment-plans/{id}/cancel
flutterwave_put_payout_subaccounts_by_account_referenceWRITEUpdate a customer's wallet details. via PUT /payout-subaccounts/{account_reference}
flutterwave_put_product_orders_by_referenceWRITECreate an order using the biller code and the product Id via PUT /product-orders/{reference}
flutterwave_put_subaccounts_by_idWRITEThis section describes how to update a collection subaccount on Flutterwave. via PUT /subaccounts/{id}
flutterwave_put_subscriptions_by_id_activateWRITEThis section describes how to activate a previously cancelled subscription. via PUT /subscriptions/{id}/activate
flutterwave_put_subscriptions_by_id_cancelWRITEThis section describes how to deactivate an active subscription. via PUT /subscriptions/{id}/cancel
flutterwave_put_tokens_by_tokenWRITEThis endpoints allow developers update the details tied to a customer's card token. via PUT /tokens/{token}
flutterwave_put_virtual_account_numbers_by_order_refWRITEUpdate the BVN of existing virtual accounts. via PUT /virtual-account-numbers/{order_ref}
Put Flutterwave behind one governed endpoint.
Same permissions, same audit trail, whatever else you connect next.