Skip to content
Back to Prompts

Integrate payins from bank transfers to stablecoins

Accept Pix, ACH, wire, SPEI, and other local bank transfers and settle them as USDC or USDT in a wallet, with quotes, payment instructions, and webhooks.

Payins
Quotes
Compliance
Webhooks

Paste this prompt into your coding agent to build the fiat-in, stablecoin-out direction: your users pay from a bank account and funds land in a wallet as stablecoins.

Prompt

text
You are integrating BlindPay payins (local bank transfer in, USDC/USDT out) into my application.

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

Build the full payin flow:
1. Terms of service acceptance, then create a customer (POST /v1/instances/{instance_id}/customers) and wait for KYC approval via webhooks.
2. Create a destination wallet: a managed wallet (POST /v1/instances/{instance_id}/customers/{customer_id}/wallets) or register the customer's own blockchain wallet.
3. Request a payin quote (POST /v1/instances/{instance_id}/payin-quotes) with wallet_id, payment_method (pix, ach, wire, rtp, spei, or pse), request_amount, and currency_type. Note: on payins, currency_type "sender" means the fiat side. Quotes expire; read expires_at.
4. Create the payin (POST /v1/instances/{instance_id}/payins/evm, one endpoint for all payment methods) and surface the returned payment instructions to the payer: memo_code plus bank details for USD rails, pix_code for BRL, CLABE for MXN, or the payment link for PSE.
5. Track payin.new, payin.update, payin.complete, and wallet.inbound webhooks with Svix signature verification, and reconcile by payin ID (pi_).

Constraints:
- Amounts are integers in minor units. API keys stay server-side.
- Develop against a development instance with USDB on a testnet; payins auto-complete about 30 seconds after creation there.
- Show the payer exact transfer instructions including the memo code where the rail requires it; a missing memo is the top cause of unmatched deposits.

Deliverables: payin service, payment-instructions UI or API response, webhook handler with signature verification, and an integration test that creates a payin on the development instance and asserts the completion webhook.

How to use

  1. Create a development instance and API key at app.blindpay.com.
  2. Tell the agent which rails you need (for example Pix only) so it trims the payment-method handling.
  3. Run the flow on the development instance; payins auto-complete in about 30 seconds 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.