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.

---

Fetch Virtual Bank Account KYC Info

query {
  virtualBankAccountKycInfo(merchantCustomer: "merchant_customer_id") {
    kycLink
    tosLink
    kycStatus
    tosStatus
  }
}

Argument	Type	Required	Description
merchantCustomer	ID!	Yes	The ID of the merchant customer to fetch KYC info for.

The query returns the KYC and ToS links along with their completion statuses.