Skip to main content
银行服务为您提供以您已验证档案名义开立的真实银行账户：您可以通过国际通道（视货币而定，SEPA、SWIFT、ACH）接收资金、持有法币余额，并向第三方发送付款。它是独立于您 USDT 余额的产品：银行资金存放在您的银行账户中，而不在 CBPay 余额里。
银行服务费用（banking_customer、banking_account、banking_operation）为固定金额，在每笔操作执行时从您的 USDT 余额扣除，若操作失败则自动退款。费用为 0（默认值）时服务免费。每个响应中的 banking_fee 字段显示实际扣费金额。

​
完整流程

  1. 创建您的银行客户档案（POST /v1/banking/customer）——仅一次。
  2. 上传验证证件并提交审核。
  3. 状态变为 approved 后，按货币开立账户。
  4. 登记收款人（交易对手）用于第三方付款。
  5. 发送付款：用 prepare 询价，用 operations 执行。
状态变更通过 banking_customer_status_changed 和 banking_operation_status_changed webhook 送达（webhooks）。

​
1. 创建您的银行客户档案

每个账户仅一次。若省略 type、name 或 email，会从您的 CBPay 账户自动填充：
响应 201：
如果您的账户已有银行客户档案——409 banking_customer_exists。可随时查询状态：

​
2. 证件与验证

以 base64 格式上传每份证件（免费）：
然后将档案提交审核（免费）：
档案状态：draft → submitted → under_review → approved 或 rejected。每次变更都会由 banking_customer_status_changed webhook 通知 — 包括自己的档案（customer_kind: self）和你注册的第三方（customer_kind: third_party，附其 third_party_id）：

​
3. 开立银行账户

档案变为 approved 后，按货币各开立一个账户。可用货币：USD（ACH/Fedwire/SWIFT 通道）和 EUR（SEPA/SWIFT）：
响应 201——data 中包含用于接收资金的信息（账号/IBAN、路由号、银行）：
列出您的账户、查询单个账户的详情及余额：
详情端点（GET /v1/banking/accounts/{id}）返回账户的实时数据 — 名称、币种、状态，以及 data 下的接收资金所需要件（电汇与本地 轨道：银行、账号/IBAN、routing）。用于展示特定账户的入金指引，无需 遍历列表：
source 表示详情的来源：live（银行实时返回）或 mirror（银行当时 无法返回该账户，返回最近一次已知快照——入金要件仍然可用）。
列表仅暴露根据通道配置为您的业务启用的账户。未启用的账户不会出现 在列表中，其按 id 的查询返回 404 not_found。
个人账户限制：个人账户最多持有 1 个银行账户。尝试开立第二个会返回 409 banking_account_limit。企业账户没有限制。

​
第三方用户（仅限企业）

如果您的账户是企业，除了您自己的账户外，还可以登记第三方银行用户——您的终端客户（个人或企业）——每个用户拥有自己的身份和验证，以及以其名义开立的银行账户。第三方数量及每个第三方的账户数量均无限制。

​
登记第三方

登记需要该第三方一条已批准的 KYC/KYB 验证的 verification_id——这是其在 CBPay 内的唯一身份。类型由验证种类决定（KYC ⇒ INDIVIDUAL，KYB ⇒ COMPANY），数据（姓名、邮箱、地址）会从已验证的档案自动填充（您显式提供的内容优先），并且已校验的证件会自动重新递交给银行服务提供方。此时计收银行客户档案费用（登记失败则退款）：
响应 201：
documents_synced 表示自动加载到该第三方银行档案中的验证证件数量。如果某份证件未能同步（或银行要求额外类别），请通过下方的手动证件流程上传，然后执行 submit。
请保存 third_party_id：所有第三方路由都使用它。列出与查询（GET 中包含实时的验证状态）：

​
第三方验证（免费）

与您自己的档案相同，只是作用于该第三方：

​
第三方账户

第三方获批后，为其开立账户（同样计收 banking_account 费用），操作方式与您自己的账户完全一致：
  • 每个第三方只属于您：其他 CBPay 账户永远无法查看或操作它（会得到 404）。
  • 个人账户尝试创建第三方会收到 403 company_required。
  • 未提供 verification_id（或验证未获批准）时，登记会返回 422 verification_required / 422 verification_not_approved。如果发送的 type 与验证种类不匹配，则返回 422 verification_kind_mismatch。在此规则之前创建的第三方继续正常运作。
  • 已登记的第三方会计入您账户摘要中的”新用户”指标。

​
4. 登记收款人

要向第三方付款，需先用其银行信息登记收款人（免费；需经审核通过后方可使用）：
用 GET /v1/banking/counterparties 列出您的收款人，用 POST /v1/banking/counterparties/{id}/accounts 为已有收款人追加更多账户。

​
5. 发送付款

两种操作类型： 先询价（免费，不移动资金）：
带幂等键执行（banking_operation 费用在此处计收）：
响应 202：
  • 最终状态通过 banking_operation_status_changed webhook 送达（completed / failed）；您也可以轮询 GET /v1/banking/operations/{id}。操作达到最终状态后，webhook 中会包含其 receipt_url，并可通过 GET /v1/banking/operations/{id}/receipt 下载 PDF 凭证（凭证）。
  • 使用相同 Idempotency-Key 的重试会返回原始操作（idempotency_hit: true），不会再次收取费用。
完整可追溯性。 每笔银行操作都会记录在您的账户上：它出现在对账单的 banking_operations 部分，其资金在 BANK_USD/BANK_EUR 镜像余额（assets 部分）中对账，其交易量计入分析中的 gross_volume。权威余额仍以银行为准：镜像余额会定期对账。
带筛选条件的完整历史：
每笔银行操作——包括自动从银行发现的入账存款和银行费用——在银行报告这些字段时都会暴露其 direction（in / out）、净额 amount、currency、counterparty 和 reference。这些字段为可选，出现在 GET /v1/banking/operations 和 GET /v1/banking/operations/{id} 中。
banking_operation_status_changed Webhook 在设计上保持轻量： 它只携带标识符和新状态，不包含增强字段。收到该事件后， 请查询操作详情以读取方向、金额、对手方和参考号。参见 webhooks。

​
操作状态

​
错误

​
常见问题

不会。Banking 资金存放在你的银行账户中，通过 GET /v1/banking/accounts/{id}/balance 查询。权威余额始终以银行为准；你的 对账单 会在 BANK_USD/BANK_EUR 镜像余额中对其 进行核对。只有 banking 手续费才会从你的 USDT 余额中扣除。
自动退款 —— 档案、账户和操作的手续费一视同仁。使用相同的 Idempotency-Key 重试会返回原始操作（idempotency_hit: true），绝不会 重复收费。
每种货币一个（USD、EUR）。此外，个人账户总共最多持有 1 个银行账户 （409 banking_account_limit）；企业账户没有限制。
列表只展示按通道配置为你的业务启用的账户。未启用的账户不会出现， 其按 id 的查询会返回 404 not_found —— 如需启用请联系你的 CBPay 团队。
不可以 —— 第三方是企业能力（403 company_required）。登记还需要该第三方 一次已通过的 KYC/KYB 验证的 verification_id。
订阅 banking_operation_status_changed：它在 completed / failed 时触发， 最终状态时附带 receipt_url。你也可以轮询 GET /v1/banking/operations/{id}。
最后修改于 2026年8月5日