Tembo
  • Welcome!
  • Introduction
  • Reference
    • Merchant Virtual Accounts
      • Create Merchant Virtual Account
      • Get Account Balance
      • Get Account Statement
      • Webhook Callback
    • Banking & Wallets
      • Create Wallet
      • Deposit Funds
      • Withdraw Funds
      • Wallet to Wallet Transfer
      • Wallet Balance
      • Wallet Statement
      • Main Balance
      • Main Statement
      • List Wallets
    • Make Payment
      • Pay to Mobile
      • Pay to Other Banks
      • Utility Payments
      • Payment Status
    • Collect Money
      • Collect from Mobile Money
      • Collection Balance
      • Collection Statement
      • Payment Status
    • eKYC
      • Start Onboarding
      • Retrieve First Question
      • Reply to Question
    • Remittance
      • API Overview
      • Create Remittance
      • Transaction Status
      • Callback Notification
Powered by GitBook
On this page
  1. Reference
  2. Merchant Virtual Accounts

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.

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "accountName": "TEMBOPLUS COMPANY LIMITED",
  "accountNo": "0560066551200",
  "reference": "VT87038HZS"
}
{
  "companyName": "\"companyName\" cannot be empty"
}
{
  "message": "DUPLICATE REFERENCE",
  "error": "Conflict",
  "statusCode": 409
}
{
  "message": "DUPLICATE COMPANY NAME",
  "error": "Conflict",
  "statusCode": 409
}
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"
  }'
PreviousMerchant Virtual AccountsNextGet Account Balance