With Chapa Transfer API, you can send money to bank accounts from your balance. To send money on Chapa, you need API keys to authenticate your transfers. You can find your keys on the Chapa Dashboard under Settings->API
Note You need to collect the customer’s account details and confirm that it’s valid before sending money. This is to ensure you don’t send money to the wrong or invalid account. We don’t take any responsibility if this happens.
List banks
This section describes how to get bank details for all supported banks we are working with. This API returns all the Banks information for all currencies.
Endpoint https://api.chapa.co/v1/banks
Method GET
Headers
Authorization* : Pass your secret key as a bearer token in the request header to authorize this call.
Sample Code
Refer to our Response List page for all responses for this request.
Initiate a Transfer
This section describes how to Initate a transfer with Chapa.
Endpoint https://api.chapa.co/v1/transfers
Method POST
Body Parameters
account_name*: This is the recipient Account Name matches on their bank account.account_number*: This is the recipient Account Number.amount*: This the amount to be transferred to the recipient.beneficiary_name: This is the full name of the Transfer beneficiary (You may use it to match on your required).currency*: This is the currency for the Transfer. Expected value is ETB.-
reference*: This a merchant’s uniques reference for the transfer, it can be used to query for the status of the transfer. bank_code*: This is the recipient bank code. You can see a list of all the available banks and their codes from the get banks endpoint.
Headers
Authorization*: Pass your secret key as a bearer token in the request header to authorize this call.
Sample Code
Refer to our Response List page for all responses for this request.
Note: You need to have enough balance in your Available Balance to make a transfer. If your balance is less than the requested transfer amount, we will reject the transfer, if this persists we will block access to the transfer API.
