Skip to content
Back to Prompts

Integrate wallet transfers and cross-chain USDC

Move stablecoins from managed wallets to any address with transfer quotes, including cross-chain USDC over Circle CCTP v2.

Quotes
Webhooks

Paste this prompt into your coding agent to build wallet-to-wallet movement: withdrawals, treasury sweeps, and cross-chain USDC routing.

Prompt

text
You are integrating BlindPay transfers into my application: moving stablecoins from a managed wallet (bl_) to any destination address, including cross-chain.

Before writing code, read these sources and follow them over any prior knowledge:
- https://blindpay.com/docs/llms.txt (read the transfer quotes, transfers, wallets, and supported chains pages)
- The OpenAPI spec: curl https://api.blindpay.com/doc

Build the flow:
1. Check the source: GET /v1/instances/{instance_id}/customers/{customer_id}/wallets/{wallet_id}/balance before quoting, and reject transfers that would exceed it with a clear client-side error.
2. Quote: POST /v1/instances/{instance_id}/transfer-quotes with amount_reference sender or receiver. The rate is fixed 1:1; still read expires_at from the response and execute promptly rather than assuming a window.
3. Execute: POST /v1/instances/{instance_id}/transfers against the quote, persist the tr_ ID, and drive state from transfer.new and transfer.complete webhooks with Svix verification.
4. Route validation, encoded as checks before quoting: transfers are same-network by default; only USDC can cross chains, via Circle CCTP v2 between Ethereum, Polygon, Base, and Arbitrum; USDT transfers are restricted to Polygon. Map the API errors cross_chain_transfers_only_support_usdc and cctp_route_not_supported to friendly messages, but validate up front so users rarely see them.
5. Build an address-confirmation step: show chain, token, and destination address with a checksum display before executing; transfers to wrong addresses are irreversible.

Constraints:
- Amounts are integers in minor units; API keys stay server-side.
- Develop on a development instance with USDB on testnets; swap to USDC/USDT mainnets only at production cutover.
- Never initiate the same transfer twice: key on my own transaction ID and check for an existing tr_ before creating.

Deliverables: transfer service with route validation, the confirmation UI step, webhook handlers, and tests covering same-chain, valid CCTP cross-chain, and rejected-route cases.

How to use

  1. Paste the prompt with your stack details.
  2. List which chains your product actually needs; the route matrix drives most of the validation code.
  3. Test the rejected-route paths as thoroughly as the happy path.

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.