Internal Transfer

Moves balance from one of your customers to another. No bank rails — settles synchronously and atomically. Supports splitting across wallets when no single wallet covers the amount.

Body

fromCustomerId

*String

Customer to debit (must belong to your builder account).

toCustomerId

*String

Customer to credit (must belong to your builder account).

channel

*String

Channel — use "WALLET".

currency

*String

3-letter ISO currency code.

amount

*Number

Amount to move in major units.

narration

String

Optional description recorded on both sides.

fromProvider

String

Provider backing the sender's wallet. Omit to auto-use their richest wallet that covers the amount.

toProvider

String

Provider backing the recipient's wallet. Omit to use the sender's provider, falling back to any of their active wallets.

requestReference

String

Idempotency key.

POST

/ v2/wallet/transfer/internal

Endpoint URL(TEXT)

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

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

Request Body

{
  "fromCustomerId": "cus_ada",
  "toCustomerId": "cus_bola",
  "channel": "WALLET",
  "currency": "NGN",
  "amount": 450
}

{
  "fromCustomerId": "cus_ada",
  "toCustomerId": "cus_bola",
  "channel": "WALLET",
  "currency": "NGN",
  "amount": 450
}

Response(JSON)

// Click 'Try now' to see the response