Standard API

post

https://api.flutterwave.com/v3/payments

Generate Flutterwave checkout to receive payments from customers. Learn more about our checkout

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

amount

int32

required

Defaults to 1000

The amount to be charged for the transaction

tx_ref

string

required

Defaults to YOUR_PAYMENT_REFERENCE

Unique reference for the transaction

currency

string

Defaults to NGN

The currency to charge in. Defaults to "NGN" if not specified

redirect_url

string

Defaults to https://www.flutterwave.com/ng

URL to redirect the customer to after payment is completed

customer

object

required

An object containing the customer’s details

customizations

object

An object containing options to customize the look of the payment modal

configuration

object

The checkout configurations

max_retry_attempt

int32

Defaults to 5

Max number of retry attempts for failed transactions

payment_plan

int32

Defaults to 3807

ID of the payment plan (used for recurring payments)

payment_options

string

Defaults to card, ussd, mobilemoneyghana

Comma-separated list of payment methods to display

link_expiration

date

Defaults to 2024-02-14T12:20:00

Sets how long the hosted payment link remains valid

subaccounts

array of objects

Array of objects specifying subaccount IDs for split payments

subaccounts

meta

object

Extra metadata you’d like to store with the transaction

Headers

Authorization

string

required

Defaults to Bearer FLWSECK_TEST-SANDBOXDEMOKEY-X

Pass your secret key as a bearer token in the request header

Responses

Language

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200200

400400