Bulk Transfers

You can send money to multiple recipients in one go using the Chapa’s bulk transfers API.

How to make a bulk payment

To do this, you’ll provide an array of objects called e bulk_data. Each item in this array contains details for one transfer—the same details you specify when making a single transfer.

You can also specify a title for the transfer. This is helpful so you can easily identify what a set of payments was for.

Keep in Mind!!!!

Each object in the bulk_data array is the same parameters for a single transfer request. A batch should not contain more than 100 items and each batch should be sent every 5 seconds. The duration is to avoid getting rate limited. Sending multiple requests at short intervals would lead to a 429 (Too many requests) error.

With your batch properly planned and implemented, you can now initiate the bulk transfer.

Here is a sample code for bulk transactions:

Endpoint https://api.chapa.co/v1/bulk-transfers

Method POST

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

1import requests
2  import json
3
4  url = "https://api.chapa.co/v1/bulk-transfers"
5
6  payload = json.dumps({
7    "title": "This Month Salary!",
8    "currency": "ETB",
9    "bulk_data": [
10      {
11  "account_name": "Israel Goytom",
12  "account_number": "09xxxxxxxx",
13  "amount": 1,
14  "reference": "b1111124",
15  "bank_code": 128
16      },
17      {
18  "account_name": "Israel Goytom",
19  "account_number": "09xxxxxxxx",
20  "amount": 1,
21  "reference": "b2222e5r",
22  "bank_code": 128
23      }
24    ]
25  })
26  headers = {
27    'Content-Type': 'application/json',
28    'Authorization': 'Bearer CHASECK-xxxxxxxxxxxxxxxx'
29  }
30
31  response = requests.request("POST", url, headers=headers, data=payload)
32
33  print(response.text)
34  

The transfers will be queued for processing, which usually take between a few seconds.

Checking the status

You can also check the status of a bulk transfer manually using the get all transfers endpoint with a batch_id query parameter. The batch_id is the data.id returned from the create bulk transfer response:

Here is a sample code for checking the status:

Endpoint https://api.chapa.co/v1/transfers?batch_id=<id>

Method GET

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

1import requests
2    
3      url = "https://api.chapa.co/v1/transfers?batch_id=1"
4      
5      payload = ""
6      headers = {
7        'Authorization': 'Bearer CHASECK-xxxxxxxxxxxxxxxx'
8      }
9      
10      response = requests.request("GET", url, headers=headers, data=payload)
11      
12      print(response.text)
13      
14