list_transactions
Retrieve a list of payment transactions from your Flutterwave account. Supports filtering by date range, status, currency, customer email, and payment type. Returns paginated results with transaction details including amounts, status, and customer information.
manage_payment_plans
Create, list, retrieve, update, or cancel payment plans for recurring billing. Payment plans define subscription parameters (amount, interval, duration). When you charge a customer with a plan, they are automatically subscribed for future billing cycles.
pay_bill
Pay bills including Airtime, Data bundles, Cable TV (DSTV, GOtv), Power/Electricity, Tolls, and more. Requires the biller code, item code, and customer identifier. Use the "List Bill Categories" tool first to find valid biller and item codes.
manage_subscriptions
List, cancel, or reactivate customer subscriptions. Subscriptions are created automatically when a customer is charged with a payment plan. Filter subscriptions by customer email, plan ID, or status.
create_refund
Initiate a full or partial refund for a completed transaction. Provide the transaction ID and optionally an amount for partial refunds. If no amount is specified, a full refund is processed.
list_settlements
Retrieve settlement records showing how collected funds were settled to your bank account. Filter by date range or get details for a specific settlement. Includes gross amount, fees, refunds, chargebacks, and net amount.
create_virtual_account
Generate a virtual bank account number for receiving payments via bank transfer. Supports dynamic (temporary, single-use) and static (permanent) accounts. Currently available for NGN and GHS.
list_transfers
Retrieve a list of payout transfers from your Flutterwave account. Supports filtering by date range and status. Can also fetch details for a specific transfer by ID, or check transfer fees and exchange rates for cross-currency transfers.
create_transfer
Initiate a payout/transfer to a bank account or mobile money wallet. Supports multiple currencies (NGN, USD, EUR, GHS, KES, etc.) and cross-currency transfers. You can optionally check transfer fees and exchange rates before sending.
resolve_bank_account
Look up and verify bank account details by account number and bank code. Returns the account holder's name for identity verification. Can also list banks for a given country to find the correct bank code.
get_transfer_rate
Check exchange rates and fees for cross-currency transfers. Returns the conversion rate and the amount that will be debited from your source currency balance. Use this before initiating a cross-currency transfer to understand costs.
list_refunds
Retrieve a list of refunds or get details for a specific refund. Filter by date range and page through results.
verify_transaction
Verify the status and details of a payment transaction. You can verify by either the Flutterwave transaction ID or your unique transaction reference (tx_ref). Use this to confirm that a payment was successful, check the charged amount and currency, and retrieve card token for future tokenized charges.
list_bill_categories
Retrieve available bill payment categories and billers. Returns biller codes and item codes needed for making bill payments. Optionally filter by category or country, or get items for a specific biller.
get_transaction_fee
Calculate the fees that will be charged for a transaction of a given amount and currency. Also supports checking transfer/payout fees. Useful for displaying fee breakdowns to customers before payment.
manage_beneficiaries
Create, list, retrieve, or delete saved transfer beneficiaries. Beneficiaries are saved recipient details for recurring payouts, so you don't have to enter bank details each time.
Manage e-commerce stores including products, orders, customers, inventory, and fulfillment. Create and update products with variants, images, and metafields. Process and track orders, draft orders, refunds, and transactions. Manage customer records, addresses, and marketing consent. Track and adjust inventory levels across multiple locations. Handle fulfillment workflows including routing to warehouses and third-party logistics. Create and manage discount codes, price rules, and automatic discounts. Configure shipping rates, carrier services, and delivery profiles. Build custom storefronts with cart management and checkout via the Storefront API. Manage content including pages, blogs, articles, and themes. Support B2B commerce with company profiles, catalogs, and custom pricing. Receive webhooks for events across orders, products, customers, inventory, fulfillment, collections, carts, checkouts, disputes, and more.
Manage email marketing audiences, campaigns, and automations. Create, send, schedule, and track email campaigns with detailed reporting on opens, clicks, and bounces. Add, update, and organize audience contacts with tags, segments, and interest groups. Set up and manage automation workflows triggered by subscriber activity or events. Connect e-commerce stores to manage customers, products, orders, and carts. Create and manage reusable email templates and landing pages. Upload and organize files for use in campaigns. Send transactional emails via the Mandrill API. Post custom events to trigger targeted automations. Configure webhooks to track subscribe, unsubscribe, profile updates, and email delivery events.
Process payments, manage subscriptions, and handle invoices. Create and manage customers, payment methods, and product catalogs. Issue refunds, handle disputes, and submit chargeback evidence. Create checkout sessions and payment links. Manage connected accounts and platform fund flows via Stripe Connect. Configure payouts to bank accounts and debit cards. Apply coupons and promotion codes to subscriptions and invoices. Calculate and collect taxes automatically. Access balance information and transaction history. Upload files for dispute evidence and identity verification. Create and manage virtual and physical payment cards via Issuing. Receive real-time webhook notifications for payment, subscription, invoice, and account events.
Validate, enrich, and look up data through a suite of utility APIs. Validate email addresses for deliverability, format, and risk (disposable, spam trap, role-based detection). Validate and identify phone numbers with carrier, line type, and location details. Geolocate IP addresses and detect VPNs, proxies, and TOR usage. Enrich company data from domains or emails. Retrieve live and historical currency exchange rates and perform conversions. Look up public holidays by country and date. Get current time and convert between timezones. Scrape web page content from URLs. Capture website screenshots. Compress and optimize images. Generate user avatars. Validate VAT numbers and retrieve VAT rates. Validate IBAN bank account numbers.
Manage roofing contractor business operations including jobs, contacts, estimates, invoices, and payments. Create and search jobs with milestone tracking, assign representatives, and monitor job lifecycle events. Create and retrieve contacts with communication logging. Access estimates, supplements, and financial worksheets. Create and manage invoices, payments, and expenses. Schedule and update appointments via calendars. Upload documents, photos, and videos to jobs. Retrieve company settings such as insurance companies, lead sources, milestones, and trade types. Access reports and manage webhook subscriptions for real-time event notifications on job, contact, and financial changes.
Create, retrieve, update, cancel, and reschedule appointments. Manage availability by querying open dates and time slots for appointment types and calendars. Block time slots to prevent bookings. Manage client records including creation, retrieval, updates, and deletion. List appointment types, add-ons, calendars, and intake forms. Create and validate gift certificates, packages, and coupons. Retrieve orders and product listings. Subscribe to webhooks for appointment and order events.
Process payments across multiple African and global markets using cards, bank transfers, mobile money, USSD, and digital wallets. Send payouts to bank accounts, mobile money wallets, and Flutterwave wallets in multiple currencies. Create and manage subscription billing with payment plans. Generate virtual accounts (dynamic or static) for receiving bank transfer payments. Create and manage payout subaccounts (wallets) with wallet-to-wallet transfers. Pay bills including airtime, data, cable, power, and tolls. Manage transaction disputes, refunds, and settlements. Verify identity via bank account and BVN resolution. Receive webhook notifications for charge, transfer, and subscription events.
Common questions about connecting Flutterwave to AI agents with Metorial.
