交机与 IMEI 回填
1. 目标
商户收到商品全款后，SA 在门店完成交机确认、回填 IMEI，并引导客户在 PocketBuy 还款 App 内成功登录。完成后，手机分期订单进入 Completed，客户可在还款端查看账单和还款计划。
2. 交机前置
| 前置条件 | 说明 |
|---|
订单状态为 Paid | 首付已到账 |
商户放款单为 SUCCESS | 商户已收到商品金额 S |
| 订单未关闭 | 不处于拒绝、取消、超时、异常关闭 |
| SA 有门店权限 | 当前 SA 可操作该门店订单 |
| IMEI 可录入并可反查设备 | 交机现场获取设备 IMEI，并能反查出设备品牌、型号 |
| 客户可登录还款 App | 客户手机号可接收 OTP 或具备既有登录态 |
Paid 只代表首付已到账，不代表可以直接交机。交机必须校验商户放款成功。
3. 交机动作
| 步骤 | 说明 |
|---|
| SA 打开待交机订单 | bns 返回订单、商品、客户、放款结果 |
| 系统校验前置 | bns 校验商户打款单成功 |
| SA 录入 IMEI | IMEI 回填到手机分期订单 |
| 系统反查设备 | 通过 IMEI 反查获取交机设备品牌、型号 |
| 系统校验机型一致 | 将 IMEI 反查出的品牌、型号与进件商品品牌、型号比对 |
| SA 确认交付 | 记录交机时间、SA、门店、设备信息 |
| 引导安装/打开还款 App | 客户用本人手机号登录 PocketBuy 还款 App |
| 登录激活确认 | bns 接收客户还款 App 登录成功信号，或 SA 端查询到登录成功状态 |
| 订单完成 | bns 推进 Paid -> Completed |
4. IMEI 口径
| 项 | MVP 口径 |
|---|
| 采集时点 | 交机时采集 |
| 是否贷前必填 | 否 |
| 是否与试算 IMEI 比对 | 否。不要求试算 IMEI 与交机 IMEI 一致 |
| 是否校验交机机型 | 是。通过 IMEI 反查品牌、型号，并与进件商品品牌、型号一致 |
| 是否触发锁机 | 否 |
| 是否要求还款 App 登录 | 是，客户需在 PocketBuy 还款 App 内成功登录 |
| 是否可为空交机 | 否 |
| 是否唯一 | 同一 IMEI 不允许绑定多个进行中的手机分期订单 |
IMEI 在试算、审批和建借据前不是硬前置；但在交机环节是完成交机的必要校验。系统必须通过 IMEI 反查获取交机设备品牌、型号，并与进件时保存的商品品牌、型号一致后，才允许 Paid -> Completed。
4.1 交机机型一致性校验
| 校验项 | MVP 口径 |
|---|
| 比对时点 | SA 录入交机 IMEI 后、确认交付前 |
| 数据来源 | 交机 IMEI 反查结果 brand、model；进件商品快照 product_snapshot.brand、product_snapshot.model |
| 比对字段 | 品牌、型号必须一致；大小写、空格、常见别名可做标准化后比对 |
| 通过结果 | 保存 IMEI、反查品牌/型号、lookup_id 和校验结果，允许继续交机 |
| 不一致结果 | 阻断交机，提示“交机设备与进件商品不一致”，SA 需核对是否录错 IMEI、拿错机器或进件商品错误 |
| 反查未命中/超时 | 不允许自动完成交机，进入重试或人工核查 |
该校验只确认交付实物的品牌、型号与进件商品一致，不反向修改已审批商品信息，也不重新触发信贷政策试算。
5. 与锁机的关系
MVP 不建设锁机服务，但保留“安装/打开 PocketBuy 还款 App 并成功登录”的交机步骤。这里的 Activation Status 指还款 App 登录激活状态，不是锁机激活状态。
| 后置动作 | 说明 |
|---|
| 锁机客户端安装校验 | Phase 2 |
| 锁机激活状态轮询 | Phase 2 |
| 逾期锁机策略 | Phase 2 |
| 解锁策略 | Phase 2 |
| 锁机状态参与订单完成 | MVP 不参与 |
6. 还款 App 登录激活
| 项 | MVP 口径 |
|---|
| 页面动作 | 交机页展示 PocketBuy 还款 App 安装/打开指引 |
| 判定逻辑 | 客户在 PocketBuy 还款 App 内用本人手机号成功登录 |
| 登录凭证 | 还款 App 登录成功事件，至少包含客户号、手机号、登录时间、设备或会话引用 |
| SA 端展示 | Waiting for customer login / Login confirmed |
| 与锁机关系 | 不调用锁机接口，不读取锁机状态，不作为锁机激活 |
| 失败处理 | 订单保持 Paid，SA 可重试引导登录；无法登录时进入人工处理 |
7. 异常处理
| 异常 | 处理 |
|---|
| 商户放款未成功 | 阻断交机，提示等待或联系后台处理 |
| IMEI 已被其他进行中订单占用 | 阻断交机，需人工核查 |
| IMEI 格式异常 | 前端提示修正 |
| IMEI 反查未命中或超时 | 阻断交机，允许重试；仍失败则进入人工核查 |
| IMEI 反查品牌/型号与进件不一致 | 阻断交机，提示核对设备或进件商品信息 |
| 客户还款 App 登录失败 | 阻断完成，提示重试 OTP 或联系后台 |
| SA 无门店权限 | 阻断操作 |
| 客户拒绝收机 | 订单保持 Paid，进入人工处理 |
| 已交机后发现 IMEI 错误 | MVP 先人工更正，保留操作记录 |
8. 验收口径
| 验收点 | 通过标准 |
|---|
| 放款未成功 | SA 不能完成交机 |
| IMEI 回填 | 订单保存 IMEI、交机时间、SA、门店 |
| 交机机型一致性 | 录入 IMEI 后必须反查品牌、型号，并与进件商品品牌、型号一致；不一致不能完成交机 |
| 还款 App 登录 | 客户在 PocketBuy 还款 App 内成功登录后，SA 端可看到登录确认 |
| 锁机 | 不触发任何锁机接口 |
| 完成态 | 商户放款成功、IMEI 回填、IMEI 反查机型一致、客户还款 App 登录成功后订单进入 Completed |
9. 交机确认接口契约
| 项 | 内容 |
|---|
| 调用方向 | PocketBuy SA -> bns |
| 触发时点 | 商户放款成功、IMEI 回填且客户还款 App 登录成功后，SA 现场交机 |
| 前置 | 订单 Paid，商户放款单 SUCCESS |
| 成功后状态 | Completed |
请求字段：
| 字段 | 必填 | 说明 |
|---|
installment_order_id | 是 | 订单号 |
imei | 是 | 交机设备 IMEI |
imei_lookup_id | 是 | 本次 IMEI 反查记录 ID |
imei_lookup_brand | 是 | IMEI 反查品牌 |
imei_lookup_model | 是 | IMEI 反查型号 |
sa_id | 是 | 操作 SA |
store_id | 是 | 交机门店 |
delivered_at | 是 | 交机时间 |
customer_confirmed | 是 | 客户确认收机 |
repayment_app_login_confirmed | 是 | 客户还款 App 是否已成功登录 |
repayment_app_login_at | 条件 | 登录成功时间 |
repayment_app_session_ref | 否 | 还款 App 登录会话或事件引用 |
device_photo_ref | 否 | 设备/包装照片 |
remark | 否 | 备注 |
校验规则：
| 校验 | 失败处理 |
|---|
订单必须为 Paid | 返回 ORDER_STATUS_INVALID |
商户放款单必须 SUCCESS | 返回 MERCHANT_DISBURSEMENT_NOT_SUCCESS |
| SA 必须有门店权限 | 返回 SA_STORE_NOT_AUTHORIZED |
| IMEI 格式合法 | 返回 IMEI_INVALID |
| IMEI 必须反查成功 | 返回 IMEI_LOOKUP_REQUIRED 或 IMEI_LOOKUP_FAILED |
| IMEI 反查品牌/型号必须与进件商品一致 | 返回 DELIVERY_DEVICE_NOT_MATCHED |
| IMEI 未绑定其他进行中订单 | 返回 IMEI_ALREADY_USED |
| 客户还款 App 必须已登录成功 | 返回 REPAYMENT_APP_LOGIN_REQUIRED |
交机确认不调用锁机接口，不等待锁机激活；但必须确认客户已在 PocketBuy 还款 App 内成功登录，并完成 IMEI 反查机型一致性校验。