Virtual Bank Accounts

Request a Virtual USD Bank Account

mutation {
  requestVirtualBankAccount(customerId: "customer_id") {
    id
    status
  }
}

Argument	Type	Required	Description
customer	ID!	Yes	The ID of the customer to request the virtual bank account for. (Create a customer).

The mutation returns the new virtual bank account’s global id, which you’ll reference in future calls (e.g., fetching the full account details).

Important Notes

• The virtual bank account is only available for USD ACH payments.

• The issuance fee is free, but the KYC fee is a non-refundable $3 fee. Ensure your balance is sufficient to cover the fee.

• We'll email your customer the KYC form & ToS to complete.

• We recommend that your customer submit their International Passport for KYC to increase the chances of approval and account issuance.

---

Fetch a Virtual Bank Account

query {
  virtualBankAccount(id: "virtual_bank_account_id") {
    id
    accountName
    accountNumber
    bankName
    city
    country
    line1
    postalCode
    state
    routingNumber
    status
    createdAt
  }
}

Argument	Type	Required	Description
id	ID!	Yes	The ID of the virtual bank account to fetch.

The query returns the full details of the virtual bank account.