Bulk Bank Transfer

Debits up to 200 customer wallets and disburses each to a bank account in one call. All-or-nothing validation — if any item is invalid the whole batch is rejected before anything is debited.

Body

requestReference

String

Client-supplied idempotency key for the whole batch. Duplicate returns 409.

transfers

*Array

Up to 200 transfer objects. Each item: { customerId, channel, currency, amount, accountNumber, bankCode, accountName, narration?, provider? }.

POST

/ v2/wallet/transfer/bulk

Endpoint URL(TEXT)

https://api.sandbox.switch.tulupay.com/v2/wallet/transfer/bulk

https://api.sandbox.switch.tulupay.com/v2/wallet/transfer/bulk

Request Body

{
  "requestReference": "payroll_aug_2026",
  "transfers": [
    {
      "customerId": "cus_ada",
      "channel": "WALLET",
      "currency": "NGN",
      "amount": 5000,
      "accountNumber": "0123456789",
      "bankCode": "058",
      "accountName": "John Doe"
    }
  ]
}

{
  "requestReference": "payroll_aug_2026",
  "transfers": [
    {
      "customerId": "cus_ada",
      "channel": "WALLET",
      "currency": "NGN",
      "amount": 5000,
      "accountNumber": "0123456789",
      "bankCode": "058",
      "accountName": "John Doe"
    }
  ]
}

Response(JSON)

// Click 'Try now' to see the response