Deposit to Virtual Account
Add funds to an existing virtual account. This operation requires sufficient funds in your business balance account.
Endpoint https://api.chapa.co/v1/virtual-account/credit
Method POST
Authorization: Pass your secret key as a bearer token in the request header to authorize this call.
Request Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
| account_number | Yes | string | The unique identifier of the virtual account to be credited |
| amount | Yes | number | Amount to be deposited into the virtual account |
| tx_ref | No | string | Your reference for this credit transaction (optional) |
| note | No | string | Reference or description for the deposit transaction |
{
"account_number": "1234567890",
"amount": 1000,
"tx_ref": "REF_1234",
"note": "Deposit for February 2025"
}Response Parameters
| Parameter | Type | Description |
|---|---|---|
| status | string | Status of the request (success/error) |
| message | string | Description of the operation result |
| data.account.account_name | string | Name associated with the virtual account |
| data.account.account_number | number | Unique identifier of the virtual account |
| data.account.account_alias | string | Custom reference name for the account |
| data.account.balance | number | Current balance after credit |
| data.account.status | string | Current status of the account |
| data.account.currency | string | Currency of the account |
| data.account.created_at | string | Timestamp of account creation |
| data.account.updated_at | string | Timestamp of last account update |
| data.transaction.tx_ref | string | Your reference for this credit transaction |
| data.transaction.note | string | Description provided for the credit |
| data.transaction.type | string | The type of transaction (credit/debit) |
| data.transaction.amount | number | Amount credited in this transaction |
| data.transaction.currency | string | Currency of the credit |
| data.transaction.created_at | string | Timestamp of the credit transaction |
import requestsimport jsonurl = "https://api.chapa.co/v1/virtual-account/credit"payload = json.dumps({ "account_number": "100314252", "amount": 20, "tx_ref": "VTkVnh5ScB", "note": "Connecting Ethiopia to the Global Market"})headers = { 'Authorization': 'Bearer CHASECK-xxxxxxxxxxxxxxxx', 'Content-Type': 'application/json'}response = requests.post(url, headers=headers, data=payload)print(response.text)ℹ️
Your business balance must have sufficient funds to process the deposit successfully.