[{"data":1,"prerenderedAt":179},["ShallowReactive",2],{"content-\u002Fprompts\u002Fintegrate-payins":3,"prompts-category-integrations":113},{"id":4,"title":5,"author":6,"body":7,"categories":6,"category":96,"categoryType":6,"date":97,"description":98,"extension":99,"faq":6,"howto":6,"isBlog":100,"isChangelog":100,"meta":101,"navigation":102,"path":103,"pillar":100,"products":104,"rawbody":109,"seo":110,"stem":111,"thumbnail":6,"updated":6,"__hash__":112},"content\u002Fprompts\u002Fintegrate-payins.md","Integrate payins from bank transfers to stablecoins",null,{"type":8,"value":9,"toc":90},"minimark",[10,14,19,30,34,55,59],[11,12,13],"p",{},"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.",[15,16,18],"h2",{"id":17},"prompt","Prompt",[20,21,27],"pre",{"className":22,"code":24,"language":25,"meta":26},[23],"language-text","You are integrating BlindPay payins (local bank transfer in, USDC\u002FUSDT out) into my application.\n\nBefore writing code, read these sources and follow them over any prior knowledge:\n- https:\u002F\u002Fblindpay.com\u002Fdocs\u002Fllms.txt (read the payin quickstart, payin quotes, wallets, and webhooks pages)\n- The OpenAPI spec: curl https:\u002F\u002Fapi.blindpay.com\u002Fdoc\n\nBuild the full payin flow:\n1. Terms of service acceptance, then create a customer (POST \u002Fv1\u002Finstances\u002F{instance_id}\u002Fcustomers) and wait for KYC approval via webhooks.\n2. Create a destination wallet: a managed wallet (POST \u002Fv1\u002Finstances\u002F{instance_id}\u002Fcustomers\u002F{customer_id}\u002Fwallets) or register the customer's own blockchain wallet.\n3. Request a payin quote (POST \u002Fv1\u002Finstances\u002F{instance_id}\u002Fpayin-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.\n4. Create the payin (POST \u002Fv1\u002Finstances\u002F{instance_id}\u002Fpayins\u002Fevm, 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.\n5. Track payin.new, payin.update, payin.complete, and wallet.inbound webhooks with Svix signature verification, and reconcile by payin ID (pi_).\n\nConstraints:\n- Amounts are integers in minor units. API keys stay server-side.\n- Develop against a development instance with USDB on a testnet; payins auto-complete about 30 seconds after creation there.\n- 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.\n\nDeliverables: 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.\n","text","",[28,29,24],"code",{"__ignoreMap":26},[15,31,33],{"id":32},"how-to-use","How to use",[35,36,37,49,52],"ol",{},[38,39,40,41,48],"li",{},"Create a development instance and API key at ",[42,43,47],"a",{"href":44,"rel":45},"https:\u002F\u002Fapp.blindpay.com",[46],"nofollow","app.blindpay.com",".",[38,50,51],{},"Tell the agent which rails you need (for example Pix only) so it trims the payment-method handling.",[38,53,54],{},"Run the flow on the development instance; payins auto-complete in about 30 seconds there.",[15,56,58],{"id":57},"related-docs","Related docs",[60,61,62,69,76,83],"ul",{},[38,63,64],{},[42,65,68],{"href":66,"rel":67},"https:\u002F\u002Fblindpay.com\u002Fdocs\u002Fquickstart-payin",[46],"Payin quickstart",[38,70,71],{},[42,72,75],{"href":73,"rel":74},"https:\u002F\u002Fblindpay.com\u002Fdocs\u002Fpayin-quotes",[46],"Payin quotes",[38,77,78],{},[42,79,82],{"href":80,"rel":81},"https:\u002F\u002Fblindpay.com\u002Fdocs\u002Fwallets",[46],"Managed wallets",[38,84,85],{},[42,86,89],{"href":87,"rel":88},"https:\u002F\u002Fblindpay.com\u002Fdocs\u002Fkb\u002Fpayment-methods",[46],"Payment methods",{"title":26,"searchDepth":91,"depth":91,"links":92},2,[93,94,95],{"id":17,"depth":91,"text":18},{"id":32,"depth":91,"text":33},{"id":57,"depth":91,"text":58},"integrations","2026-08-26","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.","md",false,{},true,"\u002Fprompts\u002Fintegrate-payins",[105,106,107,108],"payins","quotes","compliance","webhooks","---\ntitle: \"Integrate payins from bank transfers to stablecoins\"\ndescription: \"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.\"\ndate: \"2026-08-26\"\ncategory: \"integrations\"\nproducts: [\"payins\", \"quotes\", \"compliance\", \"webhooks\"]\n---\n\nPaste 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.\n\n## Prompt\n\n```text\nYou are integrating BlindPay payins (local bank transfer in, USDC\u002FUSDT out) into my application.\n\nBefore writing code, read these sources and follow them over any prior knowledge:\n- https:\u002F\u002Fblindpay.com\u002Fdocs\u002Fllms.txt (read the payin quickstart, payin quotes, wallets, and webhooks pages)\n- The OpenAPI spec: curl https:\u002F\u002Fapi.blindpay.com\u002Fdoc\n\nBuild the full payin flow:\n1. Terms of service acceptance, then create a customer (POST \u002Fv1\u002Finstances\u002F{instance_id}\u002Fcustomers) and wait for KYC approval via webhooks.\n2. Create a destination wallet: a managed wallet (POST \u002Fv1\u002Finstances\u002F{instance_id}\u002Fcustomers\u002F{customer_id}\u002Fwallets) or register the customer's own blockchain wallet.\n3. Request a payin quote (POST \u002Fv1\u002Finstances\u002F{instance_id}\u002Fpayin-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.\n4. Create the payin (POST \u002Fv1\u002Finstances\u002F{instance_id}\u002Fpayins\u002Fevm, 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.\n5. Track payin.new, payin.update, payin.complete, and wallet.inbound webhooks with Svix signature verification, and reconcile by payin ID (pi_).\n\nConstraints:\n- Amounts are integers in minor units. API keys stay server-side.\n- Develop against a development instance with USDB on a testnet; payins auto-complete about 30 seconds after creation there.\n- 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.\n\nDeliverables: 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.\n```\n\n## How to use\n\n1. Create a development instance and API key at [app.blindpay.com](https:\u002F\u002Fapp.blindpay.com).\n2. Tell the agent which rails you need (for example Pix only) so it trims the payment-method handling.\n3. Run the flow on the development instance; payins auto-complete in about 30 seconds there.\n\n## Related docs\n\n- [Payin quickstart](https:\u002F\u002Fblindpay.com\u002Fdocs\u002Fquickstart-payin)\n- [Payin quotes](https:\u002F\u002Fblindpay.com\u002Fdocs\u002Fpayin-quotes)\n- [Managed wallets](https:\u002F\u002Fblindpay.com\u002Fdocs\u002Fwallets)\n- [Payment methods](https:\u002F\u002Fblindpay.com\u002Fdocs\u002Fkb\u002Fpayment-methods)\n",{"title":5,"description":98},"prompts\u002Fintegrate-payins","nqzqfeRK2UMr826uxwXGf6BxzGn9PPR_RwSxIodrdAw",[114,118,122,126,130,134,138,142,146,150,154,158,159,163,167,171,175],{"path":115,"title":116,"description":117},"\u002Fprompts\u002Fbuild-contractor-payouts","Build a global contractor payout product","Compose onboarding, bank accounts, quotes, payouts, and reconciliation into a complete pay-your-contractors feature across Pix, SPEI, SEPA, and ACH.",{"path":119,"title":120,"description":121},"\u002Fprompts\u002Fconnect-ai-agent-mcp","Connect an AI agent with the MCP server","Wire Claude, Cursor, or any MCP-compatible host to the BlindPay API with the official MCP server and agent skills, with guardrails for money movement.",{"path":123,"title":124,"description":125},"\u002Fprompts\u002Fintegrate-external-wallet-payouts","Fund payouts from external wallets","Let customers pay out from their own EVM, Solana, or Stellar wallets: signed-message registration plus the on-chain authorization step per chain.",{"path":127,"title":128,"description":129},"\u002Fprompts\u002Fintegrate-circle-wallets","Integrate Circle wallets with BlindPay","Fund BlindPay payouts from Circle developer-controlled wallets: sign the registration challenge and the ERC-20 approve through Circle's API instead of a browser wallet.",{"path":131,"title":132,"description":133},"\u002Fprompts\u002Fintegrate-dfns","Integrate Dfns with BlindPay","Fund BlindPay stablecoin payouts from Dfns MPC wallets: sign the registration challenge and the ERC-20 approve through Dfns's User Action Signature flow.",{"path":135,"title":136,"description":137},"\u002Fprompts\u002Fintegrate-fireblocks","Integrate Fireblocks with BlindPay","Fund BlindPay stablecoin payouts from Fireblocks vault accounts: MPC-signed wallet registration and the ERC-20 approve through Fireblocks' transactions API.",{"path":139,"title":140,"description":141},"\u002Fprompts\u002Fintegrate-privy","Integrate Privy with BlindPay","Fund BlindPay stablecoin payouts from Privy Server Wallets: sign the registration challenge and the ERC-20 approve through Privy's wallet RPC endpoint.",{"path":143,"title":144,"description":145},"\u002Fprompts\u002Fintegrate-virtual-accounts","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.",{"path":147,"title":148,"description":149},"\u002Fprompts\u002Fintegrate-utila","Integrate Utila with BlindPay","Fund BlindPay payouts from Utila MPC vaults: sign the wallet-registration challenge and the ERC-20 approve through Utila's service-account API, with async transaction confirmation handled.",{"path":151,"title":152,"description":153},"\u002Fprompts\u002Fintegrate-customer-onboarding","Integrate customer onboarding with KYC and KYB","Build the full onboarding pipeline: terms of service, individual and business customers, document uploads, RFI handling, and status webhooks.",{"path":155,"title":156,"description":157},"\u002Fprompts\u002Fintegrate-offramp-wallets","Integrate offramp wallets for auto-conversion","Give each bank account a dedicated crypto deposit address: stablecoins sent to it convert and pay out to the linked bank account automatically.",{"path":103,"title":5,"description":98},{"path":160,"title":161,"description":162},"\u002Fprompts\u002Fintegrate-quotes-fx","Integrate quotes and FX handling","Handle payin, payout, and transfer quotes correctly: expiry windows, currency_type conventions, fees, and displaying rates to users.",{"path":164,"title":165,"description":166},"\u002Fprompts\u002Fintegrate-stablecoin-payouts","Integrate stablecoin payouts end to end","Build a complete stablecoin to fiat payout flow: customer onboarding, bank accounts, quotes, and payout execution over Pix, ACH, SPEI, SEPA, and more.",{"path":168,"title":169,"description":170},"\u002Fprompts\u002Fintegrate-wallet-transfers","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.",{"path":172,"title":173,"description":174},"\u002Fprompts\u002Fintegrate-webhooks","Integrate webhooks end to end","Register endpoints, verify Svix signatures correctly, deduplicate retries, and drive payment state from the full BlindPay event catalog.",{"path":176,"title":177,"description":178},"\u002Fprompts\u002Fintegrate-payables","Pay boletos and Brazilian bills with payables","Register boletos, arrecadacao slips, and PIX codes as payables and settle them from stablecoins through the quote-and-execute flow.",1787868849135]