Direct Transfer
Transfer funds directly to Ethiopian bank accounts using our secure transfer API.
POST
/api/v1/transfersInitiate a transfer to any supported Ethiopian bank account or mobile wallet.
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
account_number | string | Yes | Recipient's account number (bank or mobile wallet) |
amount | number | Yes | Amount to transfer |
phone_number | string | No | Recipient's phone number |
account_name | string | No | Recipient's account holder name |
payment_method_code | string | No | Payment method (e.g., telebirr, cbe) |
currency_code | string | No | Currency code (defaults to ETB) |
description | string | No | Transfer description/memo |
custom_ref | string | No | Your unique transaction reference |
callback_url | string | No | URL for transfer status webhook notifications |
Supported Bank Codes
CBE
Commercial Bank of Ethiopia
DASHEN
Dashen Bank
AWASH
Awash Bank
ABYSSINIA
Bank of Abyssinia
TELEBIRR
Telebirr
COOP
Cooperative Bank of Oromia
UNITED
United Bank
NIB
Nib International Bank
Code Example
Response
Success Response
{
"status": "successful",
"message": "Transfer initiated successfully"
}Transfer Status Values
| Status | Description |
|---|---|
| pending | Transfer is being processed |
| completed | Transfer was successful |
| failed | Transfer could not be completed |
| reversed | Transfer was reversed |
Important Notes
- Transfers are processed in real-time during banking hours (8 AM - 5 PM EAT)
- Always verify the account name before initiating large transfers
- Use unique reference IDs to prevent duplicate transfers
- Set up webhooks to receive real-time transfer status updates
Last updated on