# 购物订单
该功能已停止维护
# 一、购物订单产品介绍
# 1. 购物订单是什么
购物订单收纳用户线上购物相关订单信息，可帮助用户查看/管理订单，追踪订单进展、获取售后服务等；
用户可以从微信「我」-「服务」-「钱包」-「账单」中进入，也可以从支付凭证消息进入账单详情页查看购物订单，其他中心化入口正在规划中。
# 2. 产品特点与优势
连接丰富场景：用户在微信内如视频号/朋友圈/小程序/会话窗口等场景下单购物，都能在账单详情页>购物订单查看订单信息，点击跳转至商户的订单详情页；
售前售后打通：购物订单便于用户在微信内购物后找回订单，回到商家交易场景中确认收货地址、查看物流状态、发起咨询等；
沉淀购物记录：用户可查看到此前在微信内各场景所购买的商品详细信息，方便用户再次购买同类商品或进店选购其它商品，提升用户购物体验。
# 3. 交互体验
# 二、确认开发模式
确定开发模式后，即可参考下述各自对应的接入指引。
# 三、商户自开发
步骤1: 商户登录小程序管理后台，开通产品权限
步骤2: 上传购物详情、物流信息
步骤3: 开发自测完成，提交审核
步骤4: 平台审核通过，面向用户侧曝光
# 1. 商户登录小程序管理后台，签署服务协议并开通权限
# 2. 点击开通，签署协议
若开通失败，展示“经营类目不在开放范围”，则请按照指引申请接入。
# 3. 上传购物详情、物流信息
- 普通支付：若发起订单的交易类型非合单支付，请调用「上传购物详情」API、「上传物流详情」API
- 合单支付：若发起订单的交易类型为合单支付，请调用「上传合单购物详情」API、「上传合单物流详情」API
# 4. 使用测试工具
关联结果：
- 购物详情需与用户支付结果关联成功才算完成上传，但商户上传购物详情与用户支付为异步链路，无法在接口中实时返回关联结果；
- 可使用此测试工具或调用「验证购物订单上传结果」API，校验订单是否关联成功。
界面预览：在审核通过前，商户上传内容未对用户曝光。若需要预览上传样式，也可通过此工具查看。
# 5. 自测完成，提交审核
- 提交审核：确认购物订单均在用户支付后5s内上传，即可在小程序管理后台上点击“提交审核”；
- 审核结果：预计6小时可到mp平台查看审核结果；若未通过，则请按照指引进行优化。
# 6. 查看平台审核结果
# 6.1 审核通过，面向用户侧曝光
- 曝光条件：待平台审核通过后，即自动面向用户曝光。
- 曝光范围：即用户在支付凭证、账单详情页、订单列表页等多个入口可见购物订单信息。
# 6.2 审核失败，请按照指引调整
- 失败原因：开发者上传速度较慢，需要保证在用户支付成功后5s内完成上传。
- 后续审核：开发者无需重新提交审核，平台默认每6小时滚动审核，直至审核通过。通过后，开发者的购物订单信息将面向用户曝光。
# 四、服务商代开发
步骤1: 服务商申请权限集（小程序120/公众号121）
步骤2: 上传购物详情、物流信息
步骤3: 开发自测完成，提交审核
步骤4: 平台审核通过，面向用户侧曝光
# 1. 服务商申请权限集
权限集号码：（小程序120/公众号121）
申请授权流程：服务商需要生成授权码，邀请商户的小程序管理员扫码授权并签署协议；后续调用「开通购物订单产品权限」API开通权限。
注意：请提醒商户点击签署《购物订单协议》，否则后续接口无法调用成功。若首次未签署，可通过重新授权码再次拉起协议页面。
# 2. 上传购物详情、物流信息
- 普通支付：若发起订单的交易类型非合单支付，请调用「上传购物详情」API、「上传物流详情」API
- 合单支付：若发起订单的交易类型为合单支付，请调用「上传合单购物详情」API、「上传合单物流详情」API
# 3. 使用测试工具
- 购物详情需与用户支付结果关联成功才算完成上传，但商户上传购物详情与用户支付为异步链路，无法在接口中实时返回关联结果。
- 可调用「验证购物订单上传结果」API，检验订单是否关联成功。
# 4. 开发自测完成，提交审核
- 请调用「验证购物订单上传结果」API，校验上传订单质量。
- 自测通过后，请调用「提交购物订单接入审核」API，提交平台审核。
# 5. 查看平台审核结果
6个小时后，开发者可再次调用「提交购物订单接入审核」API，返回参数将包含最近一次的审核结果。
# 5.1 审核成功，面向用户曝光
- 曝光条件：待平台审核通过后，即自动面向用户曝光。
- 曝光范围：即用户在支付凭证、账单详情页、订单列表页等多个入口可见购物订单信息。
# 5.2 审核失败，请按照指引调整
- 失败原因：开发者上传速度较慢，需要保证在用户支付成功后5s内完成上传。
- 后续审核：开发者无需重新提交审核，平台默认每6小时滚动审核，直至审核通过。通过后，开发者的购物订单信息将面向用户曝光。
# 五、FAQ
# 1. 购物详情中必须上传「支付服务商的商户号」吗？
视情况而定。小程序开发者可通过以下两种方式上传购物详情：
- 下单商户号+商户订单号：若此时为支付服务商代替商户进行下单，则需要上传支付服务商的商户号；
- 微信支付订单号：此时不需要获取下单商户号。
# 2. 开通过程中，提示无开通购物订单权限？
开发者可按照指引申请接入此功能：购物订单申请流程
