Virtual Accounts

List Virtual Accounts

Retrieve all virtual accounts for a receiver.

const response = await blindpay.virtualAccounts.list(receiver_id);

receiver_id

string

required

The unique identifier of the receiver

data

array

Array of virtual account objects

Show Virtual Account Object

string

Unique identifier for the virtual account

banking_partner

BankingPartner

Banking partner providing the account (jpmorgan, citi, or hsbc)

kyc_status

string

KYC verification status of the account

object

US banking details

Show US Details

ach

object

ACH transfer details

Show ACH

routing_number

string

ACH routing number

account_number

string

ACH account number

wire

object

Wire transfer details

Show Wire

routing_number

string

Wire routing number

account_number

string

Wire account number

rtp

object

Real-time payment details

Show RTP

routing_number

string

RTP routing number

account_number

string

RTP account number

swift_bic_code

string

SWIFT/BIC code for international transfers

account_type

string

Type of bank account

beneficiary

object

Beneficiary information

Show Beneficiary

name

string

Beneficiary name

address_line_1

string

First line of beneficiary address

address_line_2

string

Second line of beneficiary address

receiving_bank

object

Receiving bank information

Show Receiving Bank

name

string

Bank name

address_line_1

string

First line of bank address

address_line_2

string

Second line of bank address

token

StablecoinToken

Stablecoin token type (USDC, USDT, or USDB)

blockchain_wallet_id

string

ID of the linked blockchain wallet

blockchain_wallet

object | null

Linked blockchain wallet details

Show Blockchain Wallet

network

Network

Blockchain network

address

string

Wallet address

Get Virtual Account

Retrieve a specific virtual account by ID.

const response = await blindpay.virtualAccounts.get({
  receiver_id: "rcv_123",
  id: "va_123"
});

receiver_id

string

required

The unique identifier of the receiver

string

required

The unique identifier of the virtual account

data

object

Virtual account object with the same structure as described in List Virtual Accounts

Create Virtual Account

Create a new virtual account linked to a blockchain wallet.

const response = await blindpay.virtualAccounts.create({
  receiver_id: "rcv_123",
  banking_partner: "jpmorgan",
  token: "USDC",
  blockchain_wallet_id: "wallet_123",
  signed_agreement_id: "agreement_123"
});

receiver_id

string

required

The unique identifier of the receiver

banking_partner

BankingPartner

required

Banking partner to use (jpmorgan, citi, or hsbc)

token

StablecoinToken

required

Stablecoin token type (USDC, USDT, or USDB)

blockchain_wallet_id

string

required

ID of the blockchain wallet to link

signed_agreement_id

string | null

Optional ID of the signed agreement

data

object

Virtual account object with the same structure as described in List Virtual Accounts

Update Virtual Account

Update a virtual account’s token and blockchain wallet configuration.

const response = await blindpay.virtualAccounts.update({
  receiver_id: "rcv_123",
  id: "va_123",
  token: "USDT",
  blockchain_wallet_id: "wallet_456"
});

receiver_id

string

required

The unique identifier of the receiver

string

required

The unique identifier of the virtual account to update

token

StablecoinToken

required

Updated stablecoin token type (USDC, USDT, or USDB)

blockchain_wallet_id

string

required

Updated blockchain wallet ID to link

data

void

No data returned on successful update

Client

Receivers

Payments

Wallets & Accounts

Instance Management

Utilities

List Virtual Accounts

Get Virtual Account

Create Virtual Account

Update Virtual Account

Build docs developers (and LLMs) love

Client

Receivers

Payments

Wallets & Accounts

Instance Management

Utilities

Documentation Index

​List Virtual Accounts

​Get Virtual Account

​Create Virtual Account

​Update Virtual Account

Build docs developers (and LLMs) love

List Virtual Accounts

Get Virtual Account

Create Virtual Account

Update Virtual Account