Create Merchant Virtual Account

POST https://sandbox.temboplus.com/account

This endpoint allows merchants to create a new virtual account for payment collection. When creating a virtual account, you need to provide your company name and a unique reference that will help you track and reconcile transactions. Each virtual account created will have a unique account number that can be shared with your customers for making payments.

Headers

Name	Type	Description
Content-Type	string	Must be set to application/json for all requests
Authorization*	string	Authentication token in the format: Bearer <token>
x-request-id*	string	A UUID that uniquely identifies each request

Request Body

Name	Type	Description
companyName*	string	The name of the company opening the merchant virtual account. Cannot be empty.
reference*	string	A unique reference provided by the requester to track the account. Cannot be empty.

Response Fields

Name	Type	Description
id	string	Unique identifier for the merchant virtual account (UUID).
accountName	string	The name of the merchant virtual account.
accountNo	string	The number assigned to the merchant virtual account.
reference	string	The unique reference provided in the request.

201 Account successfully created

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "accountName": "TEMBOPLUS COMPANY LIMITED",
  "accountNo": "0560066551200",
  "reference": "VT87038HZS"
}

400 Bad Request Validation error

{
  "companyName": "\"companyName\" cannot be empty"
}

409 Duplicate Reference

{
  "message": "DUPLICATE REFERENCE",
  "error": "Conflict",
  "statusCode": 409
}

409 Duplicate Company Name

{
  "message": "DUPLICATE COMPANY NAME",
  "error": "Conflict",
  "statusCode": 409
}

409 No Available Accounts

{
  "message": "NO_AVAILABLE_ACCOUNTS",
  "error": "Conflict",
  "statusCode": 409
}

Curl

curl --request POST \
  --url https://sandbox.temboplus.com/account \
  --header 'content-type: application/json' \
  --header 'Authorization: Bearer YOUR_AUTH_TOKEN' \
  --header 'x-request-id: 550e8400-e29b-41d4-a716-446655440000' \
  --data '{
     "companyName": "TEMBOPLUS COMPANY LIMITED",
     "reference": "VT87038HZS"
  }'