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