上传购物详情

上传购物详情

接口应在服务器端调用，详细说明参见服务端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_typenumber否订单单号类型，用于确认需要上传详情的订单transaction_idstring否原支付交易对应的微信订单号mchidstring否支付下单商户的商户号，由微信支付生成并下发。out_trade_nostring否商户系统内部订单号，只能是数字、大小写字母_-*且在同一个商户号下唯一
order_list array 否 购物详情列表
属性类型必填说明merchant_order_nostring是商户交易订单编号，商户侧的交易订单详情页向用户展示的订单编号示例值: 232457563423 字符字节限制: [1, 64]order_detail_jump_linkobject是商户交易订单详情页链接，用户查看“商城订单”时，跳转至商户侧查看交易订单详情页的链接。详情页类别可以为H5或小程序属性类型必填说明urlstring否链接地址（链接类型为H5时必填）示例值: https://www.weixin.qq.com/wxpay/pay.php 字符字节限制: [1, 1024] 匹配正则表达式: https?😕/([\s/?#[]@]+@)?([\s/?#@:]+)(?::\d{2,5})?([[]])$appidstring否小程序appid（链接类型为MINIAPP时必填）示例值: wxd678efh567hg6787 字符字节限制: [1, 32]pathstring否小程序path（链接类型为MINIAPP时必填）示例值: /path/index/index 字符字节限制: [1, 512]typenumber是链接类型枚举值：1、URL；2、MINI_PROGRAM示例值: MINI_PROGRAMitem_listarray
payer object 是 支付者，支付者信息
属性类型必填说明openidstring是用户标识，用户在商户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需要为小程序类型
posted on 2025-01-16 08:39  AtlasLapetos  阅读(21)  评论(0)    收藏  举报

博客园  ©  2004-2025
浙公网安备 33010602011771号 浙ICP备2021040463号-3