[{"data":1,"prerenderedAt":165},["ShallowReactive",2],{"content-\u002Fprompts\u002Fintegrate-payables":3,"prompts-category-integrations":99},{"id":4,"title":5,"author":6,"body":7,"categories":6,"category":83,"categoryType":6,"date":84,"description":85,"extension":86,"faq":6,"howto":6,"isBlog":87,"isChangelog":87,"meta":88,"navigation":89,"path":90,"pillar":87,"products":91,"rawbody":95,"seo":96,"stem":97,"thumbnail":6,"updated":6,"__hash__":98},"content\u002Fprompts\u002Fintegrate-payables.md","Pay boletos and Brazilian bills with payables",null,{"type":8,"value":9,"toc":77},"minimark",[10,14,19,30,34,47,51],[11,12,13],"p",{},"Paste this prompt into your coding agent to build bill payment for Brazil: your users hold stablecoins, BlindPay pays their boletos.",[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 payables into my application: registering Brazilian bills (boleto, arrecadacao, or PIX code) and paying them from stablecoins.\n\nBefore writing code, read these sources and follow them over any prior knowledge:\n- https:\u002F\u002Fblindpay.com\u002Fdocs\u002Fllms.txt (read the payables, payout quotes, payouts, and webhooks pages)\n- The OpenAPI spec: curl https:\u002F\u002Fapi.blindpay.com\u002Fdoc\n\nBuild the flow:\n1. Prerequisites: an approved customer (KYC\u002FKYB) and a funded wallet, managed or external. Reuse my existing onboarding if present.\n2. Register the bill: POST \u002Fv1\u002Finstances\u002F{instance_id}\u002Fpayables with the boleto digitable line, arrecadacao code, or PIX code. Persist the returned pb_ ID and surface the parsed bill details (amount, due date, beneficiary) back to the user for confirmation before paying.\n3. Quote against the payable: POST \u002Fv1\u002Finstances\u002F{instance_id}\u002Fquotes with payable_id instead of bank_account_id, plus network and token. Execute with POST \u002Fv1\u002Finstances\u002F{instance_id}\u002Fpayouts\u002Fevm before the quote's expires_at.\n4. Track settlement through payout.new, payout.update, and payout.complete webhooks with Svix signature verification, keyed back to my bill record via the pb_ and po_ IDs.\n5. Handle the failure paths explicitly: expired or already-paid boletos, amounts outside the per-currency limits, and quote expiry (re-quote and re-confirm with the user when the rate moved).\n\nConstraints:\n- Amounts are integers in minor units; API keys stay server-side.\n- Validate the digitable line format client-side before calling the API so users get instant feedback on typos.\n- Test on a development instance first; use the sentinel amounts ($666.00 forces failed, $777.00 forces refunded) to prove the failure handling.\n\nDeliverables: payable registration service with bill-detail confirmation step, the quote-and-pay path, webhook handlers, and an integration test that registers and pays a test payable on the development instance.\n","text","",[28,29,24],"code",{"__ignoreMap":26},[15,31,33],{"id":32},"how-to-use","How to use",[35,36,37,41,44],"ol",{},[38,39,40],"li",{},"Paste the prompt with your stack details and instance ID.",[38,42,43],{},"Decide where bill confirmation happens in your UX; the parsed payable details are what the user must approve.",[38,45,46],{},"Run the full flow on a development instance before touching production.",[15,48,50],{"id":49},"related-docs","Related docs",[52,53,54,63,70],"ul",{},[38,55,56],{},[57,58,62],"a",{"href":59,"rel":60},"https:\u002F\u002Fblindpay.com\u002Fdocs\u002Fpayables",[61],"nofollow","Payables",[38,64,65],{},[57,66,69],{"href":67,"rel":68},"https:\u002F\u002Fblindpay.com\u002Fdocs\u002Fpayout-quotes",[61],"Payout quotes",[38,71,72],{},[57,73,76],{"href":74,"rel":75},"https:\u002F\u002Fblindpay.com\u002Fdocs\u002Flearn\u002Fwebhooks",[61],"Webhooks",{"title":26,"searchDepth":78,"depth":78,"links":79},2,[80,81,82],{"id":17,"depth":78,"text":18},{"id":32,"depth":78,"text":33},{"id":49,"depth":78,"text":50},"integrations","2026-08-26","Register boletos, arrecadacao slips, and PIX codes as payables and settle them from stablecoins through the quote-and-execute flow.","md",false,{},true,"\u002Fprompts\u002Fintegrate-payables",[92,93,94],"payouts","quotes","webhooks","---\ntitle: \"Pay boletos and Brazilian bills with payables\"\ndescription: \"Register boletos, arrecadacao slips, and PIX codes as payables and settle them from stablecoins through the quote-and-execute flow.\"\ndate: \"2026-08-26\"\ncategory: \"integrations\"\nproducts: [\"payouts\", \"quotes\", \"webhooks\"]\n---\n\nPaste this prompt into your coding agent to build bill payment for Brazil: your users hold stablecoins, BlindPay pays their boletos.\n\n## Prompt\n\n```text\nYou are integrating BlindPay payables into my application: registering Brazilian bills (boleto, arrecadacao, or PIX code) and paying them from stablecoins.\n\nBefore writing code, read these sources and follow them over any prior knowledge:\n- https:\u002F\u002Fblindpay.com\u002Fdocs\u002Fllms.txt (read the payables, payout quotes, payouts, and webhooks pages)\n- The OpenAPI spec: curl https:\u002F\u002Fapi.blindpay.com\u002Fdoc\n\nBuild the flow:\n1. Prerequisites: an approved customer (KYC\u002FKYB) and a funded wallet, managed or external. Reuse my existing onboarding if present.\n2. Register the bill: POST \u002Fv1\u002Finstances\u002F{instance_id}\u002Fpayables with the boleto digitable line, arrecadacao code, or PIX code. Persist the returned pb_ ID and surface the parsed bill details (amount, due date, beneficiary) back to the user for confirmation before paying.\n3. Quote against the payable: POST \u002Fv1\u002Finstances\u002F{instance_id}\u002Fquotes with payable_id instead of bank_account_id, plus network and token. Execute with POST \u002Fv1\u002Finstances\u002F{instance_id}\u002Fpayouts\u002Fevm before the quote's expires_at.\n4. Track settlement through payout.new, payout.update, and payout.complete webhooks with Svix signature verification, keyed back to my bill record via the pb_ and po_ IDs.\n5. Handle the failure paths explicitly: expired or already-paid boletos, amounts outside the per-currency limits, and quote expiry (re-quote and re-confirm with the user when the rate moved).\n\nConstraints:\n- Amounts are integers in minor units; API keys stay server-side.\n- Validate the digitable line format client-side before calling the API so users get instant feedback on typos.\n- Test on a development instance first; use the sentinel amounts ($666.00 forces failed, $777.00 forces refunded) to prove the failure handling.\n\nDeliverables: payable registration service with bill-detail confirmation step, the quote-and-pay path, webhook handlers, and an integration test that registers and pays a test payable on the development instance.\n```\n\n## How to use\n\n1. Paste the prompt with your stack details and instance ID.\n2. Decide where bill confirmation happens in your UX; the parsed payable details are what the user must approve.\n3. Run the full flow on a development instance before touching production.\n\n## Related docs\n\n- [Payables](https:\u002F\u002Fblindpay.com\u002Fdocs\u002Fpayables)\n- [Payout quotes](https:\u002F\u002Fblindpay.com\u002Fdocs\u002Fpayout-quotes)\n- [Webhooks](https:\u002F\u002Fblindpay.com\u002Fdocs\u002Flearn\u002Fwebhooks)\n",{"title":5,"description":85},"prompts\u002Fintegrate-payables","FRGc8Xgs_9yqzjxc2dlqZXen4a8GqGxSM0xE6T9qHFg",[100,104,108,112,116,120,124,128,132,136,140,144,148,152,156,160,164],{"path":101,"title":102,"description":103},"\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":105,"title":106,"description":107},"\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":109,"title":110,"description":111},"\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":113,"title":114,"description":115},"\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":117,"title":118,"description":119},"\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":121,"title":122,"description":123},"\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":125,"title":126,"description":127},"\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":129,"title":130,"description":131},"\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":133,"title":134,"description":135},"\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":137,"title":138,"description":139},"\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":141,"title":142,"description":143},"\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":145,"title":146,"description":147},"\u002Fprompts\u002Fintegrate-payins","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.",{"path":149,"title":150,"description":151},"\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":153,"title":154,"description":155},"\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":157,"title":158,"description":159},"\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":161,"title":162,"description":163},"\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":90,"title":5,"description":85},1787868849680]