Create USD Account

This endpoint allows the request USD virtual account for a customer. This returns a tracking ID which will be used to check the status of your account request.

To create a USD account for the customer, the customer must be fully enrolled using the create customer endpoint, which in turn returns a tracking/customer ID to be used in your USD virtual account request. Check here

POST {{base_url}}/business/create-globalaccount

Headers

Name	Type	Description
authorization*	String	SECRET_KEY

Request Body

Name	Type	Description
customerid*	String	Customer tracking ID returned from the fully kyc create customer endpoint. See here
monthly_volume*	String	What is the expected monthly volume of payments the customer will be sending or receiving? Expected value must be any of the following; e.g 0_4999, 5000_9999, 10000_49999, 50000_plus
source_of_funds*	String	The customer source of funds. Available options: company_funds, ecommerce_reseller, gambling_proceeds, gifts, government_benefits, inheritance, investments_loans, pension_retirement, salary, sale_of_assets_real_estate, savings, someone_elses_funds ​
expected_montly_fund*	String	What is the expected monthly volume of payments the customer will be sending or receiving? Available options: 0_4999, 5000_9999, 10000_49999, 50000_plus
account_purpose*	String	What is the primary purpose of requesting for the account by the customer? Available options: charitable_donations, ecommerce_retail_payments, investment_purposes, operating_a_company, other, payments_to_friends_or_family_abroad, personal_or_living_expenses, protect_wealth, purchase_goods_and_services, receive_payment_for_freelancing, receive_salary
account_type*	String	Type of account requesting for. Available option: USD, EUR
occupation*	String	What is the customer's most recent occupation? See here the list of occupations
pepstatus*	Boolean	Is customer a politically exposed individual. Is the customer associated with any politician? Available options: true, false
agreeto_term*	Boolean	Does the customer accept our term of use of this account? Available options: true, false
proof_of_address	String	URL to the customer uploaded proof of address. e.g Eletricity bill

Take a look at how you might do this:

cURL

curl --location ' {{base_url}}/business/create-globalaccount' \
--header 'Authorization: BEARER SECRET_KEY' \
--data '{
  "customerid": "BLD12211916",
  "monthly_volume": "0_4999",
  "pepstatus": false,
  "source_of_funds": "gifts",
  "expected_montly_fund": "0_4999", 
  "account_purpose": "payments_to_friends_or_family_abroad", 
  "agreeto_term": true,
  "account_type": "USD",
  "occupation": "Software Engineer",
  "proof_of_address": "https://res.cloudinary.com/site/image/upload/v1714257348/idcard2.png"
}'

NodeJS

var request = require('request');
var options = {
  'method': 'POST',
  'url': '{{base_url}}/business/create-globalaccount',
  'headers': {
    'Authorization': 'BEARER SECRET_KEY'
  },
  body: '{
  "customerid": "BLD12211916",
  "monthly_volume": "0_4999",
  "pepstatus": false,
  "source_of_funds": "gifts",
  "expected_montly_fund": "0_4999", 
  "account_purpose": "payments_to_friends_or_family_abroad", 
  "agreeto_term": true,
  "account_type": "USD",
  "occupation": "Software Engineer",
  "proof_of_address": "https://res.cloudinary.com/site/image/upload/v1714257348/idcard2.png"
}'

};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

PHP - cURL

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => '{{base_url}}/business/create-globalaccount',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
  "customerid": "BLD12211916",
  "monthly_volume": "0_4999",
  "pepstatus": false,
  "source_of_funds": "gifts",
  "expected_montly_fund": "0_4999", 
  "account_purpose": "payments_to_friends_or_family_abroad", 
  "agreeto_term": true,
  "account_type": "USD",
  "occupation": "Software Engineer",
  "proof_of_address": "https://res.cloudinary.com/site/image/upload/v1714257348/idcard2.png"
}',
  CURLOPT_HTTPHEADER => array(
    'Authorization: BEARER SECRET_KEY'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Sample Response

{
  "status": true,
  "message": "Your USD account request has been submitted successfully. You will be notified once it's ready.",
  "tracking": "DLE23210UA24400"
 
}