Skip to content
Back to Prompts

Integrate US virtual accounts

Give each customer a named US bank account with ACH, RTP, wire, and SWIFT details that settles automatically to USDC or USDT in their wallet.

Virtual accounts
Compliance
Webhooks

Paste this prompt into your coding agent to issue dedicated US account numbers for your customers and settle incoming transfers to stablecoins.

Prompt

text
You are integrating BlindPay virtual accounts into my application: each customer gets a dedicated US bank account (routing and account number) whose deposits settle automatically as USDC/USDT to a linked blockchain wallet.

Before writing code, read these sources and follow them over any prior knowledge:
- https://blindpay.com/docs/llms.txt (read the virtual accounts pages, customers, blockchain wallets, and webhooks)
- The OpenAPI spec: curl https://api.blindpay.com/doc

Build the flow:
1. Create the customer and wait for KYC/KYB approval (customer.update webhook). Business customers need owners and the KYB document set.
2. Register the settlement blockchain wallet for the customer.
3. Make sure the compliance fields virtual accounts require are set on the customer (account_purpose, source_of_wealth, and the business fields for KYB), updating via PUT /v1/instances/{instance_id}/customers/{customer_id} if needed.
4. Create the virtual account: POST /v1/instances/{instance_id}/customers/{customer_id}/virtual-accounts with banking_partner, token, and blockchain_wallet_id.
5. Handle the two-stage review lifecycle (pending_review, verifying, approved or rejected) through virtualAccount.new and virtualAccount.complete webhooks; only show account details to the customer once approved.
6. Record deposit settlements via wallet.inbound webhooks and reconcile fees: deposits under $100 accrue to the monthly invoice (billing_fee_amount), larger ones are charged at transaction time (transaction_fee_amount).

Constraints:
- API keys stay server-side; verify Svix webhook signatures on every event.
- On a development instance virtual accounts skip review and go straight to approved, so also code the rejected path deliberately.
- Persist va_, re_, and bw_ IDs on my own records.

Deliverables: virtual account service, webhook handlers for the account lifecycle and inbound deposits, and a summary of which compliance fields my onboarding form must collect for individuals versus businesses.

How to use

  1. Ensure your onboarding collects the compliance fields (account purpose, source of wealth, business documentation for KYB) before creating accounts.
  2. Paste the prompt with your stack details and instance ID.
  3. Test on a development instance first; review auto-approves there.

One API.
Multiple payment rails.

Blind Pay, Inc. (“BlindPay”) is a United States-based financial technology and payments infrastructure company, incorporated in the State of Delaware on May 2, 2024. BlindPay is duly registered as a Money Services Business (“MSB”) with the Financial Crimes Enforcement Network (“FinCEN”) under registration number 31000277566153. BlindPay is not a state-licensed money transmitter and does not, in its own capacity, engage in regulated money transmission services. All such regulated activities are conducted exclusively through, and under the licenses of, duly authorized financial institution partners. BlindPay's role is limited to providing financial technology, virtual account management, payment processing, and related payments infrastructure services that facilitate payment flows and account functionalities. These services are provided in coordination with its licensed partners and in compliance with applicable federal MSB requirements and relevant state regulatory frameworks.

Blind Pay, LLC (“BlindPay”) is a Delaware limited liability company formed on June 24, 2025. BlindPay is duly registered as a Money Services Business (“MSB”) with the Financial Crimes Enforcement Network (“FinCEN”) under registration number 31000318334247 and is listed in the Nationwide Multistate Licensing System (“NMLS”) under NMLS ID #2745309.

BLIND PAY SOCIEDADE PRESTADORA DE SERVIÇOS DE ATIVOS VIRTUAIS LTDA. (“BlindPay”) is a Virtual Asset Service Provider (“VASP”) operating in Brazil. The company is presently completing the regulatory adaptation process required of Virtual Asset Service Provider Companies (SPSAV) under Central Bank of Brazil Resolution No. 520/2025, and remains subject to the transitional regime set forth in Article 88 of that Resolution. Registered address: Avenida Princesa Isabel, nº 15, Sala 1405, Edifício Martinho de Freitas, Centro, Vitória/ES, 29010-361.

BlindPay is a stablecoin API that enables individuals and businesses to move money worldwide.