Create Bulk Virtual Account Numbers

curl --request POST \
  --url https://api.flutterwave.com/v3/bulk-virtual-account-numbers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "accounts": 3,
  "email": "user@gmail.com",
  "is_permanent": true,
  "tx_ref": "Sample_tx_ref"
}
'

import requests

url = "https://api.flutterwave.com/v3/bulk-virtual-account-numbers"

payload = {
    "accounts": 3,
    "email": "user@gmail.com",
    "is_permanent": True,
    "tx_ref": "Sample_tx_ref"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    accounts: 3,
    email: 'user@gmail.com',
    is_permanent: true,
    tx_ref: 'Sample_tx_ref'
  })
};

fetch('https://api.flutterwave.com/v3/bulk-virtual-account-numbers', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.flutterwave.com/v3/bulk-virtual-account-numbers",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'accounts' => 3,
    'email' => 'user@gmail.com',
    'is_permanent' => true,
    'tx_ref' => 'Sample_tx_ref'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.flutterwave.com/v3/bulk-virtual-account-numbers"

	payload := strings.NewReader("{\n  \"accounts\": 3,\n  \"email\": \"user@gmail.com\",\n  \"is_permanent\": true,\n  \"tx_ref\": \"Sample_tx_ref\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.flutterwave.com/v3/bulk-virtual-account-numbers")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"accounts\": 3,\n  \"email\": \"user@gmail.com\",\n  \"is_permanent\": true,\n  \"tx_ref\": \"Sample_tx_ref\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.flutterwave.com/v3/bulk-virtual-account-numbers")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"accounts\": 3,\n  \"email\": \"user@gmail.com\",\n  \"is_permanent\": true,\n  \"tx_ref\": \"Sample_tx_ref\"\n}"

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "message": "Bulk virtual accounts creation queued",
  "data": {
    "batch_id": "-RND_2641579516055928",
    "response_code": "02",
    "response_message": "Request added to Queue"
  }
}

{
  "status": "error",
  "message": "Validation error: BVN or NIN is required for static account number",
  "data": null
}

POST

bulk-virtual-account-numbers

Create Bulk Virtual Account Numbers

curl --request POST \
  --url https://api.flutterwave.com/v3/bulk-virtual-account-numbers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "accounts": 3,
  "email": "user@gmail.com",
  "is_permanent": true,
  "tx_ref": "Sample_tx_ref"
}
'

import requests

url = "https://api.flutterwave.com/v3/bulk-virtual-account-numbers"

payload = {
    "accounts": 3,
    "email": "user@gmail.com",
    "is_permanent": True,
    "tx_ref": "Sample_tx_ref"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    accounts: 3,
    email: 'user@gmail.com',
    is_permanent: true,
    tx_ref: 'Sample_tx_ref'
  })
};

fetch('https://api.flutterwave.com/v3/bulk-virtual-account-numbers', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.flutterwave.com/v3/bulk-virtual-account-numbers",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'accounts' => 3,
    'email' => 'user@gmail.com',
    'is_permanent' => true,
    'tx_ref' => 'Sample_tx_ref'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.flutterwave.com/v3/bulk-virtual-account-numbers"

	payload := strings.NewReader("{\n  \"accounts\": 3,\n  \"email\": \"user@gmail.com\",\n  \"is_permanent\": true,\n  \"tx_ref\": \"Sample_tx_ref\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.flutterwave.com/v3/bulk-virtual-account-numbers")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"accounts\": 3,\n  \"email\": \"user@gmail.com\",\n  \"is_permanent\": true,\n  \"tx_ref\": \"Sample_tx_ref\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.flutterwave.com/v3/bulk-virtual-account-numbers")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"accounts\": 3,\n  \"email\": \"user@gmail.com\",\n  \"is_permanent\": true,\n  \"tx_ref\": \"Sample_tx_ref\"\n}"

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "message": "Bulk virtual accounts creation queued",
  "data": {
    "batch_id": "-RND_2641579516055928",
    "response_code": "02",
    "response_message": "Request added to Queue"
  }
}

{
  "status": "error",
  "message": "Validation error: BVN or NIN is required for static account number",
  "data": null
}

Authorizations

Authorization

string

header

required

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

Body

application/json

accounts

integer<int32>

required

string

required

is_permanent

boolean

required

tx_ref

string

required

Response

status

string

required

message

string

required

data

Data48 · object

required

Show child attributes

Example:

{
  "batch_id": "-RND_2641579516055928",
  "response_code": "02",
  "response_message": "Request added to Queue"
}

API Documentation

Charges

Tokenized Charges

Preauthorization

Transactions

Transfers

Beneficiaries

Virtual Cards

Virtual Account Numbers

Collection Subaccounts

Payout Subaccounts

Subscriptions

Payment Plans

Bill Payments

Banks

Misc

Settlements

Otps

Chargebacks

Create Bulk Virtual Account Numbers

Authorizations

Body

Response