Flutterwave website screenshot

Flutterwave

Flutterwave is a pan-African payment infrastructure company providing the rails for businesses to accept, send, and manage money across Africa and globally. The Flutterwave for Business (F4B) v4 API exposes a unified surface for collections (cards, mobile money, bank transfer, USSD, OPay, virtual NUBANs), payouts (bank, mobile money, wallet-to-wallet across 30+ countries), real-time FX conversion, settlements, refunds, chargebacks, multi-currency wallets, KYC, card issuing, and bill payments. Flutterwave is one of the most valuable African fintech companies (unicorn status) and processes 20M+ API calls and 500k+ payments per day.

Flutterwave publishes 19 APIs on the APIs.io network, including Transfers API, Settlements API, Wallets API, and 16 more. Tagged areas include Payments, Payouts, Mobile Money, Cards, and Africa.

The Flutterwave catalog on APIs.io includes 1 JSON-LD context and 2 Spectral governance rulesets.

Flutterwave’s developer surface includes authentication, developer portal, documentation, getting-started guide, signup flow, support, pricing, and 63 more developer resources.

62.2/100 strong ▼ -6.9 Agent 34/100 agent ready Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessPaidSelf serve
19 APIs 21 Features
PaymentsPayoutsMobile MoneyCardsAfricaFintechRemittanceVirtual AccountsChargebacksMulti-Currency

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 62.2/100 · strong
Contract Quality 17.8 / 25
Developer Ergonomics 13.0 / 20
Commercial Clarity 14.2 / 20
Operational Transparency 2.7 / 13
Governance 8.3 / 12
Discoverability 7.4 / 10
Agent readiness — 34/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 8 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/flutterwave: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 19

Individual APIs this provider publishes, each with its own machine-readable definition.

Flutterwave Transfers API

Disburse funds globally across bank account transfers, mobile money transfers, and wallet-to-wallet transfers spanning 30+ African countries plus US/UK/EU/Asia corridors. Manage...

Flutterwave Settlements API

Reconcile transaction volume with merchant payouts. Manage settlements, refunds, chargebacks (dispute handling), and fee computation for cards, mobile money, and other rails. Th...

Flutterwave Wallets API

Inspect multi-currency wallet balances, retrieve wallet statements, and resolve mobile money wallet account details. Backs the FAAS (Finance as a Service) and capital flows for ...

Flutterwave Banks API

Reference data for banks, bank branches, and mobile networks supported by country, plus bank account name-enquiry endpoints. Used to populate checkout dropdowns and validate des...

Flutterwave Webhooks API

Outbound webhook callbacks delivered by Flutterwave for charges, transfers, refunds, chargebacks, and virtual account funding. Receivers validate the `verif-hash` header against...

Flutterwave AccountResolution API

Bank account name resolution before initiating payouts.

Flutterwave Chargebacks API

Manage and respond to chargebacks raised by customers.

Flutterwave Charges API

Create and manage charges across supported payment methods.

Flutterwave Customers API

Create and manage customers that own charges, orders, and transfers.

Flutterwave Fees API

Retrieve Flutterwave's fee calculation for a transaction.

Flutterwave MobileNetworks API

Mobile money networks supported by country.

Flutterwave Orchestration API

Orchestrator helpers that combine customer, payment method, and charge in one call.

Flutterwave Orders API

Server-side cart and order objects backing checkout sessions.

Flutterwave PaymentMethods API

Tokenize, register, and look up payment methods (cards, mobile money, bank, USSD).

Flutterwave Rates API

Real-time FX conversion rates for international transfers.

Flutterwave Recipients API

Manage transfer recipients (the destination of a payout).

Flutterwave Refunds API

Initiate and inspect refunds against successful charges.

Flutterwave Senders API

Manage transfer senders (the originator of a cross-border payout).

Flutterwave VirtualAccounts API

Issue virtual NUBANs for pay-with-bank-transfer collections.

Scroll for all 19

Postman Collections 6

Ready-to-run Postman collections for exercising this provider's APIs.

Open Collections 6

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

Flutterwave Banks API

OPEN COLLECTION

Flutterwave Payments API

OPEN COLLECTION

Flutterwave Transfers API

OPEN COLLECTION

Flutterwave Wallets API

OPEN COLLECTION

Flutterwave Webhooks API

OPEN COLLECTION

Arazzo Workflows 20

Multi-step API workflows described with the Arazzo specification.

Flutterwave Bank Directory Then Payout

Look up supported banks for a country, resolve the destination account, then create a recipient and send a payout.

ARAZZO

Flutterwave Charge And Verify Status

Initiate a charge then poll the charge object to confirm its final settled status.

ARAZZO

Flutterwave Charge Then Dispute Chargeback

Confirm a charge succeeded, raise a chargeback against it, and submit evidence to contest it.

ARAZZO

Flutterwave Charge Then Refund

Verify a charge succeeded, then create a refund against it and confirm the refund status.

ARAZZO

Flutterwave Create Recipient Transfer And Verify

Create a transfer recipient, send a payout to it, then verify the transfer reached a final status.

ARAZZO

Flutterwave Cross-Border Rate-Locked Transfer

Lock an FX rate, create a sender and recipient, then send a transfer at the locked rate and verify it.

ARAZZO

Flutterwave Direct Orchestrator Transfer And Verify

Initiate a one-call Orchestrator transfer with inline sender and recipient, then verify the payout status.

ARAZZO

Flutterwave Mobile Money Payout

Resolve a mobile money wallet, create a mobile money recipient, then send and verify the payout.

ARAZZO

Flutterwave Orchestrator Charge And Verify

Initiate a one-call Orchestrator charge then verify the resulting charge status.

ARAZZO

Flutterwave Orchestrator Order And Verify

Initiate an order in one call with the Orchestrator helper, then retrieve it to confirm its status.

ARAZZO

Flutterwave Order Checkout And Verify

Create a customer, place a server-side order for them, then retrieve the order to confirm its status.

ARAZZO

Flutterwave Quote Fee Then Charge

Retrieve the processing fee for an amount, create the customer, then charge and verify it.

ARAZZO

Flutterwave Resolve Account Then Payout

Resolve a destination bank account name, create a recipient for it, then send and verify a transfer.

ARAZZO

Flutterwave Reuse Recipient Payout

Retrieve a saved recipient to confirm it exists, then send a transfer to it and verify the payout.

ARAZZO

Flutterwave Settlement Reconciliation Refund

Retrieve a settlement, confirm a charge within it succeeded, then refund the charge and verify the refund.

ARAZZO

Flutterwave Tokenized Recurring Charge

Tokenize a payment method, charge it for a customer, then verify the recurring charge status.

ARAZZO

Flutterwave Transfer Verify And Retry

Send a transfer, verify its status, and retry it automatically when it failed.

ARAZZO

Flutterwave Upsert Customer And Charge

Search for a customer by email, create one only if missing, then charge that customer and verify it.

ARAZZO

Flutterwave Virtual Account Collection

Create a customer, issue a dedicated virtual account for them, then verify the account is active.

ARAZZO

Flutterwave Wallet Balance Guarded Payout

Check a currency wallet balance, then only send a transfer to an existing recipient when funds are sufficient.

ARAZZO

Scroll for all 20

GraphQL 1

GraphQL schemas published by this provider.

Flutterwave GraphQL Schema

This document describes a GraphQL schema representation of the Flutterwave Payments API. Flutterwave's native interface is REST-based; this schema is a conceptual mapping of cor...

GRAPHQL

Pricing Plans 1

Published pricing tiers and plan structures.

Rate Limits 1

Documented rate limits and quota policies.

Flutterwave Rate Limits

0 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Features 21

Notable capabilities this provider offers.

Accept payments via cards (local + international), mobile money (M-Pesa, MTN, Airtel, Tigo, Vodafone, OPay), bank transfers, USSD, and QR
Real-time payouts to bank accounts and mobile wallets across 30+ African countries plus US/UK/EU/Asia corridors
Virtual NUBANs (Nigerian Uniform Bank Account Numbers) for pay-with-bank-transfer collections
Cross-border remittance with built-in KYC for senders and recipients
Real-time FX conversion via the Transfer Rates endpoints
Multi-currency wallets (30+ currencies) with statements and balance APIs
Orchestrator helpers that combine customer creation, payment method tokenisation, and charge in one call
{"Idempotency via `X-Idempotency-Key` (UUID) returned on retry with `X-Idempotency-Cache-Hit" => "true`"}
AES-256 client-side encryption for sensitive card fields with a per-request 12-character nonce
OAuth 2.0 Client Credentials with 10-minute bearer tokens issued by Keycloak IDP
Webhooks for `charge.completed`, transfer completion, refunds, chargebacks, and virtual account funding
Card Issuing (virtual cards) and Card Acquiring services
Bill Payments and KYC services
Settlements, refunds, chargebacks, and fee computation endpoints for finance and operations
Industry solutions for Fintechs, Banks/OFIs, Travel/Hospitality, E-commerce, Remittance, Telecommunications, Loan Disbursements
Hosted checkout via Payment Links and Standard payment flow
Free ecommerce tooling (Store, Invoices, Disha) for SMEs
Send App (consumer remittance), Swap (FX), Afritickets (event ticketing), Market (online marketplace), Tuition (school fees)
Test card and test mobile money number library for sandbox validation
Sandbox and production environments at `api.flutterwave.cloud/f4b/sandbox` and `.../production`
Official SDKs for Node.js, PHP, Python, Ruby, Java, .NET plus frontend SDKs for React, Angular, Vue, Flutter, React Native, Android, iOS, and a WordPress plugin

Scroll for all 21

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Flutterwave Context

0 classes · 10 properties

JSON-LD

Spectral Rules 2

Spectral governance rulesets for linting and validating these APIs.

Flutterwave API Rules

5 rules · 4 warnings 1 info

SPECTRAL

Flutterwave API Rules

12 rules · 3 errors 7 warnings 2 info

SPECTRAL

JSON Schema 5

Standalone JSON Schema definitions for this provider's data models.

Flutterwave Charge

11 properties

JSON SCHEMA

Flutterwave Customer

7 properties

JSON SCHEMA

Flutterwave Settlement

10 properties

JSON SCHEMA

Flutterwave Transfer

12 properties

JSON SCHEMA

Flutterwave Wallet Balance

4 properties

JSON SCHEMA

JSON Structure 1

JSON Structure definitions describing this provider's data shapes.

Flutterwave Charge Structure

0 properties

JSON STRUCTURE

Examples 5

Example request and response payloads for these APIs.

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Flutterwave Authentication

oauth2 · 1 scheme

SECURITY

Flutterwave Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Scopes 1

OAuth scopes governing access to this provider's APIs.

Flutterwave Scopes

OAuth 2.0 · no documented scopes

0 scopes

SCOPES

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Flutterwave Agentic Access

57 operations · 27 acting

57 operations · 27 acting

AGENTIC

Resources

Get Started 4

Portal, sign-up, and the first successful call

Documentation 11

Reference material describing how the API behaves

Scroll for all 11

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

Design & Contract 23

Pagination, idempotency, versioning, errors, and events

Scroll for all 23

Build 16

SDKs, sample code, and the tooling you integrate with

Scroll for all 16

Access & Security 3

Authentication, authorization, and security posture

Operate 4

Status, limits, changes, and where to get help

Commercial 5

Pricing, plans, and the legal terms of use

Company 3

The organization behind the API

Source (apis.yml)

apis.yml Raw ↑
aid: flutterwave
url: https://raw.githubusercontent.com/api-evangelist/flutterwave/refs/heads/main/apis.yml
apis:
- aid: flutterwave:flutterwave-transfers-api
  name: Flutterwave Transfers API
  tags:
  - Payouts
  - Transfers
  - Remittance
  - FX
  - Cross-Border
  - Mobile Money
  humanURL: https://developer.flutterwave.com/docs/introduction-3.md
  baseURL: https://api.flutterwave.cloud/f4b/production
  properties:
  - url: https://developer.flutterwave.com/docs/introduction-3.md
    type: Documentation
  - url: https://developer.flutterwave.com/reference/transfers_post.md
    type: Documentation
  - url: openapi/flutterwave-transfers-api-openapi.yml
    type: OpenAPI
  - url: json-schema/flutterwave-transfer-schema.json
    type: JSONSchema
  - url: examples/flutterwave-create-transfer-example.json
    type: Examples
  description: Disburse funds globally across bank account transfers, mobile money transfers, and wallet-to-wallet transfers
    spanning 30+ African countries plus US/UK/EU/Asia corridors. Manage transfer recipients, transfer senders (KYC for cross-border),
    and real-time FX conversion via the Rates endpoints.
- aid: flutterwave:flutterwave-settlements-api
  name: Flutterwave Settlements API
  tags:
  - Settlements
  - Refunds
  - Chargebacks
  - Disputes
  - Fees
  - Reconciliation
  humanURL: https://developer.flutterwave.com/docs/settlements.md
  baseURL: https://api.flutterwave.cloud/f4b/production
  properties:
  - url: https://developer.flutterwave.com/docs/settlements.md
    type: Documentation
  - url: https://developer.flutterwave.com/docs/refunds.md
    type: Documentation
  - url: https://developer.flutterwave.com/docs/chargebacks-1.md
    type: Documentation
  - url: openapi/flutterwave-settlements-api-openapi.yml
    type: OpenAPI
  - url: json-schema/flutterwave-settlement-schema.json
    type: JSONSchema
  - url: examples/flutterwave-create-refund-example.json
    type: Examples
  description: Reconcile transaction volume with merchant payouts. Manage settlements, refunds, chargebacks (dispute handling),
    and fee computation for cards, mobile money, and other rails. The finance-and-ops surface of the F4B platform.
- aid: flutterwave:flutterwave-wallets-api
  name: Flutterwave Wallets API
  tags:
  - Wallets
  - Balances
  - Statements
  - Multi-Currency
  humanURL: https://developer.flutterwave.com/reference/fetch_wallet_balances.md
  baseURL: https://api.flutterwave.cloud/f4b/production
  properties:
  - url: https://developer.flutterwave.com/reference/fetch_wallet_balances.md
    type: Documentation
  - url: https://developer.flutterwave.com/reference/get_wallet_statement.md
    type: Documentation
  - url: https://developer.flutterwave.com/reference/wallet_account_resolve_post.md
    type: Documentation
  - url: openapi/flutterwave-wallets-api-openapi.yml
    type: OpenAPI
  - url: json-schema/flutterwave-wallet-schema.json
    type: JSONSchema
  description: Inspect multi-currency wallet balances, retrieve wallet statements, and resolve mobile money wallet account
    details. Backs the FAAS (Finance as a Service) and capital flows for merchants holding balances in NGN, USD, EUR, GBP,
    KES, GHS, ZAR, UGX, TZS, RWF, XAF, XOF and other supported currencies.
- aid: flutterwave:flutterwave-banks-api
  name: Flutterwave Banks API
  tags:
  - Banks
  - Reference Data
  - Mobile Networks
  - Account Resolution
  humanURL: https://developer.flutterwave.com/reference/banks_get.md
  baseURL: https://api.flutterwave.cloud/f4b/production
  properties:
  - url: https://developer.flutterwave.com/reference/banks_get.md
    type: Documentation
  - url: https://developer.flutterwave.com/reference/mobile_networks_get.md
    type: Documentation
  - url: https://developer.flutterwave.com/reference/bank_account_resolve_post.md
    type: Documentation
  - url: openapi/flutterwave-banks-api-openapi.yml
    type: OpenAPI
  description: Reference data for banks, bank branches, and mobile networks supported by country, plus bank account name-enquiry
    endpoints. Used to populate checkout dropdowns and validate destination accounts before initiating payouts.
- aid: flutterwave:flutterwave-webhooks-api
  name: Flutterwave Webhooks API
  tags:
  - Webhooks
  - Events
  - Asynchronous
  humanURL: https://developer.flutterwave.com/docs/webhooks.md
  baseURL: https://your-webhook-endpoint.example.com
  properties:
  - url: https://developer.flutterwave.com/docs/webhooks.md
    type: Documentation
  - url: openapi/flutterwave-webhooks-api-openapi.yml
    type: OpenAPI
  - url: asyncapi.yml
    type: AsyncAPI
  - url: examples/flutterwave-charge-completed-webhook-example.json
    type: Examples
  description: Outbound webhook callbacks delivered by Flutterwave for charges, transfers, refunds, chargebacks, and virtual
    account funding. Receivers validate the `verif-hash` header against the merchant's configured secret hash before trusting
    the payload.
- aid: flutterwave:flutterwave-accountresolution-api
  name: Flutterwave AccountResolution API
  description: Bank account name resolution before initiating payouts.
  humanURL: https://developer.flutterwave.com/reference
  baseURL: https://api.flutterwave.cloud/f4b/production
  tags:
  - AccountResolution
  properties:
  - type: OpenAPI
    url: openapi/flutterwave-accountresolution-api-openapi.yml
  - type: Documentation
    url: https://developer.flutterwave.com/docs/introduction-1.md
  - type: Documentation
    url: https://developer.flutterwave.com/reference/charges_post.md
  - type: JSONSchema
    url: json-schema/flutterwave-charge-schema.json
  - type: JSONSchema
    url: json-schema/flutterwave-customer-schema.json
  - type: JSONStructure
    url: json-structure/flutterwave-charge-structure.json
  - type: JSONLD
    url: json-ld/flutterwave-context.jsonld
  - type: Examples
    url: examples/flutterwave-create-charge-example.json
  - type: Examples
    url: examples/flutterwave-create-customer-example.json
  - type: GraphQL
    url: graphql/flutterwave-graphql.md
- aid: flutterwave:flutterwave-chargebacks-api
  name: Flutterwave Chargebacks API
  description: Manage and respond to chargebacks raised by customers.
  humanURL: https://developer.flutterwave.com/reference
  baseURL: https://api.flutterwave.cloud/f4b/production
  tags:
  - Chargebacks
  properties:
  - type: OpenAPI
    url: openapi/flutterwave-chargebacks-api-openapi.yml
  - type: Documentation
    url: https://developer.flutterwave.com/docs/introduction-1.md
  - type: Documentation
    url: https://developer.flutterwave.com/reference/charges_post.md
  - type: JSONSchema
    url: json-schema/flutterwave-charge-schema.json
  - type: JSONSchema
    url: json-schema/flutterwave-customer-schema.json
  - type: JSONStructure
    url: json-structure/flutterwave-charge-structure.json
  - type: JSONLD
    url: json-ld/flutterwave-context.jsonld
  - type: Examples
    url: examples/flutterwave-create-charge-example.json
  - type: Examples
    url: examples/flutterwave-create-customer-example.json
  - type: GraphQL
    url: graphql/flutterwave-graphql.md
- aid: flutterwave:flutterwave-charges-api
  name: Flutterwave Charges API
  description: Create and manage charges across supported payment methods.
  humanURL: https://developer.flutterwave.com/reference
  baseURL: https://api.flutterwave.cloud/f4b/production
  tags:
  - Charges
  properties:
  - type: OpenAPI
    url: openapi/flutterwave-charges-api-openapi.yml
  - type: Documentation
    url: https://developer.flutterwave.com/docs/introduction-1.md
  - type: Documentation
    url: https://developer.flutterwave.com/reference/charges_post.md
  - type: JSONSchema
    url: json-schema/flutterwave-charge-schema.json
  - type: JSONSchema
    url: json-schema/flutterwave-customer-schema.json
  - type: JSONStructure
    url: json-structure/flutterwave-charge-structure.json
  - type: JSONLD
    url: json-ld/flutterwave-context.jsonld
  - type: Examples
    url: examples/flutterwave-create-charge-example.json
  - type: Examples
    url: examples/flutterwave-create-customer-example.json
  - type: GraphQL
    url: graphql/flutterwave-graphql.md
- aid: flutterwave:flutterwave-customers-api
  name: Flutterwave Customers API
  description: Create and manage customers that own charges, orders, and transfers.
  humanURL: https://developer.flutterwave.com/reference
  baseURL: https://api.flutterwave.cloud/f4b/production
  tags:
  - Customers
  properties:
  - type: OpenAPI
    url: openapi/flutterwave-customers-api-openapi.yml
  - type: Documentation
    url: https://developer.flutterwave.com/docs/introduction-1.md
  - type: Documentation
    url: https://developer.flutterwave.com/reference/charges_post.md
  - type: JSONSchema
    url: json-schema/flutterwave-charge-schema.json
  - type: JSONSchema
    url: json-schema/flutterwave-customer-schema.json
  - type: JSONStructure
    url: json-structure/flutterwave-charge-structure.json
  - type: JSONLD
    url: json-ld/flutterwave-context.jsonld
  - type: Examples
    url: examples/flutterwave-create-charge-example.json
  - type: Examples
    url: examples/flutterwave-create-customer-example.json
  - type: GraphQL
    url: graphql/flutterwave-graphql.md
- aid: flutterwave:flutterwave-fees-api
  name: Flutterwave Fees API
  description: Retrieve Flutterwave's fee calculation for a transaction.
  humanURL: https://developer.flutterwave.com/reference
  baseURL: https://api.flutterwave.cloud/f4b/production
  tags:
  - Fees
  properties:
  - type: OpenAPI
    url: openapi/flutterwave-fees-api-openapi.yml
  - type: Documentation
    url: https://developer.flutterwave.com/docs/introduction-1.md
  - type: Documentation
    url: https://developer.flutterwave.com/reference/charges_post.md
  - type: JSONSchema
    url: json-schema/flutterwave-charge-schema.json
  - type: JSONSchema
    url: json-schema/flutterwave-customer-schema.json
  - type: JSONStructure
    url: json-structure/flutterwave-charge-structure.json
  - type: JSONLD
    url: json-ld/flutterwave-context.jsonld
  - type: Examples
    url: examples/flutterwave-create-charge-example.json
  - type: Examples
    url: examples/flutterwave-create-customer-example.json
  - type: GraphQL
    url: graphql/flutterwave-graphql.md
- aid: flutterwave:flutterwave-mobilenetworks-api
  name: Flutterwave MobileNetworks API
  description: Mobile money networks supported by country.
  humanURL: https://developer.flutterwave.com/reference
  baseURL: https://api.flutterwave.cloud/f4b/production
  tags:
  - MobileNetworks
  properties:
  - type: OpenAPI
    url: openapi/flutterwave-mobilenetworks-api-openapi.yml
  - type: Documentation
    url: https://developer.flutterwave.com/docs/introduction-1.md
  - type: Documentation
    url: https://developer.flutterwave.com/reference/charges_post.md
  - type: JSONSchema
    url: json-schema/flutterwave-charge-schema.json
  - type: JSONSchema
    url: json-schema/flutterwave-customer-schema.json
  - type: JSONStructure
    url: json-structure/flutterwave-charge-structure.json
  - type: JSONLD
    url: json-ld/flutterwave-context.jsonld
  - type: Examples
    url: examples/flutterwave-create-charge-example.json
  - type: Examples
    url: examples/flutterwave-create-customer-example.json
  - type: GraphQL
    url: graphql/flutterwave-graphql.md
- aid: flutterwave:flutterwave-orchestration-api
  name: Flutterwave Orchestration API
  description: Orchestrator helpers that combine customer, payment method, and charge in one call.
  humanURL: https://developer.flutterwave.com/reference
  baseURL: https://api.flutterwave.cloud/f4b/production
  tags:
  - Orchestration
  properties:
  - type: OpenAPI
    url: openapi/flutterwave-orchestration-api-openapi.yml
  - type: Documentation
    url: https://developer.flutterwave.com/docs/introduction-1.md
  - type: Documentation
    url: https://developer.flutterwave.com/reference/charges_post.md
  - type: JSONSchema
    url: json-schema/flutterwave-charge-schema.json
  - type: JSONSchema
    url: json-schema/flutterwave-customer-schema.json
  - type: JSONStructure
    url: json-structure/flutterwave-charge-structure.json
  - type: JSONLD
    url: json-ld/flutterwave-context.jsonld
  - type: Examples
    url: examples/flutterwave-create-charge-example.json
  - type: Examples
    url: examples/flutterwave-create-customer-example.json
  - type: GraphQL
    url: graphql/flutterwave-graphql.md
- aid: flutterwave:flutterwave-orders-api
  name: Flutterwave Orders API
  description: Server-side cart and order objects backing checkout sessions.
  humanURL: https://developer.flutterwave.com/reference
  baseURL: https://api.flutterwave.cloud/f4b/production
  tags:
  - Orders
  properties:
  - type: OpenAPI
    url: openapi/flutterwave-orders-api-openapi.yml
  - type: Documentation
    url: https://developer.flutterwave.com/docs/introduction-1.md
  - type: Documentation
    url: https://developer.flutterwave.com/reference/charges_post.md
  - type: JSONSchema
    url: json-schema/flutterwave-charge-schema.json
  - type: JSONSchema
    url: json-schema/flutterwave-customer-schema.json
  - type: JSONStructure
    url: json-structure/flutterwave-charge-structure.json
  - type: JSONLD
    url: json-ld/flutterwave-context.jsonld
  - type: Examples
    url: examples/flutterwave-create-charge-example.json
  - type: Examples
    url: examples/flutterwave-create-customer-example.json
  - type: GraphQL
    url: graphql/flutterwave-graphql.md
- aid: flutterwave:flutterwave-paymentmethods-api
  name: Flutterwave PaymentMethods API
  description: Tokenize, register, and look up payment methods (cards, mobile money, bank, USSD).
  humanURL: https://developer.flutterwave.com/reference
  baseURL: https://api.flutterwave.cloud/f4b/production
  tags:
  - PaymentMethods
  properties:
  - type: OpenAPI
    url: openapi/flutterwave-paymentmethods-api-openapi.yml
  - type: Documentation
    url: https://developer.flutterwave.com/docs/introduction-1.md
  - type: Documentation
    url: https://developer.flutterwave.com/reference/charges_post.md
  - type: JSONSchema
    url: json-schema/flutterwave-charge-schema.json
  - type: JSONSchema
    url: json-schema/flutterwave-customer-schema.json
  - type: JSONStructure
    url: json-structure/flutterwave-charge-structure.json
  - type: JSONLD
    url: json-ld/flutterwave-context.jsonld
  - type: Examples
    url: examples/flutterwave-create-charge-example.json
  - type: Examples
    url: examples/flutterwave-create-customer-example.json
  - type: GraphQL
    url: graphql/flutterwave-graphql.md
- aid: flutterwave:flutterwave-rates-api
  name: Flutterwave Rates API
  description: Real-time FX conversion rates for international transfers.
  humanURL: https://developer.flutterwave.com/reference
  baseURL: https://api.flutterwave.cloud/f4b/production
  tags:
  - Rates
  properties:
  - type: OpenAPI
    url: openapi/flutterwave-rates-api-openapi.yml
  - type: Documentation
    url: https://developer.flutterwave.com/docs/introduction-1.md
  - type: Documentation
    url: https://developer.flutterwave.com/reference/charges_post.md
  - type: JSONSchema
    url: json-schema/flutterwave-charge-schema.json
  - type: JSONSchema
    url: json-schema/flutterwave-customer-schema.json
  - type: JSONStructure
    url: json-structure/flutterwave-charge-structure.json
  - type: JSONLD
    url: json-ld/flutterwave-context.jsonld
  - type: Examples
    url: examples/flutterwave-create-charge-example.json
  - type: Examples
    url: examples/flutterwave-create-customer-example.json
  - type: GraphQL
    url: graphql/flutterwave-graphql.md
- aid: flutterwave:flutterwave-recipients-api
  name: Flutterwave Recipients API
  description: Manage transfer recipients (the destination of a payout).
  humanURL: https://developer.flutterwave.com/reference
  baseURL: https://api.flutterwave.cloud/f4b/production
  tags:
  - Recipients
  properties:
  - type: OpenAPI
    url: openapi/flutterwave-recipients-api-openapi.yml
  - type: Documentation
    url: https://developer.flutterwave.com/docs/introduction-1.md
  - type: Documentation
    url: https://developer.flutterwave.com/reference/charges_post.md
  - type: JSONSchema
    url: json-schema/flutterwave-charge-schema.json
  - type: JSONSchema
    url: json-schema/flutterwave-customer-schema.json
  - type: JSONStructure
    url: json-structure/flutterwave-charge-structure.json
  - type: JSONLD
    url: json-ld/flutterwave-context.jsonld
  - type: Examples
    url: examples/flutterwave-create-charge-example.json
  - type: Examples
    url: examples/flutterwave-create-customer-example.json
  - type: GraphQL
    url: graphql/flutterwave-graphql.md
- aid: flutterwave:flutterwave-refunds-api
  name: Flutterwave Refunds API
  description: Initiate and inspect refunds against successful charges.
  humanURL: https://developer.flutterwave.com/reference
  baseURL: https://api.flutterwave.cloud/f4b/production
  tags:
  - Refunds
  properties:
  - type: OpenAPI
    url: openapi/flutterwave-refunds-api-openapi.yml
  - type: Documentation
    url: https://developer.flutterwave.com/docs/introduction-1.md
  - type: Documentation
    url: https://developer.flutterwave.com/reference/charges_post.md
  - type: JSONSchema
    url: json-schema/flutterwave-charge-schema.json
  - type: JSONSchema
    url: json-schema/flutterwave-customer-schema.json
  - type: JSONStructure
    url: json-structure/flutterwave-charge-structure.json
  - type: JSONLD
    url: json-ld/flutterwave-context.jsonld
  - type: Examples
    url: examples/flutterwave-create-charge-example.json
  - type: Examples
    url: examples/flutterwave-create-customer-example.json
  - type: GraphQL
    url: graphql/flutterwave-graphql.md
- aid: flutterwave:flutterwave-senders-api
  name: Flutterwave Senders API
  description: Manage transfer senders (the originator of a cross-border payout).
  humanURL: https://developer.flutterwave.com/reference
  baseURL: https://api.flutterwave.cloud/f4b/production
  tags:
  - Senders
  properties:
  - type: OpenAPI
    url: openapi/flutterwave-senders-api-openapi.yml
  - type: Documentation
    url: https://developer.flutterwave.com/docs/introduction-1.md
  - type: Documentation
    url: https://developer.flutterwave.com/reference/charges_post.md
  - type: JSONSchema
    url: json-schema/flutterwave-charge-schema.json
  - type: JSONSchema
    url: json-schema/flutterwave-customer-schema.json
  - type: JSONStructure
    url: json-structure/flutterwave-charge-structure.json
  - type: JSONLD
    url: json-ld/flutterwave-context.jsonld
  - type: Examples
    url: examples/flutterwave-create-charge-example.json
  - type: Examples
    url: examples/flutterwave-create-customer-example.json
  - type: GraphQL
    url: graphql/flutterwave-graphql.md
- aid: flutterwave:flutterwave-virtualaccounts-api
  name: Flutterwave VirtualAccounts API
  description: Issue virtual NUBANs for pay-with-bank-transfer collections.
  humanURL: https://developer.flutterwave.com/reference
  baseURL: https://api.flutterwave.cloud/f4b/production
  tags:
  - VirtualAccounts
  properties:
  - type: OpenAPI
    url: openapi/flutterwave-virtualaccounts-api-openapi.yml
  - type: Documentation
    url: https://developer.flutterwave.com/docs/introduction-1.md
  - type: Documentation
    url: https://developer.flutterwave.com/reference/charges_post.md
  - type: JSONSchema
    url: json-schema/flutterwave-charge-schema.json
  - type: JSONSchema
    url: json-schema/flutterwave-customer-schema.json
  - type: JSONStructure
    url: json-structure/flutterwave-charge-structure.json
  - type: JSONLD
    url: json-ld/flutterwave-context.jsonld
  - type: Examples
    url: examples/flutterwave-create-charge-example.json
  - type: Examples
    url: examples/flutterwave-create-customer-example.json
  - type: GraphQL
    url: graphql/flutterwave-graphql.md
name: Flutterwave
tags:
- Payments
- Payouts
- Mobile Money
- Cards
- Africa
- Fintech
- Remittance
- Virtual Accounts
- Chargebacks
- Multi-Currency
kind: contract
accessModel:
  pricing: paid
  onboarding: self-serve
  trial: false
  try_now: false
  public: false
  label: Paid · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/flutterwave.png
access: 3rd-Party
common:
- type: AgenticAccess
  url: agentic-access/flutterwave-agentic-access.yml
- type: DomainSecurity
  url: security/flutterwave-domain-security.yml
- type: Authentication
  url: authentication/flutterwave-authentication.yml
- type: OAuthScopes
  url: scopes/flutterwave-scopes.yml
- type: PostmanWorkspace
  url: https://www.postman.com/kinlaneapi/flutterwave/overview
- type: Arazzo
  url: arazzo/flutterwave-bank-directory-then-payout-workflow.yml
  name: Flutterwave Bank Directory Then Payout
- type: Arazzo
  url: arazzo/flutterwave-charge-and-verify-status-workflow.yml
  name: Flutterwave Charge And Verify Status
- type: Arazzo
  url: arazzo/flutterwave-charge-then-dispute-chargeback-workflow.yml
  name: Flutterwave Charge Then Dispute Chargeback
- type: Arazzo
  url: arazzo/flutterwave-charge-then-refund-workflow.yml
  name: Flutterwave Charge Then Refund
- type: Arazzo
  url: arazzo/flutterwave-create-recipient-transfer-verify-workflow.yml
  name: Flutterwave Create Recipient Transfer And Verify
- type: Arazzo
  url: arazzo/flutterwave-cross-border-rate-locked-transfer-workflow.yml
  name: Flutterwave Cross-Border Rate-Locked Transfer
- type: Arazzo
  url: arazzo/flutterwave-direct-orchestrator-transfer-verify-workflow.yml
  name: Flutterwave Direct Orchestrator Transfer And Verify
- type: Arazzo
  url: arazzo/flutterwave-mobile-money-payout-workflow.yml
  name: Flutterwave Mobile Money Payout
- type: Arazzo
  url: arazzo/flutterwave-orchestrator-charge-and-verify-workflow.yml
  name: Flutterwave Orchestrator Charge And Verify
- type: Arazzo
  url: arazzo/flutterwave-orchestrator-order-and-verify-workflow.yml
  name: Flutterwave Orchestrator Order And Verify
- type: Arazzo
  url: arazzo/flutterwave-order-checkout-and-verify-workflow.yml
  name: Flutterwave Order Checkout And Verify
- type: Arazzo
  url: arazzo/flutterwave-quote-fee-then-charge-workflow.yml
  name: Flutterwave Quote Fee Then Charge
- type: Arazzo
  url: arazzo/flutterwave-resolve-account-then-payout-workflow.yml
  name: Flutterwave Resolve Account Then Payout
- type: Arazzo
  url: arazzo/flutterwave-reuse-recipient-payout-workflow.yml
  name: Flutterwave Reuse Recipient Payout
- type: Arazzo
  url: arazzo/flutterwave-settlement-reconciliation-refund-workflow.yml
  name: Flutterwave Settlement Reconciliation Refund
- type: Arazzo
  url: arazzo/flutterwave-tokenized-recurring-charge-workflow.yml
  name: Flutterwave Tokenized Recurring Charge
- type: Arazzo
  url: arazzo/flutterwave-transfer-verify-and-retry-workflow.yml
  name: Flutterwave Transfer Verify And Retry
- type: Arazzo
  url: arazzo/flutterwave-upsert-customer-and-charge-workflow.yml
  name: Flutterwave Upsert Customer And Charge
- type: Arazzo
  url: arazzo/flutterwave-virtual-account-collection-workflow.yml
  name: Flutterwave Virtual Account Collection
- type: Arazzo
  url: arazzo/flutterwave-wallet-balance-guarded-payout-workflow.yml
  name: Flutterwave Wallet Balance Guarded Payout
- url: https://flutterwave.com
  type: Portal
- url: https://developer.flutterwave.com
  name: Flutterwave Developer Portal
  type: Portal
- url: https://developer.flutterwave.com/docs
  name: Flutterwave Documentation
  type: Documentation
- url: https://developer.flutterwave.com/reference
  name: API Reference
  type: Documentation
- url: https://developer.flutterwave.com/llms.txt
  name: LLM-friendly Documentation Index
  type: Documentation
- url: https://developer.flutterwave.com/docs/getting-started.md
  name: Getting Started
  type: GettingStarted
- url: https://developer.flutterwave.com/docs/authentication.md
  name: Authentication
  type: Documentation
- url: https://developer.flutterwave.com/docs/api-headers.md
  name: API Headers
  type: Documentation
- url: https://developer.flutterwave.com/docs/encryption.md
  name: Encryption
  type: Documentation
- url: https://developer.flutterwave.com/docs/common-errors.md
  name: Errors
  type: ErrorCodes
- url: https://developer.flutterwave.com/docs/webhooks.md
  name: Webhooks
  type: Documentation
- url: https://developer.flutterwave.com/docs/idempotency.md
  name: Idempotency
  type: Documentation
- url: https://developer.flutterwave.com/docs/testing.md
  name: Testing
  type: Documentation
- url: https://developer.flutterwave.com/docs/best-practices.md
  name: Best Practices
  type: Documentation
- url: https://developer.flutterwave.com/docs/environments.md
  name: Environments
  type: Documentation
- url: https://onboarding.flutterwave.com/signup
  name: Sign Up
  type: Signup
- url: https://status.flutterwave.com
  name: Flutterwave Status
  type: StatusPage
- url: https://support.flutterwave.com
  name: Flutterwave Support
  type: Support
- url: https://flutterwave.com/us/pricing
  name: Pricing
  type: Pricing
- url: https://flutterwave.com/us/blog
  name: Flutterwave Blog
  type: Blog
- url: https://flutterwave.com/us/terms
  name: Terms of Service
  type: TermsOfService
- url: https://flutterwave.com/us/privacy-notice
  name: Privacy Notice
  type: PrivacyPolicy
- url: https://flutterwave.com/us/contact-sales
  name: Contact Sales
  type: Contact
- url: https://www.linkedin.com/company/flutterwave
  type: LinkedIn
- url: https://twitter.com/theflutterwave
  type: Twitter
- url: https://github.com/Flutterwave
  type: GitHubOrganization
- url: https://github.com/Flutterwave/Node-v3
  name: Node.js SDK (v3)
  type: SDKs
- url: https://github.com/Flutterwave/PHP-v3
  name: PHP SDK (v3)
  type: SDKs
- url: https://github.com/Flutterwave/Python-v2
  name: Python SDK (v2)
  type: SDKs
- url: https://github.com/Flutterwave/Ruby-v3
  name: Ruby SDK (v3)
  type: SDKs
- url: https://github.com/Flutterwave/Java-v3
  name: Java SDK (v3)
  type: SDKs
- url: https://github.com/Flutterwave/Dotnet-v2
  name: .NET SDK (v2)
  type: SDKs
- url: https://github.com/Flutterwave/React-v3
  name: React SDK (v3)
  type: SDKs
- url: https://github.com/Flutterwave/Angular-v3
  name: Angular SDK (v3)
  type: SDKs
- url: https://github.com/Flutterwave/Vue-v3
  name: Vue.js SDK (v3)
  type: SDKs
- url: https://github.com/Flutterwave/Flutter-v3
  name: Flutter SDK (v3)
  type: SDKs
- url: https://github.com/Flutterwave/React-Native
  name: React Native SDK
  type: SDKs
- url: https://github.com/Flutterwave/AndroidSDK
  name: Android SDK
  type: SDKs
- url: https://github.com/Flutterwave/iOS-v3
  name: iOS SDK (v3)
  type: SDKs
- url: https://github.com/Flutterwave/WordPress-v2
  name: WordPress Plugin (v2)
  type: Plugin
- url: plans/flutterwave-plans-pricing.yml
  type: Plans
- url: rate-limits/flutterwave-rate-limits.yml
  type: RateLimits
- url: finops/flutterwave-finops.yml
  type: FinOps
- url: rules/flutterwave-rules.yml
  type: SpectralRules
- url: vocabulary/flutterwave-vocabulary.yml
  type: Vocabulary
- type: Features
  data:
  - Accept payments via cards (local + international), mobile money (M-Pesa, MTN, Airtel, Tigo, Vodafone, OPay), bank transfers,
    USSD, and QR
  - Real-time payouts to bank accounts and mobile wallets across 30+ African countries plus US/UK/EU/Asia corridors
  - Virtual NUBANs (Nigerian Uniform Bank Account Numbers) for pay-with-bank-transfer collections
  - Cross-border remittance with built-in KYC for senders and recipients
  - Real-time FX conversion via the Transfer Rates endpoints
  - Multi-currency wallets (30+ currencies) with statements and balance APIs
  - Orchestrator helpers that combine customer creation, payment method tokenisation, and charge in one call
  - Idempotency via `X-Idempotency-Key` (UUID) returned on retry with `X-Idempotency-Cache-Hit: true`
  - AES-256 client-side encryption for sensitive card fields with a per-request 12-character nonce
  - OAuth 2.0 Client Credentials with 10-minute bearer tokens issued by Keycloak IDP
  - Webhooks for `charge.completed`, transfer completion, refunds, chargebacks, and virtual account funding
  - Card Issuing (virtual cards) and Card Acquiring services
  - Bill Payments and KYC services
  - Settlements, refunds, chargebacks, and fee computation endpoints for finance and operations
  - Industry solutions for Fintechs, Banks/OFIs, Travel/Hospitality, E-commerce, Remittance, Telecommunications, Loan Disbursements
  - Hosted checkout via Payment Links and Standard payment flow
  - Free ecommerce tooling (Store, Invoices, Disha) for SMEs
  - Send App (consumer remittance), Swap (FX), Afritickets (event ticketing), Market (online marketplace), Tuition (school
    fees)
  - Test card and test mobile money number library for sandbox validation
  - Sandbox and production environments at `api.flutterwave.cloud/f4b/sandbox` and `.../production`
  - Official SDKs for Node.js, PHP, Python, Ruby, Java, .NET plus frontend SDKs for React, Angular, Vue, Flutter, React Native,
    Android, iOS, and a WordPress plugin
  sources:
  - https://developer.flutterwave.com
  - https://developer.flutterwave.com/llms.txt
  - https://flutterwave.com
  - https://github.com/Flutterwave
  updated: '2026-05-24'
created: '2026-05-24'
modified: '2026-05-30'
position: Producing
description: Flutterwave is a pan-African payment infrastructure company providing the rails for businesses to accept, send,
  and manage money across Africa and globally. The Flutterwave for Business (F4B) v4 API exposes a unified surface for collections
  (cards, mobile money, bank transfer, USSD, OPay, virtual NUBANs), payouts (bank, mobile money, wallet-to-wallet across 30+
  countries), real-time FX conversion, settlements, refunds, chargebacks, multi-currency wallets, KYC, card issuing, and bill
  payments. Flutterwave is one of the most valuable African fintech companies (unicorn status) and processes 20M+ API calls
  and 500k+ payments per day.
maintainers:
- FN: Kin Lane
  email: info@apievangelist.com
  X: apievangelist
  url: https://apievangelist.com
specificationVersion: '0.16'