Flutterwave · Schema
Flutterwave Charge
A Flutterwave v4 charge object representing money collected from a customer via card, mobile money, bank transfer, USSD, or OPay.
PaymentsPayoutsMobile MoneyCardsAfricaFintechRemittanceVirtual AccountsChargebacksMulti-Currency
Properties
| Name | Type | Description |
|---|---|---|
| id | string | Unique charge identifier. |
| amount | number | Charge amount in major units of the supplied currency. |
| currency | string | ISO 4217 currency code. |
| status | string | Lifecycle status of the charge. |
| reference | string | Merchant- or system-generated unique reference. |
| customer | object | |
| payment_method | object | |
| processor_response | object | |
| redirect_url | string | |
| meta | object | |
| created_datetime | string |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://raw.githubusercontent.com/api-evangelist/flutterwave/main/json-schema/flutterwave-charge-schema.json",
"title": "Flutterwave Charge",
"description": "A Flutterwave v4 charge object representing money collected from a customer via card, mobile money, bank transfer, USSD, or OPay.",
"type": "object",
"required": ["id", "amount", "currency", "status"],
"properties": {
"id": { "type": "string", "description": "Unique charge identifier." },
"amount": { "type": "number", "description": "Charge amount in major units of the supplied currency." },
"currency": { "type": "string", "description": "ISO 4217 currency code.", "examples": ["NGN", "USD", "KES", "GHS"] },
"status": { "type": "string", "enum": ["pending", "succeeded", "failed"], "description": "Lifecycle status of the charge." },
"reference": { "type": "string", "description": "Merchant- or system-generated unique reference." },
"customer": {
"type": "object",
"properties": {
"id": { "type": "string" },
"email": { "type": "string", "format": "email" }
}
},
"payment_method": {
"type": "object",
"properties": {
"type": { "type": "string", "enum": ["card", "mobile_money", "bank_transfer", "ussd", "opay"] },
"card": { "type": "object" },
"mobile_money": { "type": "object" }
}
},
"processor_response": {
"type": "object",
"properties": {
"type": { "type": "string" },
"code": { "type": "string" }
}
},
"redirect_url": { "type": "string", "format": "uri" },
"meta": { "type": "object", "additionalProperties": true },
"created_datetime": { "type": "string", "format": "date-time" }
}
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/flutterwave-charge"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.