Direct Transfer

Transfer funds directly to Ethiopian bank accounts using our secure transfer API.

POST/api/v1/transfers/bank

Initiate a direct bank transfer to any supported Ethiopian bank account.

Request Parameters

Parameter	Type	Required	Description
`bank_code`	string	Yes	Bank identifier code (e.g., CBE, DASHEN)
`account_number`	string	Yes	Recipient's bank account number
`account_name`	string	Yes	Recipient's account holder name
`amount`	number	Yes	Amount to transfer (minimum 10 ETB)
`reference`	string	Yes	Your unique transaction reference
`narration`	string	No	Transfer description/memo
`callback_url`	string	No	URL for transfer status 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": "success",
  "message": "Transfer initiated successfully",
  "data": {
    "transfer_id": "TRF_abc123def456",
    "reference": "TRF_123456789",
    "bank_code": "CBE",
    "account_number": "1000012345678",
    "account_name": "John Doe",
    "amount": 1000,
    "fee": 15,
    "total_amount": 1015,
    "currency": "ETB",
    "status": "pending",
    "narration": "Salary payment",
    "created_at": "2024-01-15T10:30:00Z"
  }
}

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