无 API 商户自助收款与资金自动化配置教程
从钱包注册、子合约生成到自动归集与提取的图文操作指南
本文档用于指导无 API 接入商户，通过后台自助完成收款地址生成、预付费充值、KYT 检测、自动归集与自动提取配置，以及黑名单的归集提取。
教程目标
本教程用于指导商户完成从钱包准备、后台注册登录、批量创建子合约、开通预付费、开启 KYT 污染阻断、配置自动归集与提取策略，黑名字资金的归集提取到实际支付测试并查看自动执行结果的完整流程。
使用前准备
- Web3 去中心化钱包，例如 TronLink
- 3个商户管理员钱包地址
- 1个商户财务钱包地址
- 对应链网络资产，例如 TRC20 USDT
- 平台邀请码
- 管理员审核通过后方可登录后台使用
管理员钱包不能使用交易所中心化钱包地址，必须使用可连接、可签名的 Web3 去中心化钱包。
整体流程
- 注册或准备钱包
- 登录商户后台
- 批量创建子合约地址
- 开通预付费账户并充值
- 开启污染阻断 / KYT 检测
- 配置自动归集与提取策略
- 黑名单风险资金归集配置
- 黑名单风险资金归集-提取
- 使用子合约地址完成支付测试
- 查看自动归集与提取结果
一、基础配置
1. 注册或准备钱包
商户在使用系统前，需要先准备 Web3 去中心化钱包，并通过注册页面提交机构信息。本教程以 TRC20 标准版商户为例。
商户可使用已有 Web3 钱包，也可参考官方文档创建新钱包：创建 Web3 钱包
操作说明
在注册页面选择机构类型和区块链网络，填写机构名称、邮箱、管理员钱包地址、财务钱包地址及邀请码，勾选同意《服务协议》后，点击【注册】提交申请。
管理员钱包和财务钱包需使用 Web3 去中心化钱包地址，不能使用交易所钱包地址。
2. 登录商户后台
商户审核通过后，可使用管理员钱包登录后台。
操作说明
打开登录页面，选择注册时对应的区块链网络，例如 Tron(TRC20)，点击【连接 TronLink 钱包】，连接成功后点击【登录】进入后台。
登录时需选择与注册时一致的链网络，并使用已审核通过的管理员钱包。
3. 批量创建子合约地址
商户无需技术对接，可直接在后台批量生成充值子合约地址，用于用户充值和资金收款。
操作说明
进入【资金管理 → 子合约】，点击【创建】，填写创建数量，例如 10 个，子合约类型选择【充值】，然后点击【提交】。
归集方式说明
子合约地址收到用户充值后，商户可以通过两种方式处理资金归集：
- 自动归集：在策略平台配置自动归集规则，系统会按照设定金额自动执行归集。
- 手动归集：商户也可以根据实际资金处理需求，在后台手动发起归集。
归集完成后，子合约资金会进入冷合约。商户后续可以通过自动提取策略，或在后台手动提取，将冷合约资金提取到商户财务钱包。
手动归集操作
进入【资金管理 → 归集】，在【待归集】列表中查看可归集的子合约资金。
勾选需要归集的子合约后，点击【批量归集】按钮。系统会调起钱包签名确认，商户在钱包中点击【Sign】完成签名后，归集交易将提交上链执行，归集成功记录可在【归集记录】列表查询。
手动提取操作
归集成功后，资金会进入冷合约。商户如需将冷合约资金提取到财务钱包，可以进入【资产详情】，点击【一键提取】或进入【提取记录】查看提取结果。
提取操作会将冷合约中的资金转入商户财务钱包，适用于商户需要将已归集资金转入财务钱包进行后续使用的场景。
- 充值子合约地址可直接提供给用户收款。收单地址主要用于地址池扩容，不建议直接给用户充值。
- 手动归集需要登录的管理员或者财务钱包有 TRX，上链需要消耗 gas fee。
- 归集完成后资金进入冷合约，提取完成后资金进入商户财务钱包。
4. 开通预付费账户并充值
商户开通预付费账户后，才可以使用自动归集、自动提取、KYT 检测等自动化策略功能。
操作说明
进入【系统配置 → 策略配置 → 预付费账户】，打开预付费开关，点击【充值】，选择对应充值网络，例如 Tron(TRC20)，复制充值地址或扫描二维码进行 USDT 充值。充值到账后，刷新预付费余额。
使用自动策略前，必须先开通预付费账户并完成充值。自动分发和自动退款属于扩展功能，如需使用需联系技术团队配置。
5. 开启污染阻断 / KYT 检测
污染阻断用于检测用户充值资金是否存在风险。开启后，系统会启用 KYT 检测服务。当检测到风险资金时，对应收款子合约会被标记为黑名单，便于商户后续单独处理。
操作说明
进入【系统配置 → 策略配置 → 策略设置 → 归集策略】，将【污染阻断开关】设置为【开启】，然后点击【保存归集策略】。
开启污染阻断前，需要先开通预付费账户并完成充值。被标记为风险的子合约不会进入正常归集流程。
6. 配置自动归集与提取策略
自动归集用于将子合约资金归集到冷合约。自动提取用于将冷合约资金提取到商户财务钱包。
操作说明
进入【系统配置 → 策略配置 → 策略设置】。在【归集策略】页面设置归集触发条件，例如所有子合约累计余额达到 1000 USDT 时自动归集，或单个子合约余额大于 100 USDT 时自动归集。切换至【提取策略】页面，可设置冷合约余额触发条件，例如冷合约余额达到 100 USDT 后自动提取到商户财务钱包。设置完成后分别点击保存。
自动归集默认每 5 分钟扫描一次，自动提取默认每 30 分钟扫描一次。只有余额达到设置条件后，系统才会自动执行。
7. 黑名单风险资金归集配置
当系统通过 KYT 检测发现某个子合约存在风险时，该子合约可能会被标记为黑名单。黑名单子合约不会进入正常归集流程，商户需要先通过多签配置紧急归集地址和紧急提取地址，用于单独处理风险资金。
黑名单风险资金归集用于将被标记为风险的子合约资金，归集到指定的紧急归集地址。后续商户可根据业务需要，将紧急归集地址中的资金提取到紧急提取地址，用于冻结、审核或退款处理。
操作说明
在【修改参数提案】页面点击【修改】按钮，发起多签参数修改提案。
选择多签类型为【修改紧急提取地址】，地址选择【新增】，然后点击【提交】。系统会调起钱包签名，管理员完成签名后，提案将进入待审批状态。
多签审批说明
提案提交后，需要切换到另一个管理员钱包进行审批。
使用另一个管理员钱包登录后台，进入：系统配置 → 多签管理 → 修改参数提案，找到待审批的提案，点击【审批】，并在钱包中完成签名确认。签名完成后，系统会继续执行上链操作，等待链上确认完成。
8. 黑名单风险资金归集-提取
当子合约因 KYT 检测被标记为黑名单后，该子合约资金不会进入正常归集流程。商户可在后台将黑名单子合约中的风险资金单独归集到紧急归集地址，便于后续冻结、审核或退款处理。
操作说明
进入后台：资金管理 → 归集 → 黑名单
在黑名单列表中勾选需要处理的子合约，点击【批量归集】按钮。系统会调起钱包签名确认，管理员在钱包中完成签名后，归集交易将提交上链执行。
黑名单风险资金提取
黑名单子合约资金完成风险归集后，资金会进入商户通过多签配置的紧急归集地址。商户如需进一步处理，可将紧急归集地址中的资金提取到紧急提取地址，用于后续冻结、审核或退款。
进入后台：资产详情 → 紧急提取
在紧急提取页面中查看紧急归集地址余额，点击【一键提取】按钮。系统会调起钱包签名确认，管理员在钱包中完成签名后，提取交易将提交上链执行。
- 黑名单子合约资金属于风险资金，不会按正常归集流程处理。
- 执行黑名单归集前，需要先通过多签配置好紧急归集地址；执行紧急提取前，需要先通过多签配置好紧急提取地址。
- 黑名单归集和紧急提取都需要管理员钱包签名并提交上链。操作前建议确认资金来源、处理方式和目标地址，避免误操作。
二、实际演示
完成前面的配置后，可以通过一笔实际支付测试自动归集与提取是否正常执行。
9. 使用子合约地址完成支付测试
商户可选择一个已创建的充值子合约地址，将该地址提供给用户付款。
操作说明
进入【资金管理 → 子合约】，复制一个充值子合约地址。用户可使用 Web3 钱包或交易所向该地址转账 USDT。转账完成后，进入【对账中心 → 充值报表】查看对应充值订单。
- 测试金额需要达到前面配置的归集触发条件，否则不会自动触发归集。
- 使用交易所转账时，必须选择正确链网络。
10. 查看自动归集与提取结果
用户支付成功后，如达到策略条件，系统会自动执行归集和提取。
操作说明
查看归集结果：进入【资金管理 → 归集 → 归集记录】。查看提取结果：进入【资产详情 → 提取记录】。
自动任务不是实时执行。归集任务默认每 5 分钟扫描一次，提取任务默认每 30 分钟扫描一次。商户也可以手动归集或提取，参考：商户如何从 UtcPay 提取资金？
三、注意事项汇总
- 使用自动策略前，必须先开通预付费账户并充值。
- 管理员钱包必须使用 Web3 去中心化钱包。
- 充值子合约地址可直接给用户收款。
- 收单地址主要用于地址池扩容，不建议直接给用户充值。
- 开启污染阻断后，风险子合约会进入黑名单，不走正常归集流程。
- 自动归集和自动提取只有在达到触发金额后才会执行。
- 配置完成后必须点击保存。
- 链上交易需要等待区块确认，后台数据可能不会立即刷新。
- 测试支付时，金额需达到配置的触发条件。
- 自动分发和自动退款如需使用，需要联系技术团队配置。
四、完成标准
- 商户注册并审核通过
- 管理员钱包可成功登录后台
- 已批量创建充值子合约地址
- 预付费账户已开通并充值成功
- 污染阻断 / KYT 检测已开启
- 自动归集策略已保存
- 自动提取策略已保存
- 用户向子合约地址支付成功
- 后台可查看充值订单
- 系统自动归集成功
- 系统自动提取成功