费用 - CBPay

费用由 CBPay 按服务、国家和资产配置。若某个组合未配置任何费用，则费用为 0。

出款与收款如何收费

外汇定价体现在您的汇率中：您在 GET /v1/rates 看到的汇率就是您的汇率，也正是执行时所使用的汇率 — 没有额外的百分比。每个国家都包含两个方向：

rate — 您的出款（付款分发）汇率。如果您分发等值 100 USDT 的金额，将被扣除 100 USDT 加上固定费用（若您的账户配置了该费用）。
payin_rate — 您的收款（法币收款/入金）汇率。入账金额为按该汇率换算的本地金额，减去固定费用（若您的账户配置了该费用）。

payout:  usdt_amount   = local_amount / rate
         total_debit   = usdt_amount + fixed_amount
payin:   usdt_gross    = local_amount / payin_rate
         usdt_credited = usdt_gross − fixed_amount

收款人收到的金额（出款）或您获得的入账金额（收款）取决于您账户在该国家的汇率。报价即收费，始终如此。

收取固定或百分比费用的服务

服务	收费方式	收费时点
`payout`	每笔固定费用（外汇定价已包含在您的汇率中）	创建出款时（包含在 `total_debit` 中）
`payin`	每笔固定费用（外汇定价已包含在您的 `payin_rate` 中）	入账时（您收到 `usdt_gross − fee`）
`payin_card`	按收款金额的 `%` + 固定费用，可按处理币种设置不同的 `%`（例如 BOB 与 USD）。若您的账户未配置该服务，则适用通用的 `payin` 费用。可配置结算延迟（见银行卡收款结算延迟）	银行卡支付的收款入账时（`method: "card"` 直接收款、用卡支付的收款链接或订阅扣款）；配置了延迟时，在到达预定时间时入账
`funding`	按充值金额的 `%` + 固定费用	链上充值入账时
`withdrawal`	按提现金额的 `%` + 固定费用	创建时（包含在 `total_debit` 中）
`wallet_creation`	每个钱包固定费用	每次创建钱包时（个人：每条网络 1 个；企业：不限）。查询已有钱包始终免费
`wallet_import`	每次导入固定费用	将外部钱包导入为隔离钱包时（`POST /v1/segregated-wallets/import`）
`wallet_export`	每次导出固定费用	导出隔离钱包私钥时（`POST /v1/segregated-wallets/{id}/export`）
`wallet_send`	每次发送固定费用	从隔离钱包发起链上转账时（`POST /v1/segregated-wallets/{id}/sends`）；网络 gas 由客户承担
`compliance_person`	每次调用固定费用	对个人进行 AML 筛查时（`POST /v1/aml/screenings`）
`compliance_company`	每次调用固定费用	对企业进行 AML 筛查时
`compliance_rescreen`	每次调用固定费用	重新执行 AML 筛查时
`compliance_monitoring`	每次启用固定费用	启用持续 AML 监控时（停用免费）
`kyc_verification`	每次验证固定费用	为第三方创建 KYC 链接或提交时（身份验证）；您自己的开户验证免费
`kyb_verification`	每次验证固定费用	为第三方创建 KYB 链接或提交时
`address_screening`	每次扫描固定费用	评估区块链地址风险时（钱包筛查）；自动的提现/充值防护免费
`banking_customer`	每个档案固定费用	创建您的银行档案时（银行服务）
`banking_account`	每个账户固定费用	开立每个银行账户时
`banking_deposit`	按存款金额的 `%` + 固定费用，以操作币种计收，上限为存款金额	入账银行存款贷记时（见按通道计收的银行费用）
`banking_transfer_ach`	按金额的 `%` + 固定费用，以操作币种计收	发出 ACH 转账时
`banking_transfer_swift`	按金额的 `%` + 固定费用，以操作币种计收	发出 SWIFT 转账时
`banking_transfer_wire`	按金额的 `%` + 固定费用，以操作币种计收	发出 wire（Fedwire）转账时
`banking_transfer_sepa`	按金额的 `%` + 固定费用，以操作币种计收	发出 SEPA 转账时
`banking_operation`	每笔付款固定费用 — 旧版兜底，仅当通道没有专属配置时收取	发送每笔银行付款时（用 `prepare` 报价免费）
`card_creation_virtual`	每张卡固定费用	发行虚拟卡时（卡片）
`card_creation_physical`	每张卡固定费用	发行实体卡时
`card_monthly`	每月固定费用	每张有效卡的月费（无余额时卡片将被冻结 — 不产生欠款）
`card_cancellation`	每张卡固定费用	注销卡片时
`card_purchase_virtual`	按消费美元金额的 `%` + 固定费用	每笔虚拟卡消费（授权时预估，清算时确定；冲正按比例退还）
`card_purchase_physical`	按消费美元金额的 `%` + 固定费用	每笔实体卡消费（周期与虚拟卡相同）
`risk_report_person`	每份报告固定费用	购买个人 Qscore 信用报告时(Qscore);报告失败时自动退款(`risk_report_refund`)
`risk_report_company`	每份报告固定费用	购买企业 Qscore 信用报告时

对于按 % 收费的服务，公式为 fee = ceil(amount × percent / 100) + fixed_amount（向上取整到微 USDT）。

独立的固定收费（合规、KYC/KYB 验证、钱包创建与银行服务）在上游操作失败时会自动退款（compliance_refund / verification_fee_refund / wallet_creation_refund / wallet_service_refund / banking_fee_refund）。

银行卡收款结算延迟

银行卡收款可配置结算延迟（settlement_hours，整数小时数；0 = 无延迟 — 默认值）。配置延迟后，已确认的银行卡收款会立即确认该收款：状态变为 credited，payin_credited webhook 立即发出，用卡支付的收银台链接随即关闭为已支付。等待的是余额：它在结算执行时进入您的账本 —— 到达 settle_at 时（后台任务每分钟结算一次到期收款），或机构管理员在面板中手动提前释放时。余额待结算期间，收款响应（创建、查询和列表）携带 settle_at （RFC 3339）和 settlement_pending: true；余额到账后则携带 settled_at。在付款确认时还会仅发出一次 payin_settlement_scheduled webhook（幂等），携带 status: "credited"、计划的入账金额和 settle_at，便于您的集成区分”已付款、余额已排期”与”已付款、余额已可用”。

{
  "id": "pay_…",
  "status": "credited",
  "settle_at": "2026-08-10T15:04:05Z",
  "settlement_pending": true
}

settle_at = created_at + settlement_hours — 延迟从收款创建时开始计算（≈ 处理商确认扣款时）。审批或分配时已超过期限的收款会立即结算（无 settlement_pending）。自动换汇（如已配置）在余额结算时执行，而非在此之前。

结算仍待处理的收款无法退款：退款会借记您的余额，而这笔资金尚未释放，因此请求将以 422 settlement_pending 被拒。请等待 settle_at 到期，或先请机构管理员手动释放结算 —— 之后退款即可正常进行。

结算延迟由 CBPay 在您账户的 payin_card 费用中配置。您的确认信号不变 —— payin_settlement_scheduled 和 payin_credited 都在付款时送达；只有余额的可用性等待 settle_at。

按通道计收的银行费用

银行业务收取以操作币种计收的交易型费用（即操作所动的 BANK_USD / BANK_EUR 余额）：

存款（banking_deposit）：在入账的存款贷记时收取，上限为存款金额（min(fee, amount)）— 小额存款永远不会导致负余额。
转账（banking_transfer_ach、banking_transfer_swift、 banking_transfer_wire、banking_transfer_sepa）：在发出时收取；您的可用余额必须以操作币种覆盖 金额 + 费用，否则请求将以 402 insufficient_funds 被拒。若转账随后被最终拒绝，费用将退还。
兜底：没有专属配置（账户级和默认级都没有）的通道使用旧版 banking_operation 固定费用（以 USDT 计）。配置为 0% + 0 固定费用的通道为明确免费 — 不会落入兜底。

当收取通道费用时，调度响应会暴露 banking_fee 和 banking_fee_asset（收取的金额及其 BANK_* 货币），因此每笔费用都可归属到其通道。

内部转账：始终免费

CBPay 账户之间的转账（POST /v1/transfers）不收取任何费用，无论何种组合：个人↔个人、个人↔企业或企业↔企业。资金在生态系统内部流转。

您的汇率

GET /v1/rates 返回您账户自己的汇率（按国家划分）— 与您操作执行时使用的汇率完全一致，没有意外：出款使用 rate，收款使用 payin_rate（local_amount / rate = USDT）。

查看您的条款

GET /v1/rates 在返回您的汇率的同时，也返回当前应用于您账户的费用配置：

{
  "base": "USD",
  "rates": { "chile": { "currency": "CLP", "rate": "950.25", "payin_rate": "955.10" } },
  "asset_prices": {
    "USDT": { "currency": "USD", "unit": "usdt", "price": "1" },
    "USDC": { "currency": "USD", "unit": "usdc", "price": "1" },
    "BTC": { "currency": "USD", "unit": "btc", "price": "109853.24" },
    "GOLD": { "currency": "USD", "unit": "gram", "price": "107.5341" }
  },
  "fees": [
    {
      "service": "payout",
      "country": "CL",
      "asset": "USDT",
      "percent": "0",
      "fixed_amount": "0.30"
    }
  ]
}

asset_prices 是每个虚拟余额的 USD 参考价格（用于在界面上估值）— 它不涉及任何换算，也不包含点差。响应中还包含一个 settlement 区块，提供当您用 USDT 之外的余额支付操作时每个资产的有效价格 （资金模型）：该价格已包含换算差价，所见即所得。实际收取的费用始终在每笔操作的响应中明确显示（fee 字段），并记录在账本中。

完整示例

一笔等值 100 USDT 的出款，fixed_amount: "0.30"：

usdt_amount = 100 USDT           (local_amount / rate)
fee         = 0.30 USDT          (fixed)
total_debit = 100.30 USDT

收款人收到您指定的全部本地金额；您被扣除按您的汇率换算的等值金额加上固定费用。一笔等值 100 USDT 的收款，fixed_amount: "0.30"：

usdt_gross    = 100 USDT         (local_amount / payin_rate)
fee           = 0.30 USDT        (fixed)
usdt_credited = 99.70 USDT

付款人支付您指定的确切本地金额；您获得按您的 payin_rate 换算的等值金额减去固定费用。

开始使用

核心概念

集成流程

产品

集成

资源

费用

出款与收款如何收费

收取固定或百分比费用的服务

银行卡收款结算延迟

按通道计收的银行费用

内部转账：始终免费

您的汇率

查看您的条款

完整示例

​出款与收款如何收费

​收取固定或百分比费用的服务

​银行卡收款结算延迟

​按通道计收的银行费用

​内部转账：始终免费

​您的汇率

​查看您的条款

​完整示例

出款与收款如何收费

收取固定或百分比费用的服务

银行卡收款结算延迟

按通道计收的银行费用

内部转账：始终免费

您的汇率

查看您的条款

完整示例