Create Virtual Account

Issues a fresh, single-use virtual NUBAN for one payment. Give the customer the returned accountNumber + bankName and have them transfer the amount. When the money lands, the checkout is marked PAID and the account is auto-deactivated.

Body

provider

*String

Provider to issue the one-time account from. One of: "Paystack", "Flutterwave", "Seerbit", "PayRep".

currency

*String

3-letter ISO currency code (e.g. NGN).

amount

*Number

Expected payment amount in major units.

reference

String

Your checkout/order reference. Auto-generated if omitted.

customerId

String

If provided, the customer's wallet is credited automatically when money lands.

firstName

String

Override the account name (defaults to the merchant name).

lastName

String

Override the account last name.

String

Customer email.

preferredBank

String

Paystack: wema-bank | titan-paystack. Flutterwave: flutterwave-mfb | wema-bank.

bvn

String

BVN required by some providers/banks.

expiresInMinutes

Number

Account lifetime in minutes (max 10080). Default 120.

POST

/ v2/checkout/accounts

Endpoint URL(TEXT)

https://api.sandbox.switch.tulupay.com/v2/checkout/accounts

https://api.sandbox.switch.tulupay.com/v2/checkout/accounts

Request Body

{
  "provider": "Paystack",
  "currency": "NGN",
  "amount": 12000,
  "reference": "ord_001",
  "customerId": "cus_ada"
}

{
  "provider": "Paystack",
  "currency": "NGN",
  "amount": 12000,
  "reference": "ord_001",
  "customerId": "cus_ada"
}

Response(JSON)

// Click 'Try now' to see the response