Bulk Transfer
Overview
This operation is used to perform a bulk transfer to accounts, cards or mobile from one source to different destination accounts in various banks. For Bulk Transfer, batch limit is 500 records per transaction batch (bulk items)
The following validation would be performed for the bulkTransfer Operation
- That the total amount is equal to the bulk items amount.
- The unique ids must be unique for the bulk items so avoid duplicates.
- The bulk reference must be unique.
- Validation of Company ID.
- If a mobile number is not on pocketmoni, it will be created automatically
- Sample Request
- Sample Response
POST / bulk-transfer
curl `${baseurl}/bulk-transfer`
-H "Content-type: application/json"
-X POST
-d '{
"action": "BT",
"terminalId": "7000000001",
"transaction": {
"companyId": "TestCompanyID",
"pin": "kghxqwveJ3eSQJip/cmaMQ==",
"amount": 15,
"reference": "{{$randomPhoneNumber}}",
"senderName": "Test Accounts",
"endPoint": "A",
"terminalCard": false,
"bulkItems": {
"bulkItem": [
{
"uniqueId": "BTTestBT04",
"bankCode": "011",
"accountId": "3028875212",
"beneficiaryName": "Peter Azuka",
"narration": "narration",
"amount": 5.0
},
{
"uniqueId": "BTTestBT05",
"bankCode": "033",
"accountId": "2125347370",
"beneficiaryName": "Peter Azuka",
"narration": "narration",
"amount": 5.0
},
{
"uniqueId": "BTTestBT06",
"bankCode": "058",
"accountId": "0129915440",
"beneficiaryName": "Peter Azuka",
"narration": "narration",
"amount": 5.0
}
]
}
}
}
'
POST / bulk-transfer
{
"direction": "response",
"reference": "09FG2110141524400822WKY9A",
"companyId": null,
"date": null,
"amount": 0,
"totalFailed": 0,
"totalSuccess": 0,
"error": "0",
"message": "Transaction Successful",
"bulkItems": null,
"otherReference": "reference-958239",
"action": "BT",
"bankCode": null
}