# Flutterwave Flutterwave is a payments technology company that provides payment infrastructure and APIs enabling businesses to accept and send payments in Africa and globally. - **Category:** payment processing - **Auth:** API_KEY - **Composio Managed App Available?** N/A - **Tools:** 53 - **Triggers:** 0 - **Slug:** `FLUTTERWAVE` - **Version:** 20260410_00 ## Tools ### Cancel Payment Plan **Slug:** `FLUTTERWAVE_CANCEL_PAYMENT_PLAN` Tool to cancel a payment plan. Use when you need to prevent all future subscriptions under this plan. ### Create Beneficiary **Slug:** `FLUTTERWAVE_CREATE_BENEFICIARY` Tool to create a new transfer beneficiary. Use when you need to add a beneficiary before making a transfer. ### Create Bulk Tokenized Charge **Slug:** `FLUTTERWAVE_CREATE_BULK_TOKENIZED_CHARGE` Tool to create a bulk tokenized charge batch for charging multiple previously tokenized cards. Use when you need to process multiple recurring or subscription charges in a single batch. Each charge must reference a valid card token obtained from prior tokenization. ### Create Bulk Virtual Account Numbers **Slug:** `FLUTTERWAVE_CREATE_BULK_VIRTUAL_ACCOUNT_NUMBERS` Tool to create multiple virtual account numbers. Use when you need to generate multiple static virtual accounts for customers in a single request. ### Create Payment Link **Slug:** `FLUTTERWAVE_CREATE_PAYMENT_LINK` Tool to create a hosted payment link. Use when you need a shareable payment URL for one-time transactions. ### Create Payment Plan **Slug:** `FLUTTERWAVE_CREATE_PAYMENT_PLAN` Tool to create a new payment plan. Use after confirming plan and customer details. ### Create Refund **Slug:** `FLUTTERWAVE_CREATE_REFUND` Tool to create a refund for a transaction. Use when you need to initiate a refund after confirming the transaction ID and refund amount. ### Create Subaccount **Slug:** `FLUTTERWAVE_CREATE_SUBACCOUNT` Tool to create a new subaccount. Use when you need to configure split disbursement accounts. ### Create Virtual Account **Slug:** `FLUTTERWAVE_CREATE_VIRTUAL_ACCOUNT` Tool to create a new virtual account number. Use after confirming customer details when assigning a unique account for bank transfers. ### Delete Beneficiary **Slug:** `FLUTTERWAVE_DELETE_BENEFICIARY` Tool to delete a beneficiary by ID. Use when you need to remove a saved transfer beneficiary by its unique ID after confirming the ID. ### Delete Subaccount **Slug:** `FLUTTERWAVE_DELETE_SUBACCOUNT` Tool to delete a subaccount by ID. Use when you need to remove a subaccount from your Flutterwave account. ### Disable Payment Link **Slug:** `FLUTTERWAVE_DISABLE_PAYMENT_LINK` Tool to disable a Flutterwave payment link. Use when you need to prevent further payments from an existing link after confirming the link is valid. ### Fetch Beneficiary **Slug:** `FLUTTERWAVE_FETCH_BENEFICIARY` Tool to retrieve details of a specific beneficiary by ID. Use after obtaining a beneficiary ID to fetch its full details from Flutterwave. ### Fetch Subaccount **Slug:** `FLUTTERWAVE_FETCH_SUBACCOUNT` Tool to retrieve details of a specific subaccount by ID. Use when you need full subaccount info after creating or updating splits. ### Generate Transaction Reference **Slug:** `FLUTTERWAVE_GENERATE_TRANSACTION_REFERENCE` Tool to generate a unique transaction reference. Use when initiating a new Flutterwave transaction requires a unique reference to prevent duplication. ### Get All Subscriptions **Slug:** `FLUTTERWAVE_GET_ALL_SUBSCRIPTIONS` Tool to retrieve all subscriptions, including cancelled ones. Use when you need a comprehensive list of subscription records for auditing or reporting. ### Retrieve all transactions **Slug:** `FLUTTERWAVE_GET_ALL_TRANSACTIONS` Tool to retrieve a list of all transactions with optional filters. Use when you need to paginate or filter transaction history after confirming valid API credentials. ### Get All Wallet Balances **Slug:** `FLUTTERWAVE_GET_ALL_WALLET_BALANCES` Tool to retrieve all wallet balances across currencies. Use when reconciling balances after authentication. ### Get Balances per Currency **Slug:** `FLUTTERWAVE_GET_BALANCES_PER_CURRENCY` Tool to retrieve wallet balance for a specific currency. Use after transactions to confirm available and ledger balances in a given currency. ### Get Bank Branches **Slug:** `FLUTTERWAVE_GET_BANK_BRANCHES` Tool to retrieve branch codes for a specific bank. Use when you need branch information for transfers in countries like Ghana that require branch codes. ### Get Banks by Country **Slug:** `FLUTTERWAVE_GET_BANKS_BY_COUNTRY` Tool to retrieve all banks in a specified country. Use when you need to get available banks for transfers or payments in a specific country. ### Get Bill Categories **Slug:** `FLUTTERWAVE_GET_BILL_CATEGORIES` Tool to retrieve available bill categories. Use after authenticating to Flutterwave to display bill payment options to users. ### Get Bulk Tokenized Charge Status **Slug:** `FLUTTERWAVE_GET_BULK_TOKENIZED_CHARGE` Tool to retrieve the status of a bulk tokenized charge operation by ID. Use after initiating a bulk tokenized charge to check its processing status. ### Get Bulk Virtual Account **Slug:** `FLUTTERWAVE_GET_BULK_VIRTUAL_ACCOUNT` Tool to fetch bulk virtual account details using batch ID. Use this after creating bulk virtual accounts to retrieve the generated account numbers and their details. ### Get Multiple Refund Transactions **Slug:** `FLUTTERWAVE_GET_MULTIPLE_REFUND_TRANSACTIONS` Tool to retrieve multiple refund transactions with optional filters. Use when you need to fetch paginated refund data after confirming valid API credentials. ### Get Payment Plan **Slug:** `FLUTTERWAVE_GET_PAYMENT_PLAN` Tool to retrieve details of a specific payment plan by ID. Use after obtaining the payment plan ID to fetch its details from Flutterwave. ### Get Payment Plans **Slug:** `FLUTTERWAVE_GET_PAYMENT_PLANS` Tool to retrieve a list of all payment plans. Use when you need to fetch and present your account’s configured billing plans. ### Get Refund **Slug:** `FLUTTERWAVE_GET_REFUND` Tool to retrieve details of a specific refund by ID. Use after obtaining the refund ID to fetch its details from Flutterwave. ### Get Transaction **Slug:** `FLUTTERWAVE_GET_TRANSACTION` Tool to retrieve details of a specific transaction by ID. Use after obtaining the transaction ID to fetch its details from Flutterwave. ### Get Transaction Fee **Slug:** `FLUTTERWAVE_GET_TRANSACTION_FEE` Tool to retrieve the fee for a specific transaction. Use when you need to calculate the total charge including fees before initiating the transaction. ### Get Transfer Fee **Slug:** `FLUTTERWAVE_GET_TRANSFER_FEE` Tool to retrieve the fee for initiating a transfer. Use when you need to estimate transfer costs before creating a transfer. Example: "Calculate the fee for transferring NGN 5000 to an account." ### Get Transfer Rates **Slug:** `FLUTTERWAVE_GET_TRANSFER_RATES` Tool to retrieve exchange rates for transfers between currencies. Use when you need to calculate conversion rates before initiating a cross-currency transfer. ### Get Virtual Account Number **Slug:** `FLUTTERWAVE_GET_VIRTUAL_ACCOUNT_NUMBER` Tool to fetch details of a virtual account number by order reference. Use when you need to retrieve account details after creation. ### Get Wallet Statement **Slug:** `FLUTTERWAVE_GET_WALLET_STATEMENT` Tool to retrieve wallet balance history with optional filters. Use when you need to view transaction history and balance changes over a period. ### Initiate BVN Verification **Slug:** `FLUTTERWAVE_INITIATE_BVN_VERIFICATION` Tool to initiate BVN verification consent. Use when you need to verify a customer's Bank Verification Number (BVN) by obtaining their consent first. The customer will be redirected to a consent page where they provide approval to access their BVN data. ### Initiate Mobile Money Tanzania **Slug:** `FLUTTERWAVE_INITIATE_MOBILE_MONEY_TANZANIA` Tool to initiate a mobile money payment in Tanzania. Use after collecting customer details to charge via Tanzanian mobile money networks. ### List All Beneficiaries **Slug:** `FLUTTERWAVE_LIST_ALL_BENEFICIARIES` Tool to list all saved beneficiaries. Use when you need to retrieve all transfer beneficiaries associated with your account. ### List Biller Products **Slug:** `FLUTTERWAVE_LIST_BILLER_PRODUCTS` Tool to retrieve all products available under a specific biller. Use after getting bill categories to display available products for bill payment. ### List Billers **Slug:** `FLUTTERWAVE_LIST_BILLERS` Tool to retrieve available billers. Use after authenticating to Flutterwave to display bill payment biller options to users. ### List Chargebacks **Slug:** `FLUTTERWAVE_LIST_CHARGEBACKS` Tool to retrieve a list of chargebacks with optional filtering by Flutterwave reference. Use when you need to view all chargebacks or search for a specific chargeback by transaction reference. ### List Payout Subaccount Refunds **Slug:** `FLUTTERWAVE_LIST_PAYOUT_SUBACCOUNT_REFUNDS` Tool to list all payout subaccount refunds with pagination support. Use when you need to retrieve payout subaccount refund history with optional page filtering. ### List Payout Subaccounts **Slug:** `FLUTTERWAVE_LIST_PAYOUT_SUBACCOUNTS` Tool to list all payout subaccounts. Use when you need to retrieve all payout subaccounts associated with your Flutterwave account. ### List Recurring Bills **Slug:** `FLUTTERWAVE_LIST_RECURRING_BILLS` Tool to retrieve all recurring bill payments. Use when you need to view scheduled or active recurring billing arrangements. ### List all settlements **Slug:** `FLUTTERWAVE_LIST_SETTLEMENTS` Tool to retrieve all settlements with optional filters. Use when you need to fetch settlement records, view transaction settlements, or track payment disbursements. ### List All Subaccounts **Slug:** `FLUTTERWAVE_LIST_SUBACCOUNTS` Tool to fetch all collection subaccounts. Use when you need to retrieve the complete list of subaccounts for split disbursements. ### List Transfers **Slug:** `FLUTTERWAVE_LIST_TRANSFERS` Tool to fetch a list of bulk transfers from your Flutterwave account. Use when you need to retrieve transfer history, check transfer statuses, or filter transfers by reference or status. ### Resolve Bank Account **Slug:** `FLUTTERWAVE_RESOLVE_BANK_ACCOUNT` Tool to verify and resolve bank account details. Use when you need to retrieve the account holder name for a Nigerian bank account by providing the account number and bank code. ### Resolve Card BIN **Slug:** `FLUTTERWAVE_RESOLVE_CARD_BIN` Tool to resolve and retrieve card BIN information from Flutterwave. Use when you need to get issuer details, card type, and country information for a 6-digit BIN. ### Update Payment Plan **Slug:** `FLUTTERWAVE_UPDATE_PAYMENT_PLAN` Tool to update an existing payment plan. Use when you need to modify a payment plan's name or status. ### Update Subaccount **Slug:** `FLUTTERWAVE_UPDATE_SUBACCOUNT` Tool to update an existing subaccount. Use when you need to modify split disbursement settings or business details. ### Validate Bill Item **Slug:** `FLUTTERWAVE_VALIDATE_BILL_ITEM` Tool to validate a bill service before payment. Use before initiating a bill payment to confirm the customer identifier (account number, meter number, etc.) is valid and retrieve customer details. ### Verify Transaction by Reference **Slug:** `FLUTTERWAVE_VERIFY_TRANSACTION_BY_REFERENCE` Tool to verify a transaction using its transaction reference. Use when you have a transaction reference (tx_ref) and need to confirm the transaction status and retrieve its details. ### View Transaction Timeline **Slug:** `FLUTTERWAVE_VIEW_TRANSACTION_TIMELINE` Tool to retrieve the event timeline for a transaction. Use after obtaining the transaction ID to audit or track the sequence of events.