DocumentationAPI ReferencesSupportBlogAsk AI
API References

Create a charge

post
https://developersandbox-api.flutterwave.com/charges

Create a charge

Body Params
number
required
≥ 0.01

The payment amount in decimals.

string
enum
required

ISO 4217 currency code.

string
required
length between 6 and 42

A custom identifier to track the transaction, This must be unique across all your transactions.

string
required

ID of the customer.

meta
object
string
required

ID of the payment method.

string

Specifies the URL to redirect to.

authorization
boolean
Defaults to false

Specify true for a recurring charge. Recurring charges bypass authorization flows and always return a terminal status of successful or failed.

string

ID of the order. This is only used for preauth captures.

number
Headers
string
length between 12 and 255

A unique identifier to track this operation. It must be between 12 and 255 characters in length.

string
length between 12 and 255

A unique identifier to prevent duplicate requests. It must be between 12 and 255 characters in length.

string
1 to 1000

An optional scenario key that can be used to simulate specific behaviors or test different scenarios within the API. Providing this header allows you to trigger predefined responses or alter data based on the key's value, which can be useful for testing, development, or demonstrating specific functionalities. The key should be a string of 1 to 1000 characters.

Responses

Updated 9 months ago

Language
Credentials
Bearer
Response 
Click Try It! to start a request and see the response here! Or choose an example:
application/json
Updated 9 months ago