This is the endpoint that allows a wallet transfer to multiple wallets.

Request Message Description

Field#	Field name	Data type	Required	Max Length	Description	Options
1	txnRef	String	yes		transaction reference
2	walletIdType	String	yes		wallet identifier type
3	walletId	String	yes		wallet identifier
4	amount	String	yes
5	channel	String	yes	30	channel sending request	“WEB” or “USSD” or “SERVICE” or “MOBILE”
6	encryptedPin	String	yes		encrypted Pin of the source wallet
7	domain	String	no		wallet domain

Endpoint

Base URL : https://api-gateway.interswitchng.com

Request: POST  /generic-wallet/api/v1/transaction/transfer/bulk

Header

Content-Type: application/json
Authorization: {passport generated bearer token}

Sample Request

{
"txnRef": "70039202",
"walletIdType": "PHONE",
"walletId": "2348039609278",
"channel": "SERVICE",
"otp": "236959",
"domain": "ISW",
"encryptedPin": "929aed1a3c05e21b81b1937d25934dc6",
"beneficiaryWallets": [
{
"walletIdType": "phone",
"walletId": "08039609278",
"domain":"VER",
"amount": "10"
},
{
"walletIdType": "phone",
"walletId": "08039609278",
"amount": "100000"
}
]
}

Sample Response (success)

{
"statusCode": "200",
"responseCode": "00",
"responseMessage": "Successful",
"errors": null,
"modelList": [
{
"statusCode": "200",
"responseCode": "00",
"responseMessage": "Approved or completed successfully",
"errors": null,
"modelList": null,
"count": 0,
"walletId": "2348039609278",
"walletIdType": "phone"
},
{
"statusCode": "200",
"responseCode": "00",
"responseMessage": "Approved or completed successfully",
"errors": null,
"modelList": null,
"count": 0,
"walletId": "2348039609278",
"walletIdType": "phone"
}
],
"count": 2
}