# 上传购物详情

接口应在服务器端调用,详细说明参见服务端API

# 接口说明

# 接口英文名

uploadShoppingInfo

# 功能描述

  1. 调用此接口上传订单信息
  2. 该接口用于商户接入购物订单业务。商户接入后,可帮助用户查看/管理微信内购物的订单,追踪订单进展、获取售后服务等。用户后续可以从微信「我」-「服务」-「钱包」-「账单」中进入,也可以从支付凭证消息进入账单详情页回溯已购物的订单。
  3. 具体业务介绍及完整接入指南可参见 购物订单

# 注意事项

  1. 根据指定的订单单号类型,采用不同参数给指定订单上传订单信息
    • 商户侧单号形式(枚举值1),通过下单商户号和商户侧单号确定一笔订单
    • 微信支付单号形式(枚举值2),通过微信支付单号确定一笔订单
  2. 商户交易订单详情页链接类型为小程序时,appid需要为调用api的appid,如果是第三方调用,则为第三方代上传商家的appid
  3. 链接类型为小程序(枚举值1)时,链接的appid和path必填,链接类型为url(枚举值2)时URL必填
  4. 上传时间,用于标识请求的先后顺序,如果要更新订单信息,上传时间必须比之前的请求更新,请按照Rfc3399格式填写
  5. 在订单支付完成关联订单信息成功后不可以修改订单信息
  6. 物流形式根据自身物流发货形式填写
    • 实体物流配送(枚举值1),采用快递公司进行实体物流配送形式
    • 同城配送(枚举值2)
    • 虚拟商品(枚举值3),虚拟商品,例如话费充值,点卡等,无实体配送形式

# 调用方式

# HTTPS 调用


POST https://api.weixin.qq.com/user-order/orders?access_token=ACCESS_TOKEN 

# 第三方调用

  • 调用方式以及出入参和HTTPS相同,仅是调用的token不同

  • 该接口所属的权限集id为:120、121

  • 服务商获得其中之一权限集授权后,可通过使用authorizer_access_token代商家进行调用

# 请求参数

属性 类型 必填说明
access_token string 接口调用凭证,该参数为 URL 参数,非 Body 参数。使用getAccessToken 或者 authorizer_access_token
order_key object 订单,需要上传购物详情的订单,根据订单类型二选一
属性 类型 必填 说明
order_number_type number 订单单号类型,用于确认需要上传详情的订单
transaction_id string 原支付交易对应的微信订单号
mchid string 支付下单商户的商户号,由微信支付生成并下发。
out_trade_no string 商户系统内部订单号,只能是数字、大小写字母_-*且在同一个商户号下唯一
order_list array<object> 购物详情列表
属性 类型 必填 说明
merchant_order_no string 商户交易订单编号,商户侧的交易订单详情页向用户展示的订单编号

示例值: 232457563423 字符字节限制: [1, 64]

order_detail_jump_link object 商户交易订单详情页链接,用户查看“商城订单”时,跳转至商户侧查看交易订单详情页的链接。详情页类别可以为H5或小程序
属性 类型 必填 说明
url string 链接地址(链接类型为H5时必填)

示例值: https://www.weixin.qq.com/wxpay/pay.php 字符字节限制: [1, 1024] 匹配正则表达式: ^https?😕/([^\s/?#[]@]+@)?([^\s/?#@:]+)(?::\d{2,5})?([^[]]*)$

appid string 小程序appid(链接类型为MINIAPP时必填)

示例值: wxd678efh567hg6787 字符字节限制: [1, 32]

path string 小程序path(链接类型为MINIAPP时必填)

示例值: /path/index/index 字符字节限制: [1, 512]

type number 链接类型枚举值:1、URL;2、MINI_PROGRAM

示例值: MINI_PROGRAM

item_list array<object> 订单购买的商品列表,用户在订单中购买的全部商品明细的列表,最多可以上传50个商品

多重性: [1, 50]

属性 类型 必填 说明
merchant_item_id string 商户侧商品ID,商户系统内部商品编码,用于标识不同的商品。请注意,当发货模式选择“分拆发货”时,需要使用商户侧商品ID来标记各物流单中包含的具体商品

示例值: 1246464644 字符字节限制: [1, 64]

name string 商品名称

示例值: iPhoneX 256G 字符长度限制: [1, 256]

description string 商品描述

示例值: Image形象店-深圳腾大-QQ公仔 字符长度限制: [1, 512]

unit_price number 商品单价(单位:分)

示例值: 828800

quantity number 购买数量

示例值: 2

image_url array<string> 商品图片链接

示例值: https://qpic.cn/xxx 多重性: [1, 3] 字符字节限制: [1, 1024] 匹配正则表达式: ^https?😕/([^\s/?#[]@]+@)?([^\s/?#@:]+)(?::\d{2,5})?([^[]]*)$

payer object 支付者,支付者信息
属性 类型 必填 说明
openid string 用户标识,用户在商户appid下的唯一标识。 下单前需获取到用户的Openid 示例值: oUpF8uMuAJO_M2pxb1Q9zNjWeS6o 字符字节限制: [1, 128]
logistics_type number 物流形式,订单商品配送的物流形式,默认为实体物流
upload_time string 上传时间,用于标识请求的先后顺序

示例值: 2022-05-20T13:29:35.120+08:00

# 返回参数

属性 类型 说明
errcode number 错误码
errmsg string 错误原因

# 调用示例

示例说明: JS Fetch API

# 请求数据示例


// 拼装URL
let url = `https://api.weixin.qq.com/user-order/orders`;


// Json包体
let jsonBody = {};
jsonBody["order_key"] = {
   "order_number_type": "WXPAY_TRADE_NUMBER",
   "transaction_id": "0unu3",
   "mchid": "idgsc",
   "out_trade_no": "e8zef"
};
jsonBody["order_list"] = [
   {
      "merchant_order_no": "232457563423",
      "order_detail_jump_link": {
         "url": "https://www.weixin.qq.com/wxpay/pay.php",
         "appid": "wxd678efh567hg6787",
         "path": "/path/index/index",
         "type": "MINI_PROGRAM"
      },
      "item_list": [
         {
            "merchant_item_id": "1246464644",
            "name": "iPhoneX 256G",
            "description": "Image形象店-深圳腾大-QQ公仔",
            "unit_price": 828800,
            "quantity": 2,
            "image_url": [
               "https://qpic.cn/xxx",
               "https://qpic.cn/xxx",
               "https://qpic.cn/xxx"
            ],
            "item_detail_jump_link": {
               "url": "https://www.weixin.qq.com/wxpay/pay.php",
               "appid": "wxd678efh567hg6787",
               "path": "/path/index/index",
               "type": "URL"
            }
         },
         {
            "merchant_item_id": "1246464644",
            "name": "iPhoneX 256G",
            "description": "Image形象店-深圳腾大-QQ公仔",
            "unit_price": 828800,
            "quantity": 2,
            "image_url": [
               "https://qpic.cn/xxx",
               "https://qpic.cn/xxx"
            ],
            "item_detail_jump_link": {
               "url": "https://www.weixin.qq.com/wxpay/pay.php",
               "appid": "wxd678efh567hg6787",
               "path": "/path/index/index",
               "type": "MINI_PROGRAM"
            }
         },
         {
            "merchant_item_id": "1246464644",
            "name": "iPhoneX 256G",
            "description": "Image形象店-深圳腾大-QQ公仔",
            "unit_price": 828800,
            "quantity": 2,
            "image_url": [
               "https://qpic.cn/xxx",
               "https://qpic.cn/xxx",
               "https://qpic.cn/xxx"
            ],
            "item_detail_jump_link": {
               "url": "https://www.weixin.qq.com/wxpay/pay.php",
               "appid": "wxd678efh567hg6787",
               "path": "/path/index/index",
               "type": "URL"
            }
         }
      ]
   },
   {
      "merchant_order_no": "232457563423",
      "order_detail_jump_link": {
         "url": "https://www.weixin.qq.com/wxpay/pay.php",
         "appid": "wxd678efh567hg6787",
         "path": "/path/index/index",
         "type": "URL"
      },
      "item_list": [
         {
            "merchant_item_id": "1246464644",
            "name": "iPhoneX 256G",
            "description": "Image形象店-深圳腾大-QQ公仔",
            "unit_price": 828800,
            "quantity": 2,
            "image_url": [
               "https://qpic.cn/xxx",
               "https://qpic.cn/xxx"
            ],
            "item_detail_jump_link": {
               "url": "https://www.weixin.qq.com/wxpay/pay.php",
               "appid": "wxd678efh567hg6787",
               "path": "/path/index/index",
               "type": "URL"
            }
         },
         {
            "merchant_item_id": "1246464644",
            "name": "iPhoneX 256G",
            "description": "Image形象店-深圳腾大-QQ公仔",
            "unit_price": 828800,
            "quantity": 2,
            "image_url": [
               "https://qpic.cn/xxx",
               "https://qpic.cn/xxx",
               "https://qpic.cn/xxx"
            ],
            "item_detail_jump_link": {
               "url": "https://www.weixin.qq.com/wxpay/pay.php",
               "appid": "wxd678efh567hg6787",
               "path": "/path/index/index",
               "type": "URL"
            }
         }
      ]
   },
   {
      "merchant_order_no": "232457563423",
      "order_detail_jump_link": {
         "url": "https://www.weixin.qq.com/wxpay/pay.php",
         "appid": "wxd678efh567hg6787",
         "path": "/path/index/index",
         "type": "MINI_PROGRAM"
      },
      "item_list": [
         {
            "merchant_item_id": "1246464644",
            "name": "iPhoneX 256G",
            "description": "Image形象店-深圳腾大-QQ公仔",
            "unit_price": 828800,
            "quantity": 2,
            "image_url": [
               "https://qpic.cn/xxx",
               "https://qpic.cn/xxx",
               "https://qpic.cn/xxx"
            ],
            "item_detail_jump_link": {
               "url": "https://www.weixin.qq.com/wxpay/pay.php",
               "appid": "wxd678efh567hg6787",
               "path": "/path/index/index",
               "type": "URL"
            }
         },
         {
            "merchant_item_id": "1246464644",
            "name": "iPhoneX 256G",
            "description": "Image形象店-深圳腾大-QQ公仔",
            "unit_price": 828800,
            "quantity": 2,
            "image_url": [
               "https://qpic.cn/xxx",
               "https://qpic.cn/xxx"
            ],
            "item_detail_jump_link": {
               "url": "https://www.weixin.qq.com/wxpay/pay.php",
               "appid": "wxd678efh567hg6787",
               "path": "/path/index/index",
               "type": "MINI_PROGRAM"
            }
         },
         {
            "merchant_item_id": "1246464644",
            "name": "iPhoneX 256G",
            "description": "Image形象店-深圳腾大-QQ公仔",
            "unit_price": 828800,
            "quantity": 2,
            "image_url": [
               "https://qpic.cn/xxx",
               "https://qpic.cn/xxx"
            ],
            "item_detail_jump_link": {
               "url": "https://www.weixin.qq.com/wxpay/pay.php",
               "appid": "wxd678efh567hg6787",
               "path": "/path/index/index",
               "type": "MINI_PROGRAM"
            }
         }
      ]
   }
];
jsonBody["payer"] = {
   "openid": "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o"
};
jsonBody["logistics_type"] = "LOCATION_BASED_LOGISTICS";
jsonBody["upload_time"] = "2022-05-20T13:29:35.120 08:00";

// 设置包头
let headers = {"Content-Type": "application/json"};


// 发送请求
fetch(url, {
  body: JSON.stringify(jsonBody),
  headers: headers,
  method: "POST"
})
  .then(response => response.json())
  .then(response => console.log("Success:", JSON.stringify(response)))
  .catch(error => console.error("Error:", error)); 

# 返回数据示例


{ 
"errcode":0, 
"errmsg":"ok"
} 

# 错误码

错误码 错误码取值 解决方案
-1 system error 系统繁忙,此时请开发者稍候再试
268435461 参数错误 根据错误原因描述修改参数
268485191 购物详情列表不能为空 购物详情列表中至少需要填写一个购物详情
268485192 用户标识openid为空 用户标识openid必须填写
268485193 物流形式非法 按照文档中物流形式枚举设置该字段
268485214 上传时间必须设置 上传时间必须填写
268485216 上传时间非法,请按照Rfc3399格式填写 上传时间必须满足Rfc3399格式,如2021-05-20T13:29:35.120+08:00
268485195 微信支付单号形式下transaction_id字段必须设置 微信支付单号形式下transaction_id字段必须设置
268485196 商户侧单号形式下mchid字段必须设置 商户侧单号形式下mchid字段必须设置
268485197 商户侧单号形式out_trade_no字段必须设置 商户侧单号形式下out_trade_no字段必须设置
268485194 订单单号类型非法 按照文档中订单类型枚举填写该字段
268485201 商户交易订单编号为空 商户侧订单号形式下商户交易订单必须填写
268485204 链接类型为小程序时,appid不能为空 链接类型为小程序必须设置appid
268485205 链接类型为小程序时,path不能为空 链接类型为小程序必须设置path
268485206 链接类型为URL时,需要设置url 链接类型为URL必须设置url
268485211 订单购买的商品列表不能为空 订单购买的商品列表不能为空
268485207 商品名称不能为空 商品名称必须填写
268485208 商品单价不能为空 商品单价必须填写
268485209 购买数量不能为空 购买数量必须填写
268485210 商品图片链接不能为空 商品图片链接至少填写一个
268485272 商品详情链接不能为空 商品详情链接必须设置
268485202 链接类型非法 链接类型必须是小程序或URL
268486029 链接类型为小程序时,链接appid必须和购物详情归属商家appid一致 链接类型为小程序时,链接appid填写为商家appid
268459788 订单详情页与商品详情页跳转类型应保持一致 订单详情页与商品详情页跳转类型填写的跳转类型一致
268459789 订单详情页与商品详情页appid需保持一致 订单详情页与商品详情页appid设置值一致
268486047 同一笔内部订单中商品id不能重复 同一笔内部订单中商品id不重复设置
268459786 商户内部订单号重复 商户内部订单号需要互不相同
268485184 无购物订单产品权限 无购物订单产品权限,请先申请购物订单产品权限后再调用
268456389 Appid非小程序类型 当指定链接类型为小程序时,设置的链接appid需要为小程序类型