API Reference

Create a virtual account

post
https://api.balampay.com/sandbox/v1/virtual-accounts

Creates a new virtual account for a user.

Account Modes:

  • Crypto Mode: Provide a destination to auto-convert deposits to crypto
  • Fiat Mode: Omit destination to hold USD balance

Bank Selection:

  • portage - For non-US based users
  • austin_capital_trust - For US-based users
  • slovak_savings_bank - Sandbox only

Authentication: Both x-api-key header and Authorization: Bearer <token> header are required.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
uuid
required

UUID of the user

string
enum
required

Type of virtual account

Allowed:
string
enum

Bank provider (required for US_BANK). Note: lead_bank is no longer supported.

Allowed:
destination
object

Crypto destination wallet (omit for fiat mode)

Headers
uuid
required

Unique key to ensure idempotent requests

Responses

Updated 3 months ago

Did this page help you?
Language
Credentials
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 3 months ago

Did this page help you?