curl --request POST \
--url https://api.usenumero.com/numeroaccount/api/v1/wallets/{walletReference}/virtual-account \
--header 'X-Numero-Api-Key: <api-key>' \
--header 'X-Numero-Signature: <api-key>'import requests
url = "https://api.usenumero.com/numeroaccount/api/v1/wallets/{walletReference}/virtual-account"
headers = {
"X-Numero-Api-Key": "<api-key>",
"X-Numero-Signature": "<api-key>"
}
response = requests.post(url, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-Numero-Api-Key': '<api-key>', 'X-Numero-Signature': '<api-key>'}
};
fetch('https://api.usenumero.com/numeroaccount/api/v1/wallets/{walletReference}/virtual-account', 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.usenumero.com/numeroaccount/api/v1/wallets/{walletReference}/virtual-account",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"X-Numero-Api-Key: <api-key>",
"X-Numero-Signature: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.usenumero.com/numeroaccount/api/v1/wallets/{walletReference}/virtual-account"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("X-Numero-Api-Key", "<api-key>")
req.Header.Add("X-Numero-Signature", "<api-key>")
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.usenumero.com/numeroaccount/api/v1/wallets/{walletReference}/virtual-account")
.header("X-Numero-Api-Key", "<api-key>")
.header("X-Numero-Signature", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.usenumero.com/numeroaccount/api/v1/wallets/{walletReference}/virtual-account")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Numero-Api-Key"] = '<api-key>'
request["X-Numero-Signature"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"data": {
"status": "ACTION_REQUIRED",
"currency": "USD",
"verificationUrl": "<string>",
"termsUrl": "<string>",
"account": {
"reference": "<string>",
"accountName": "<string>",
"accountNumber": "<string>",
"bankName": "<string>",
"routingNumber": "<string>",
"iban": "<string>",
"bic": "<string>",
"paymentRails": [
"<string>"
]
}
},
"error": {
"code": "missing_field",
"message": "<string>",
"param": "<string>"
},
"meta": {
"request_id": "<string>",
"pagination": {
"page": 123,
"page_size": 123,
"total": 123,
"has_more": true
}
}
}Attach a virtual account to a wallet 🔒
For NGN, issue a NUBAN after the existing BVN check. For USD or EUR, use the corporate API key to start or resume verification with the verification provider for the individual customer. Show the returned verification and terms links only to that customer. Repeat this request after they complete verification or while approval is pending. Once approved, the response includes the account details. Repeating the request returns the same issued account. Only final deposits credit the customer wallet. USD and EUR customer pools currently support receiving and same-pool transfers. External payouts and merchant balance adjustments are unavailable for those pools.
curl --request POST \
--url https://api.usenumero.com/numeroaccount/api/v1/wallets/{walletReference}/virtual-account \
--header 'X-Numero-Api-Key: <api-key>' \
--header 'X-Numero-Signature: <api-key>'import requests
url = "https://api.usenumero.com/numeroaccount/api/v1/wallets/{walletReference}/virtual-account"
headers = {
"X-Numero-Api-Key": "<api-key>",
"X-Numero-Signature": "<api-key>"
}
response = requests.post(url, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-Numero-Api-Key': '<api-key>', 'X-Numero-Signature': '<api-key>'}
};
fetch('https://api.usenumero.com/numeroaccount/api/v1/wallets/{walletReference}/virtual-account', 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.usenumero.com/numeroaccount/api/v1/wallets/{walletReference}/virtual-account",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"X-Numero-Api-Key: <api-key>",
"X-Numero-Signature: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.usenumero.com/numeroaccount/api/v1/wallets/{walletReference}/virtual-account"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("X-Numero-Api-Key", "<api-key>")
req.Header.Add("X-Numero-Signature", "<api-key>")
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.usenumero.com/numeroaccount/api/v1/wallets/{walletReference}/virtual-account")
.header("X-Numero-Api-Key", "<api-key>")
.header("X-Numero-Signature", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.usenumero.com/numeroaccount/api/v1/wallets/{walletReference}/virtual-account")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Numero-Api-Key"] = '<api-key>'
request["X-Numero-Signature"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"data": {
"status": "ACTION_REQUIRED",
"currency": "USD",
"verificationUrl": "<string>",
"termsUrl": "<string>",
"account": {
"reference": "<string>",
"accountName": "<string>",
"accountNumber": "<string>",
"bankName": "<string>",
"routingNumber": "<string>",
"iban": "<string>",
"bic": "<string>",
"paymentRails": [
"<string>"
]
}
},
"error": {
"code": "missing_field",
"message": "<string>",
"param": "<string>"
},
"meta": {
"request_id": "<string>",
"pagination": {
"page": 123,
"page_size": 123,
"total": 123,
"has_more": true
}
}
}Authorizations
Base64(HMAC-SHA256(publicApiKey, input)) over the raw request body (POST) or canonicalized
query string (signed GET). Also send X-Numero-Signature-Version: v2. Required on
money-movement / state-changing endpoints (marked 🔒).
The HMAC key is your Public Key as raw UTF-8 bytes — a SECRET despite the name, and a
different value from the X-Numero-Api-Key authentication header. Signing with the API key
will never produce a valid signature.
Path Parameters
Response
NGN account details or the status of USD or EUR bank receiving