Virtual AccountCreate Virtual Account

Create Virtual Account

Create a new virtual account with optional initial deposit. This API is restricted to pre-approved businesses.

Endpoint https://api.chapa.co/v1/virtual-account

Method POST

  • Authorization: Pass your secret key as a bearer token in the request header to authorize this call.

Request Parameters

ParameterRequiredTypeDescription
account_nameYesstringThe name associated with the virtual account
initial_depositNonumberInitial amount to deposit. Account created with zero balance if not provided
account_aliasNostringCustom alias for easy reference
{
  "account_name": "Abebe Bikila",
  "initial_deposit": 1000,
  "account_alias": "JD_VA"
}
import requestsimport jsonurl = "https://api.chapa.co/v1/virtual-account"payload = json.dumps({  "account_name": "SEMER NUR",  "initial_deposit": 20,  "account_alias": "4242424"})headers = {  'Authorization': 'Bearer CHASECK-xxxxxxxxxxxxxxxx',  'Content-Type': 'application/json'}response = requests.post(url, headers=headers, data=payload)print(response.text)

ℹ️

If specifying an initial_deposit, your business balance must have sufficient funds to cover the amount.