动态-流程图
说明客户在渠道商本地系统下单购买动态住宅流量时，本地流程与 IPmart 侧如何配合。接入前建议先阅读本页，再查看对应接口文档。
流程图
场景说明
| 角色 | 说明 |
|---|---|
| 本地系统 | 渠道商自有的售卖 / 下单 / 支付系统 |
| 本地用户 | 在渠道商本地注册的客户 |
| IPmart 用户 | 渠道商通过 API 在 IPmart 创建的子客户 |
| 渠道商 | 在 IPmart 持有预付款，为子客户下单并扣减余额 |
本地系统负责对客户展示套餐、收款与额度展示；IPmart 负责子客户、订单与流量分配。两侧通过永不变化的本地用户编号 ID 做用户关联，并通过订单绑定做订单关联。
步骤说明
1. 本地下单与支付
- 客户在本地系统选择套餐包。
- 本地系统下单。
- 客户支付完成后，本地进入后续对接逻辑（见第 2、3 步），同时本地订单状态可进入「流量分配中」。
2. 用户绑定
支付完成后，判断：本地用户是否已绑定 IPmart 用户。
| 情况 | 处理 |
|---|---|
| 已绑定 | 直接进入第 3 步「IPmart 创建订单」 |
| 未绑定 | 先调用 IPmart 创建用户（添加子客户），再将 IPmart 用户绑定本地用户（通过永不变化的本地用户编号 ID 关联），然后进入第 3 步 |
3. IPmart 下单与流量分配
- IPmart 创建订单，并将 IPmart 订单绑定本地订单（保存双方订单号的对应关系）。
- IPmart 支付订单：扣减渠道商在 IPmart 的预付款。
- IPmart 完成流量分配。
说明
图中「创建订单」与「支付订单」在接口上可由 动态-给子用户下单并余额支付 一次完成；拆成两步是为了说明业务含义。
4. 本地轮询与完成
- 本地在「流量分配中」状态下，轮询检测 IPmart 流量是否已分配完成（例如 检查订单状态）。支付刚完成时，IPmart 订单可能尚未创建，轮询需兼容「尚未创建 / 处理中 / 已完成」，避免一查空就判失败。
- 检测到完成后，本地标记流量分配完成。
- 向客户展示流量剩余额度（例如 动态-查询子用户代理信息）。
流程要点
- 先绑用户，再下单：未绑定的本地用户必须先创建并关联 IPmart 子客户，再创建 IPmart 订单。
- 用户关联键固定：本地用户编号 ID 一经确定不要变更，否则无法找回已绑定的 IPmart 用户。
- 订单双向绑定：创建 IPmart 订单后立即保存与本地订单的对应关系，便于支付、轮询与对账。
- 以轮询确认分配：本地「支付完成」不等于流量已可用；需轮询至 IPmart 流量分配完成后再展示额度。轮询初期可能尚无 IPmart 订单，属正常情况。
- 下单与支付可合并：业务上分「创建订单 → 支付扣款」两步；对接 动态-给子用户下单并余额支付 时通常一次调用即可。