blindpay

BlindPay 集成

BlindPay 是一个全球支付 API。一次集成即可覆盖银行支付渠道（ACH、wire、RTP、SWIFT、Pix、SPEI、ACH COP、Transfers 3.0、SEPA）和七条链上的稳定币（USDC、USDT）。每笔付款底层都通过稳定币结算。BlindPay 是非托管处理商：资金始终由客户掌控，交易失败时，资金会退回到发起交易的钱包或银行账户。

文档提供两种风格，参考文件中会以内联方式标明：

• 抽象风格：以银行支付渠道为框架。虚拟账户、作为存款的 payin，以及作为银行转账的 payout。稳定币环节由 BlindPay 处理。
• 高级风格：以稳定币为框架。托管钱包和外部钱包、链和代币、链上授权、跨链转账。

两种风格使用相同的 API、密钥、实例和 Webhook。回答时，请选择与用户正在构建的内容相符的风格。

术语

receiver 已更名为 customer。API 路径为 /customers，ID 仍以 re_ 开头。旧版 /receivers 路径和 receiver.* Webhook 事件已随 2026 年 7 月 receivers-to-customers 迁移截止而停用；请仅使用 /customers 和 customer.* 事件。

身份验证

每次调用都需要一个密钥 API 密钥，以及路径中的实例 ID：

curl --request GET \
  --url https://api.blindpay.com/v1/instances/in_000000000000/customers \
  --header 'Authorization: Bearer YOUR_API_KEY'

密钥按实例区分。开发实例是沙盒（测试网、模拟法币，以及用 USDB 替代 USDC/USDT——参见下文“链和代币”）；生产实例则处理真实资金。请参阅沙盒与生产环境。

两种核心流程

两种流程都遵循相同的先报价后执行模式——这是 BlindPay 自己的迁移文档始终使用的术语：创建报价，在报价过期前执行，然后通过 Webhook 跟踪结果。

Payout：向银行账户付款

1. 接受服务条款 → tos_id
2. 创建客户（KYC/KYB）→ re_...，等待状态变为 approved
3. 添加银行账户 → ba_...
4. 创建 payout 报价 → qu_...，仅可使用一次——请参阅“常见错误”中的“报价已过期”；目标可以是 bank_account_id，也可以是用于支付已登记账单的 payable_id（boleto、PIX QR 码或发票——请参阅应付款项）
5. 为 payout 提供资金：托管钱包余额无需签名；外部钱包需要授权（EVM 上执行 ERC-20 approve、Stellar 上签署 XDR、Solana 上进行代币委托）
6. 执行 payout → po_...，然后通过 Webhook 跟踪

从Payouts开始。

Payin：从银行账户收款

1. 接受服务条款 → tos_id
2. 创建客户（KYC/KYB）→ re_...，等待状态变为 approved
3. 选择目标：托管钱包（bl_...）、外部区块链钱包（bw_...），或开设一个用于定期存款的虚拟账户
4. 创建 payin 报价 → pq_...——请参阅“常见错误”中的“报价已过期”
5. 执行 payin → pi_...，并向付款人显示返回的付款指引（Pix 码、CLABE、备注码、ACH/wire 详情）
6. 资金到账后，BlindPay 会完成稳定币环节并触发 Webhook

从Payins开始。

主要端点

所有路径均以 https://api.blindpay.com/v1/instances/{instance_id} 为前缀。

资源	端点
客户	/customers、/customers/{re}
服务条款	/e/instances/{instance_id}/tos（公开，无需密钥）
银行账户	/customers/{re}/bank-accounts
出金钱包	/customers/{re}/bank-accounts/{ba}/offramp-wallets
区块链钱包	/customers/{re}/blockchain-wallets、.../sign-message
托管钱包	/customers/{re}/wallets、.../wallets/{bl}/balance
虚拟账户	/customers/{re}/virtual-accounts
出款报价	/quotes
出款	/payouts/evm、/payouts/stellar、/payouts/solana、/payouts/stellar/authorize
应付款项	/payables、/payables/{pb}（通过出款流程支付：使用 payable_id 获取报价）
入款报价	/payin-quotes
入款	/payins/evm
转账	/transfer-quotes、/transfers
RFI 和限额	/customers/{re}/rfi、/customers/{re}/limit-increase
合作伙伴费用	/partner-fees
Webhook	/webhook-endpoints、.../{we}/secret
上传	https://api.blindpay.com/v1/upload?instance_id={instance_id}

金额始终以最小货币单位的整数表示：100000 即 $1,000.00。

ID 前缀

前缀	资源
in_	实例
re_	客户（以前称为收款方）
ba_	银行账户
bw_	外部区块链钱包
bl_	BlindPay 托管钱包
pb_	应付款项（已登记的账单）
va_	虚拟账户
qu_	出款报价
po_	出款
pq_	入款报价
pi_	入款
tr_	转账
pf_	合作伙伴费用
we_	Webhook 端点

支付方式

美国、巴西、墨西哥、哥伦比亚、阿根廷和欧洲共有 10 种银行转账通道，另有国际 SWIFT。各支付方式对应的国家、货币和方向（收款／付款），包括 PSE 和 SEPA 的特殊情况，请参阅：支付方式。各通道的结算速度和截止时间，请参阅：截止时间。

链和代币

共有 7 条链：Ethereum、Polygon、Base、Arbitrum、Stellar、Solana、Tron（测试版）。生产实例会在主网网络名称（ethereum、polygon、base、arbitrum、stellar、solana、tron）上发送真实的 USDC/USDT；开发实例则会在对应的测试网上发送 USDB（BlindPay 的测试代币）——不匹配的组合会被拒绝。各条链上支持哪些代币，以及测试网的网络名称，都是每个报价请求的校验枚举：支持的链是唯一会持续更新这些信息的地方。

在开发实例上测试

将报价的 request_amount 设为指定值即可触发相应结果：

request_amount	结果
66600	failed
77700	refunded
其他任意值	completed（入款会在创建后约 30 秒自动完成）

创建名字为 Fail 的客户可模拟 KYC 拒绝。要为测试钱包充值 USDB，请创建一笔以该钱包为目标的入款：在开发实例上，入款会在创建后约 30 秒自动完成，并将 USDB 转入钱包。

客户 KYC 状态

5 种 kyc_status 值决定客户可以执行哪些操作：verifying、approved、rejected、compliance_request、approved_rfi。关于各状态的触发条件和审核耗时，请参阅客户；关于 compliance_request / approved_rfi 这对状态，请参阅 RFI。

常见错误

• please_accept_terms_of_service：客户必须接受当前版本的服务条款
• 报价已过期：读取 expires_at——切勿假设有效期固定。入金、出金和转账报价默认有效期为 5 分钟，但 OTC（仅限 BRL）入金报价会在 10 秒后过期，SEPA 出金报价的有效期可能更短；过期后请创建新报价。参见报价有效期。
• 余额或授权额度不足：钱包资金不足，或 ERC-20 授权额度低于报价金额
• KYC 未通过：客户尚未达到 approved 状态——完整状态列表及 RFI 处理方式请参见上文的客户 KYC 状态
• 代币与链不受支持：参见支持的链

参考文档

入门

• 简介 - BlindPay 是一个全球支付 API，通过一次集成即可使用银行通道和稳定币转移资金。
• 概览 - 通过一个 REST API 连接银行通道或稳定币网络（也可同时连接两者）。开立虚拟账户并进行法币入金和出金，或在不同链上持有、发送和接收 USDC 与 USDT。
• 稳定币转银行转账 - 仅使用 REST API，在开发实例上将 BlindPay 管理的钱包中的资金首次出金至银行账户。
• 银行转账转稳定币 - 仅使用 REST API，在开发实例上接收银行转账，并由 BlindPay 自动交付等值稳定币。
• SDK - BlindPay 官方 SDK，支持 Node.js、Python、Go、PHP 和 Swift，另提供 OpenAPI 规范和 REST API 参考。
• 使用 AI 构建 - 通过 MCP 服务、Agent Skills 和 REST API，将 AI 编码 Agent 与 AI 构建工具连接到 BlindPay。

基础知识

• 实例 - 实例是相互隔离的 BlindPay 环境，每个环境对应技术栈中的一个阶段，可在控制面板中创建。
• 沙盒与生产环境 - 开发实例与生产实例在行为上的具体差异，以及切换环境的检查清单。
• 计费 - BlindPay 如何对虚拟账户、交易和合作伙伴费用收费，以及账单的发送时间
• 合作伙伴费用 - 为客户的交易添加百分比费用或固定费用，并按月提取累计收入。
• 客户 - 通过 BlindPay 发送或接收付款和稳定币的个人或企业。
• 服务条款 - 客户必须接受的法律协议；接受后才能创建客户并开始 KYC。
• RFI - BlindPay 合规团队需要客户提供更多文件时，以编程方式作出回应。
• 提高限额 - 提交证明文件，为客户申请提高单笔、每日或每月转账限额，并跟踪申请的合规审核进度。
• 上传 - 根据客户的 KYC 文件和照片生成加密文件 URL。
• 分析文件 - 使用 AI 读取 KYC 文件，并在提交前获取审批率信号。
• API 密钥 - 使用在控制面板中创建的实例专属 API 密钥，对所有 BlindPay API 请求进行身份验证。
• Webhook - 实时接收有关客户、付款、虚拟账户、钱包和转账的事件，无需轮询 API。
• Webhook 事件 - 完整的 BlindPay webhook 事件目录，按领域分组，并附有示例负载。
• Webhook 验证 - 使用 svix-id、svix-timestamp 和 svix-signature 标头验证每个 BlindPay webhook 调用的签名。

出款（向银行账户转账）

• 出款 - 向收款人的银行账户执行出款，并跟踪其从处理中到已完成、失败或已退款的状态。
• 银行账户 - 添加 BlindPay 用于出款的收款人银行账户，支持 SWIFT、ACH、wire、RTP、Pix、PIX Safe、TED、SPEI、ACH COP、Transfers、SEPA 和 Faster Payments 通道。
• 出款报价 - 在执行出款前锁定汇率并拆分费用，查看响应中的准确费用明细和收款金额。
• 使用托管钱包出款 - 通过单个 REST 调用，使用 BlindPay 托管的钱包为出款注资，无需链上批准或签名。
• 使用 EVM 出款 - 使用外部 EVM 钱包为出款注资，批准 ERC-20 代币转账，然后执行出款。
• 使用 Stellar 出款 - 使用外部 Stellar 钱包为出款注资，授权出款、签署 XDR 交易，然后创建出款。
• 使用 Solana 出款 - 使用外部 Solana 钱包为出款注资，将代币委托给 BlindPay，然后创建出款。
• 出金钱包 - 了解什么是 BlindPay 出金钱包、其支持的链和稳定币、最低限额，以及存款如何自动转换为法币出款。

付款（从银行账户收款）

• 付款 - 创建一笔付款，将资金转至目标账户，并跟踪直至结算完成。
• 付款报价 - 在创建付款前，锁定金额、费用分摊和目标账户。
• 区块链钱包 - 注册由客户控制的外部钱包地址，以接收稳定币付款并发送稳定币出款。
• 使用托管钱包付款 - 接收法币付款，并将等值稳定币转入 BlindPay 托管的钱包；只需进行两次 REST 调用，无需签名。
• 使用区块链钱包付款 - 接收法币付款，并将等值稳定币转入由客户控制的钱包。

应付款（支付已登记的账单）

• 应付款 - 登记账单、发票、boleto 或 PIX 代码，然后通过标准出款流程支付。
• Boleto 和 PIX 应付款 - 将 boleto、水电费或税单，或 PIX 代码登记为应付款，然后通过标准出款流程支付。
• 发票应付款 - 登记支付至美国银行账户的供应商发票，通过 ACH 或电汇付款；也可以使用 AI 读取 PDF 并预填信息。
• 使用托管钱包支付应付款 - 登记客户欠付的账单，然后从 BlindPay 托管的钱包支付，无需链上批准，也不会触发钱包提示。
• 使用 EVM 支付应付款 - 登记客户欠付的账单，然后通过报价、批准 ERC-20 转账和执行出款，从外部 EVM 钱包支付。

虚拟账户

• 虚拟账户 - 开立一个虚拟账户（虚拟银行账户），用于接收 USD 银行转账，并自动结算为 USDC 或 USDT 等稳定币，存入客户的钱包。
• 创建虚拟账户 - 使用 BlindPay API 创建虚拟账户，涵盖客户的前置条件、必需的合规字段，以及确认批准的 webhook。

钱包、转账和稳定币

• 存储 - 在 BlindPay 托管的钱包中存放客户余额，或登记客户已控制的外部钱包。
• 托管钱包 - 创建 BlindPay 托管的钱包、查询余额，并将其用于付款和出款。
• 发送 - 使用 BlindPay API，将稳定币从 BlindPay 托管的钱包发送到另一个托管钱包或任意外部地址。
• 转账报价 - 创建转账报价，在执行转账前锁定来源钱包、目标地址、代币、网络和金额。
• 转账 - 根据转账报价执行稳定币转账，并通过 BlindPay API 跟踪直至完成。
• 接收 - 将稳定币接收到 BlindPay 托管的钱包，并通过 wallet.inbound webhook 跟踪每笔存款。

知识库（合规、覆盖范围、运营）

• 截点时间 - ACH、电汇和 SWIFT 的截点时间与结算、即时支付渠道、报价有效期、开户 SLA 及退款时效。
• 信息请求 - BlindPay 合规团队通过信息请求（RFI）索取缺失的 KYC 或 KYB 资料，以便批准客户。
• 实例请求 - 了解 BlindPay 合规团队如何向你的团队索取有关你自身账户的补充信息，以及如何在 27 天期限结束前作出回应。
• KYB 文件 - 企业 KYB 验证所需文件：公司成立文件、所有权证明、UBO 身份证明和地址证明。
• KYC 基础知识 - BlindPay 客户所需的 KYC 验证级别、文件质量标准和提交指南。
• KYC 要求 - BlindPay 客户的验证级别、必填字段、状态、限额、文件质量、服务条款和 RFI。
• NAICS 代码 - 在 BlindPay 开户过程中查找适用于你企业的 NAICS 行业代码。
• 嵌套付款 - 嵌套是指代 BlindPay 无法查看的一方转移资金；本指南介绍如何识别此类情况并确保合规。
• 暂挂交易 - 被 BlindPay 监控系统标记为可疑，并等待合规审查或信息请求的交易。
• 支付方式 - BlindPay 支持的所有银行转账渠道，按国家和货币划分：ACH、电汇、RTP、SWIFT、Pix、PIX Safe、TED、SPEI、PSE、Transfers、SEPA 和 Faster Payments。
• 付款描述信息 - 付款人姓名在收款人银行对账单上的显示方式，取决于支付方式以及是否启用了 Named Account。
• POBO 和 COBO - 了解代付和代收在 BlindPay 中的运作方式、哪些情况会使客户姓名显示在电汇中，以及合规界限所在。
• 禁止活动 - BlindPay 的高风险和禁止业务活动，以及开户和持续监控期间所需的披露义务。
• 地址证明 - 企业和个人验证可接受的地址证明文件及提交要求。
• 拒绝原因 - 验证过程中申请或文件被拒绝时返回的原因代码和消息。
• 自托管钱包（巴西） - 巴西客户必须申报每个外部钱包是否为自托管钱包。了解有何变化、影响对象，以及如何通过控制面板或 API 操作。
• 资金来源 - 验证企业资金来源和财富来源所需的文件。
• 支持的链 - BlindPay 收款、付款、钱包和转账所支持的区块链、稳定币及各项功能对应的链支持情况。
• 支持的国家 - BlindPay 支持的所有国家，按层级划分：标准、高风险（需增强 KYC）和禁止。
• SWIFT 可送达性 - 合规文件和收款人地址格式要求，可提高 SWIFT 转账成功送达的可能性。
• SWIFT 状态 - 了解如何通过 tracking_documents 字段跟踪 SWIFT 付款的合规文件状态，包括暂挂、审核和批准。
• 虚拟账户文件 - 虚拟账户评估所需的文件，包括资金来源和财富来源证明材料。

迁移指南（从其他服务商迁移）

• 从 Anchorage Digital 迁移到 BlindPay - 保留 Anchorage Digital 负责托管，并将稳定币兑换法币环节迁移到 BlindPay：将转账、提现和结算事件映射到 BlindPay 的报价、付款和 Webhook。
• 从 BitGo 迁移到 BlindPay - 将 BitGo 集成中的稳定币兑换法币环节迁移到 BlindPay：将钱包、转账和结算 Webhook 映射到 BlindPay 的客户、报价、付款和 Webhook 事件。
• 从 Bridge 迁移到 BlindPay - 将现有 Bridge 集成迁移到 BlindPay API：将客户、外部账户、清算地址和转账映射到 BlindPay 中的对应项。
• 从 Cobo 迁移到 BlindPay - 将 Cobo Payments 集成中的稳定币兑换法币环节迁移到 BlindPay：你可以继续使用 Cobo 托管钱包，并将充值地址、订单模式和付款目的地替换为客户、报价和付款。
• 从 Coinbase CDP 迁移到 BlindPay - 将 Coinbase Developer Platform 集成中的稳定币兑法币出金环节迁移到 BlindPay：添加 Pix、SPEI、SEPA 和电汇付款，同时由 CDP 钱包继续负责托管。
• 从 Conduit 迁移到 BlindPay - 将 Conduit 跨境支付集成迁移到 BlindPay：使用报价并执行的模式处理交易对手、支付通道和结算跟踪。
• 从 Crossmint 迁移到 BlindPay - 将 Crossmint 集成中的稳定币兑换法币环节迁移到 BlindPay，同时继续使用 Crossmint 处理钱包、结账或编排。
• 从 Dfns 迁移到 BlindPay - 保留 Dfns 负责 MPC 钱包托管，并将稳定币兑换法币环节迁移到 BlindPay：将转账和交易所提现映射到报价、付款和已注册的外部钱包。
• 从 Dynamic 迁移到 BlindPay - 保留 Dynamic 负责嵌入式钱包和服务端钱包，并将稳定币兑法币出金环节迁移到 BlindPay：注册 Dynamic 钱包、获取报价并执行付款，以及验证 Webhook。
• 从 Fern 迁移到 BlindPay - 将 Fern 稳定币集成迁移到 BlindPay：处理客户、银行账户、钱包、先报价后执行的入金和付款，以及由 Svix 签名的 Webhook。
• 从 Fireblocks 迁移到 BlindPay - 将 Fireblocks 集成中的稳定币兑换法币付款环节迁移到 BlindPay：重新接入收款人、重建先报价后付款的流程，并迁移 Webhook，同时继续由 Fireblocks 托管。
• 从手动付款迁移到 BlindPay - 将基于电子表格和银行门户的付款操作转变为由 Webhook 驱动、可审计状态机支持的自动化 API 流程。
• 从 Privy 迁移到 BlindPay - 保留 Privy 负责嵌入式钱包和服务端钱包，并将稳定币兑法币出金环节迁移到 BlindPay：注册钱包、获取报价并执行付款，以及验证 Webhook。
• 从 SWIFT 电汇迁移到 BlindPay - 将耗时数天的国际电汇替换为通过本地通道进行的当日稳定币结算；对于 BlindPay 未覆盖的支付通道，保留 SWIFT 作为备用方案。
• 从 Turnkey 迁移到 BlindPay - 保留 Turnkey 负责钱包和签名，并将基于 Turnkey 的产品中的稳定币兑法币出金环节迁移到 BlindPay：映射付款账户、报价和 Webhook。
• 从 Utila 迁移到 BlindPay - 保留 Utila 负责托管和签名，并通过 BlindPay 处理稳定币兑换法币环节：将金库、钱包、交易和 Webhook 映射到 BlindPay 中的对应项。

AI 工具集成

• Bolt.new + BlindPay - 使用稳定币支付功能扩展 Bolt.new（StackBlitz）应用：通过 BlindPay API 和可直接复制粘贴的提示词实现付款、入金和虚拟账户流程。
• Claude Code + BlindPay - 通过 MCP 服务和 Agent Skills 将 Claude Code 接入 BlindPay：用自然语言在终端中执行付款、获取报价和创建虚拟账户。
• Codex + BlindPay - 通过 MCP 服务和 Agent Skills 将 OpenAI Codex 接入 BlindPay：在终端或 IDE 中执行付款、获取报价和创建虚拟账户。
• Cursor + BlindPay - 通过 MCP 服务和 Agent Skills 将 Cursor 接入 BlindPay：用自然语言转移资金、执行付款和查询通道。
• Grok + BlindPay - 通过 MCP 服务将 Grok 和 Grok Build 接入 BlindPay：在 grok.com 或终端中用自然语言执行付款、获取报价和创建虚拟账户。
• Hermes Agent + BlindPay - 通过 MCP 服务和 Agent Skills 将 Hermes Agent 接入 BlindPay。Nous Research 的 Agent 可通过自然语言执行稳定币付款并获取报价。
• Lovable + BlindPay - 使用稳定币支付功能扩展 Lovable 应用：通过 BlindPay API 和可直接复制粘贴的提示词实现付款、USDC/USDT 入金兑换法币以及虚拟账户。
• OpenClaw + BlindPay - 通过 MCP 服务和 Agent Skills 将 OpenClaw 接入 BlindPay。自主 Agent 可通过自然语言执行稳定币付款并获取报价。
• Replit + BlindPay - 使用 Replit Agent 为 Replit 应用添加稳定币支付功能：通过 BlindPay API 和 Replit Secrets 实现付款、入金和虚拟账户流程。
• v0 + BlindPay - 为 v0（Vercel）Next.js 应用添加稳定币支付功能：通过 BlindPay API 和可直接复制粘贴的提示词实现付款、入金和虚拟账户流程。