# 上传购物详情
接口应在服务器端调用,详细说明参见服务端API。
# 接口说明
# 接口英文名
uploadShoppingInfo
# 功能描述
- 调用此接口上传订单信息
- 该接口用于商户接入购物订单业务。商户接入后,可帮助用户查看/管理微信内购物的订单,追踪订单进展、获取售后服务等。用户后续可以从微信「我」-「服务」-「钱包」-「账单」中进入,也可以从支付凭证消息进入账单详情页回溯已购物的订单。
- 具体业务介绍及完整接入指南可参见 购物订单。
# 注意事项
- 根据指定的订单单号类型,采用不同参数给指定订单上传订单信息
- 商户侧单号形式(枚举值1),通过下单商户号和商户侧单号确定一笔订单
- 微信支付单号形式(枚举值2),通过微信支付单号确定一笔订单
- 商户交易订单详情页链接类型为小程序时,appid需要为调用api的appid,如果是第三方调用,则为第三方代上传商家的appid
- 链接类型为小程序(枚举值1)时,链接的appid和path必填,链接类型为url(枚举值2)时URL必填
- 上传时间,用于标识请求的先后顺序,如果要更新订单信息,上传时间必须比之前的请求更新,请按照Rfc3399格式填写
- 在订单支付完成关联订单信息成功后不可以修改订单信息
- 物流形式根据自身物流发货形式填写
- 实体物流配送(枚举值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_list | array<object> | 否 | 购物详情列表 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
payer | object | 是 | 支付者,支付者信息 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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需要为小程序类型 |