Bank Transfer

Debits the customer wallet and disburses funds to a bank account. The wallet is debited immediately; the payout is confirmed asynchronously via webhook. If the provider transfer fails, the wallet is automatically refunded.

Body

customerId

*String

ID of the customer whose wallet to debit.

channel

*String

Channel — use "WALLET".

currency

*String

3-letter ISO currency code.

amount

*Number

Amount to transfer in major units.

accountNumber

*String

Recipient bank account number.

bankCode

*String

Bank code from GET /v2/wallet/banks.

accountName

*String

Recipient account name (from name-enquiry).

narration

String

Optional narration on the recipient's bank statement.

provider

String

Provider for disbursement. Omit to auto-select the customer wallet with sufficient balance.

requestReference

String

Idempotency key — re-submitting the same key returns 409 instead of moving money twice.

POST

/ v2/wallet/transfer

Endpoint URL(TEXT)

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

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

Request Body

{
  "customerId": "cus_ada",
  "channel": "WALLET",
  "currency": "NGN",
  "amount": 200,
  "accountNumber": "0123456789",
  "bankCode": "058",
  "accountName": "John Doe",
  "narration": "Rent payment"
}

{
  "customerId": "cus_ada",
  "channel": "WALLET",
  "currency": "NGN",
  "amount": 200,
  "accountNumber": "0123456789",
  "bankCode": "058",
  "accountName": "John Doe",
  "narration": "Rent payment"
}

Response(JSON)

// Click 'Try now' to see the response