Bulk External Transfer

Moves balance from your customer wallets to customer wallets of any builder — many recipients in one call. All-or-nothing validation with cross-item balance checks.

Body

requestReference

String

Optional idempotency key for the whole batch.

transfers

*Array

Up to 200 transfer objects. Each item: { fromWalletId, toWalletId, amount, narration? }. Both wallets must share channel, currency and environment.

POST

/ v2/wallet/transfer/external/bulk

Endpoint URL(TEXT)

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

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

Request Body

{
  "requestReference": "payouts_aug_01",
  "transfers": [
    {
      "fromWalletId": "cwlt_ada_001",
      "toWalletId": "cwlt_beta_001",
      "amount": 2500,
      "narration": "Invoice INV-0042"
    }
  ]
}

{
  "requestReference": "payouts_aug_01",
  "transfers": [
    {
      "fromWalletId": "cwlt_ada_001",
      "toWalletId": "cwlt_beta_001",
      "amount": 2500,
      "narration": "Invoice INV-0042"
    }
  ]
}

Response(JSON)

// Click 'Try now' to see the response