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

PHP - cURL

Sample Response

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