跳到主要内容
版本:当前指南

归集 IPP 入款

能力状态​

归集项列表、归集任务查询和列表的商户路由已确认;创建归集的资金执行支持待确认。能查到任务或看到创建入口,不代表目标环境能完成归集。先确认账户获准使用完整执行流程。

Settlement 将已收到的 IPP 资金全额归集到原入款固定钱包。它不是银行出款,也不允许随意改到账地址。直接 ERC-20 转账不属于 IPP 归集项;收款完成、可归集与归集最终完成分别记账。

先查询与核对​

  1. 从订单追溯原入款,按网络、币种和账户环境查询归集项;只有 finalized 的 IPP 入款会进入列表。
  2. 区分 available、in_progress 与 settled,不要把已占用的项当作可再次归集的余额。
  3. 核对入款、项 ID、精确金额、网络、币种和固定到账钱包。分开核对不兼容的资产组合,不能只按代币符号合并。
  4. 查明是否已有任务;对已有任务继续跟踪。尚未确认执行支持时,完成查询和对账准备,不发起资金操作。

执行能力已确认后​

  1. 选择兼容的 available 项。按当前规则保持网络、币种和到账钱包兼容,使用系统校验结果,不自由指定另一收款人。
  2. 技术负责人持久化所选项和幂等键,再创建任务并保存 Settlement ID。所选项被占用后不重复选取。
  3. 等待 preparing 完成;出现 requires_action 时重新查询原任务,使用最新 next_action。
  4. 在钱包核对当前账户与网络,原样使用平台给出的 from、to、data、value,Gas 由钱包估算。不要手改交易参数或把页面示例当成可执行交易。
  5. 商户钱包签名并发送,保存交易哈希与任务 ID;平台自动识别匹配交易,无需另行提交哈希确认。
  6. 持续查询至 succeeded,关联项与最终记录后记为已归集。不能以“钱包已发送”或“有 Hash”作为最终成功。

任务创建后金额、所选项、网络、币种和钱包不可改,没有取消接口;不要等待任务定时自动释放或自动归集。

卡住或失败时​

状态/情况处理
preparing查询原任务,所选项已占用
requires_action 且尚未发送用最新交易继续;拒签不会自动释放项
已发送但仍 requires_action先核对原交易;平台尚未观察到不代表需要重发
processing等待 finalized,不重发、不另建任务
succeeded以最终状态及完成时间记账
failed准备阶段失败,项释放;刷新实际可用项后才决定新任务
HTTP/广播超时或暂查不到保留未知结果,查原任务与交易;不据此判失败或释放占用

只有平台明确回到 requires_action 并提供新交易时才准备再次执行。最低金额、自动频率、补贴和到账时限不在本页承诺。钱包管理见钱包指南,费用核对见费用指南。