Bulk Internal Transfer

Moves balance between up to 200 customer pairs in one call. Settles synchronously in one transaction — all-or-nothing.

Body

requestReference

String

Client-supplied idempotency key. Duplicate returns 409.

transfers

*Array

Up to 200 transfer objects. Each item: { fromCustomerId, toCustomerId, channel, currency, amount, narration?, fromProvider?, toProvider? }.

POST

/ v2/wallet/transfer/internal/bulk

Endpoint URL(TEXT)

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

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

Request Body

{
  "requestReference": "batch_internal_001",
  "transfers": [
    {
      "fromCustomerId": "cus_ada",
      "toCustomerId": "cus_bola",
      "channel": "WALLET",
      "currency": "NGN",
      "amount": 1000
    }
  ]
}

{
  "requestReference": "batch_internal_001",
  "transfers": [
    {
      "fromCustomerId": "cus_ada",
      "toCustomerId": "cus_bola",
      "channel": "WALLET",
      "currency": "NGN",
      "amount": 1000
    }
  ]
}

Response(JSON)

// Click 'Try now' to see the response