Skip to main content
POST
/
bulk-tokenized-charges
Create Bulk Tokenized Charge
curl --request POST \
  --url https://api.flutterwave.com/v3/bulk-tokenized-charges \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "akhlm blk tknzd chrg pstmn tst 1",
  "retry_strategy": {
    "retry_interval": 120,
    "retry_amount_variable": 60,
    "retry_attempt_variable": 2
  },
  "bulk_data": [
    {
      "currency": "NGN",
      "token": "flw-t1nf-f9b3bf384cd30d6fca42b6df9d27bd2f-m03k",
      "country": "NG",
      "amount": 3500,
      "email": "user@example.com",
      "first_name": "Example",
      "last_name": "User",
      "ip": "pstmn",
      "tx_ref": "akhlm-pstmn-blkchrg-xy10"
    },
    {
      "currency": "NGN",
      "token": "flw-t1nf-f9b3bf384cd30d6fca42b6df9d27bd2f-m03k",
      "country": "NG",
      "amount": 3000,
      "email": "user@example.com",
      "first_name": "Jane",
      "last_name": "Doe",
      "ip": "pstmn",
      "tx_ref": "akhlm-pstmn-blkchrge-xx10"
    }
  ]
}
'
{
  "status": "success",
  "message": "Bulk charge initiated",
  "data": {
    "id": 156,
    "created_at": "2020-03-12T16:04:40.000Z",
    "approver": "N/A",
    "title": "akhlm blk tknzd chrg pstmn tst 1",
    "total_charges": 2,
    "pending_charges": 2,
    "processed_charges": 0
  }
}

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
title
string
required
​
retry_strategy
RetryStrategy · object
required
Example:
{
  "retry_interval": 120,
  "retry_amount_variable": 60,
  "retry_attempt_variable": 2
}
​
bulk_data
BulkDatum · object[]
required

Response

OK

​
status
string
required
​
message
string
required
​
data
Data14 · object
required
Example:
{
  "id": 156,
  "created_at": "2020-03-12T16:04:40.000Z",
  "approver": "N/A",
  "title": "akhlm blk tknzd chrg pstmn tst 1",
  "total_charges": 2,
  "pending_charges": 2,
  "processed_charges": 0
}