developer_fee_rate 会将该笔充值拆分为商户份额和开发者份额；每笔为正数的份额都会独立计入各自的账户账本，但若开发者份额取整后为 0，则仅记录商户侧账本，不生成开发者侧记录。完整的拆分示例请参考账户与资金分配。如需配置或调整费率，请参考商户管理。您可以调用 List payer transactions 查看实际到账的总金额，调用 List merchant balances 和 Get developer balance 查看账户余额，调用 List balance changes 查看具体的账本明细。
获取充值地址
您可以通过 Payments App 或 Payments API 获取充值地址。将充值地址提供给付款方后，付款方可以随时向该地址充值任意金额。前提条件
您已完成前置准备中提到的所有步骤。操作步骤
- Payments App
- Payments API
1. 创建付款方
您需要先创建付款方，然后获取该付款方对应的充值地址：- 登录 Cobo Portal 开发环境或生产环境。
- 在左侧导航栏中点击 Apps，然后点击 Payments 卡片，启动 App。
- 在 App 的左侧导航栏中点击收款 > 充值。
- 点击右上角的创建付款方按钮。
- 在弹出的表单中：
- 选择商户。该付款方充值地址收到的充币会通过付款方进行归属，并路由到创建该付款方及地址时绑定的商户。完整的资金归属模型请参考账户与资金分配。
- 选择代币和网络。Cobo 会为该付款方创建一个该网络上的专属充值地址。创建付款方后，您还可以为该付款方在其他网络上创建更多充值地址，以支持多链充值。
- 输入自定义付款方 ID。此 ID 需要是此付款方在您的系统中的唯一标识。
- 点击创建完成付款方创建。
2. 获取充值地址
- 在付款方列表中找到目标付款方，然后点击右侧的查看地址按钮。
- 您可以在地址列表中查看已创建好的地址。如果您想要添加其他公链上的地址，可以点击创建地址按钮进行创建。
- 将所需充值地址提供给付款方，完成支付。
获取充值模式相关事件
您可以订阅以下 Webhook 事件，以获取充值地址以及充值交易的实时更新通知。请参考 Webhook reference 了解每个事件的触发时间和返回的数据结构。payment.transaction.createdpayment.transaction.completed
- Payments App：在 App 的左侧导航栏中点击收款 > 充值，在付款方列表中找到目标付款方，点击右侧的查看交易按钮即可查看该付款方的所有充值记录。
- Payments API：调用 List payers 获取所有付款方及其充值交易的详细信息。
异常处理
在充值模式下，您可能要处理以下几种异常情况。充值地址更换
您可以主动更换某一个付款方的充值地址。Cobo 也会在特定情况下自动更换充值地址。主动更换地址
当您需要更换充值地址时（例如因业务变更、内部风险评估或其他业务需求），可以通过 Payments App 或 Payments API 创建新地址。- Payments App：在付款方列表中找到目标付款方，然后点击右侧的查看地址按钮。在地址列表中，点击创建地址按钮进行创建。
- Payments API：调用 Update top-up address 创建新地址。
对于单个付款方，最多可进行 10 次地址更换，超过次数上限会出现接口请求报错。
地址更换后的影响
- 交易监听：Cobo 会继续监听老地址的交易活动，交易会触发对应的 Webhook 通知。
- 资金处理：该地址与商户的关联关系依然存在，更换地址后充币仍会归属到同一商户。完整的资金归属与结算模型请参考账户与资金分配。在资金转出前，Cobo 还会自动将这些地址中的充值资金进行归集。详情请参考自动资金归集。
- 地址查询：您在 Payments App 上可以查看付款方历史上所有绑定过的地址。
合规筛查不通过
当某笔交易收到payment.transaction.failed 事件时，这表明该笔交易未能通过 Cobo KYT 或 Screening App 的合规筛查。这种情况下，您需要按照以下步骤进行处理：
- 若该笔交易后续通过人工审核：该笔资金将计入充值金额。
- 若该笔交易最终未通过人工审核：资金将被冻结，不会被计入充值金额
- Cobo KYT：请通过 [email protected] 联系 Cobo 支持团队处理
- Screening App：您可以在应用内自行评估和处理