Skip to main content
POST
/
tokenized-charges
Create a Tokenized Charge
curl --request POST \
  --url https://api.flutterwave.com/v3/tokenized-charges \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "token": "flw-t1nf-c25d14a3a6b5afaf8022fe88212a3eaa-k3n",
  "currency": "NGN",
  "amount": 100,
  "email": "Johndoe@gmail.com",
  "tx_ref": "YOUR_UNIQUE_REFERENCE"
}
'
{
  "status": "success",
  "message": "Charge successful",
  "data": {
    "id": 1163077,
    "tx_ref": "akhlm-pstmn-23452",
    "flw_ref": "FLW-M03K-781621ccfe976c03515bcd07a39f3db8",
    "redirect_url": "http://127.0.0",
    "device_fingerprint": "N/A",
    "amount": 30300,
    "charged_amount": 30300,
    "app_fee": 11741.9,
    "merchant_fee": 0,
    "processor_response": "Approved",
    "auth_model": "noauth",
    "currency": "NGN",
    "ip": "pstmn",
    "narration": "pstmn charge",
    "status": "successful",
    "payment_type": "card",
    "created_at": "2020-03-11T19:33:20.000Z",
    "account_id": 73362,
    "customer": {
      "id": 252759,
      "phone_number": "0813XXXXXXX",
      "name": "Kendrick Graham",
      "email": "user@example.com",
      "created_at": "2020-01-15T13:26:24.000Z"
    },
    "card": {
      "first_6digits": "553188",
      "last_4digits": "2950",
      "issuer": "MASTERCARD  CREDIT",
      "country": "NG",
      "type": "MASTERCARD",
      "expiry": "09/22",
      "token": "flw-t0-d0185c6edad078c9e8304c4f78b8cd5b-m03k"
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://flutterwaveinc.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
token
string
required
​
currency
string
required
​
amount
integer<int32>
required
​
email
string
required
​
tx_ref
string
required

Response

OK

​
status
string
required
​
message
string
required
​
data
Data13 · object
required
Example:
{
  "id": 1163077,
  "tx_ref": "akhlm-pstmn-23452",
  "flw_ref": "FLW-M03K-781621ccfe976c03515bcd07a39f3db8",
  "redirect_url": "http://127.0.0",
  "device_fingerprint": "N/A",
  "amount": 30300,
  "charged_amount": 30300,
  "app_fee": 11741.9,
  "merchant_fee": 0,
  "processor_response": "Approved",
  "auth_model": "noauth",
  "currency": "NGN",
  "ip": "pstmn",
  "narration": "pstmn charge",
  "status": "successful",
  "payment_type": "card",
  "created_at": "2020-03-11T19:33:20.000Z",
  "account_id": 73362,
  "customer": {
    "id": 252759,
    "phone_number": "0813XXXXXXX",
    "name": "Kendrick Graham",
    "email": "user@example.com",
    "created_at": "2020-01-15T13:26:24.000Z"
  },
  "card": {
    "first_6digits": "553188",
    "last_4digits": "2950",
    "issuer": "MASTERCARD  CREDIT",
    "country": "NG",
    "type": "MASTERCARD",
    "expiry": "09/22",
    "token": "flw-t0-d0185c6edad078c9e8304c4f78b8cd5b-m03k"
  }
}