获取订单详情 | 微信开放文档

# 获取订单详情

# 接口调用请求说明

可以按照支付单号或者外部订单号来查询业务单详情、支付单详情、支付单状态。

http请求方式：POST
https://api.weixin.qq.com/shop/order/get?access_token=xxxxxxxxx

# 请求参数

{
    "order_id": 3302968738502279424,
    "out_order_id": "***************",
    "openid": "oTVP50O53a7jgmawAmxKukNlq3XI"
}

# 回包示例

{
    "errcode": 0,
    "errmsg": "ok",
    "order": {
        "order_id": 3302968738502279424,
        "out_order_id": "***************",
        "status": 20,
        "path": "/pages/order.html?out_order_id=xxxxx",
        "default_receiving_address": {
            "city": "广州市",
            "country": "中国",
            "detailed_address": "龙洞250号",
            "province": "广东省",
            "receiver_name": "我爱我家",
            "tel_number": "18712345678",
            "town": "温柔乡"
        },
        "order_detail": {
            "promotion_info": {
                "promoter_id": "PROMOTER_ID",
                "finder_nickname": "FINDER_NICKNAME",
                "sharer_openid": "SHARER_OPENID"
            },
            "product_infos": [
                {
                    "out_product_id": "12345",
                    "out_sku_id": "23456",
                    "product_cnt": 10,
                    "sale_price": 200,
                    "path": "pages/productDetail/productDetail?productId=2176180",
                    "title": "标题",
                    "head_img": "http://img10.360buyimg.com/n1/s450x450_jfs/t1/85865/39/13611/488083/5e590a40E4bdf69c0/55c9bf645ea2b727.jpg",
                    "real_price": 200
                }
            ],
            "pay_info": {
                "pay_method": "微信支付",
                "prepay_id": "42526234625",
                "prepay_time": "2020-03-25 14:04:25",
                "transaction_id": "131456479687",
                "pay_time": "2020-03-25 14:05:25",
                "pay_method_type": 0
            },
            "price_info": {
                "order_price": 1600,
                "freight": 500,
                "discounted_price": 1000,
                "additional_price": 100,
                "additional_remarks": "税费"
            },
            "delivery_detail": {
                "delivery_type": 1,
                "finish_all_delivery": 1,
                "delivery_list": [
                    {
                        "waybill_id": "SFXXXX",
                        "delivery_id": "SF",
                    }
                ]
            }
        }
    }
}

# 请求参数说明

参数	类型	是否必需	说明
order_id	number(uint64)	否	微信侧订单id （订单id二选一）
out_order_id	string	否	商家自定义订单ID （订单id二选一）
openid	string	是	用户的openid

# 回包参数说明

字段名	类型	说明
errcode	number	错误码
errmsg	string	错误信息
data	Order	订单信息

# Order

字段名	类型	说明
create_time	string	创建时间，yyyy-MM-dd HH:mm:ss，与微信服务器不得超过5秒
out_order_id	string	商家自定义订单ID(字符集包括大小写字幕数字，长度小于128个字符）
openid	string	用户的openid
scene	number	下单小程序场景值
order_detail	OrderDetail	订单详细数据
delivery_detail	DeliveryDetail	配送信息
status	number	商品状态
path	string	订单详情页路径
address_info	AddressInfo	地址信息
settlement_info	SettlementInfo	订单资金结算信息
refund_info	RefundInfo	订单退款信息
related_aftersale_info	RelatedAfterSaleInfo	售后单信息
fund_type	number	订单类型：0，普通单，1，二级商户单
expire_time	number	秒级时间戳，订单超时时间，获取支付参数将使用此时间作为prepay_id 过期时间;时间到期之后，微信会流转订单超时取消（status = 181）
aftersale_duration	number	确认收货之后多久禁止发起售后，单位：天，需>=5天，default=5天
promotion_info	PromotionInfo	推广员、分享员信息
default_receiving_address	AddressInfo	默认退货地址
commission_info	CommissionInfo	分账信息
receive_time	number	确认收货时间，秒级时间戳，fund_type = 1且确认收货之后存在

# OrderDetail

字段名	类型	说明
product_infos	OrderProductInfo[]	商品列表
price_info	PriceInfo	价格信息
pay_info	PayInfo	支付信息

# DeliveryDetail

字段名	类型	说明
delivery_type	enum	1: 正常快递, 2: 无需快递, 3: 线下配送, 4: 用户自提，视频号场景目前只支持 1，正常快递
finish_all_delivery	number	是否发货完成
delivery_list	DeliveryInfo[]	物流信息
delivery_list[].delivery_id	string	快递公司ID，通过获取快递公司列表获取
delivery_list[].waybill_id	string	快递单号
delivery_list[].product_info_list	DeliveryProduct[]	商品信息
delivery_list[].product_info_list[].out_product_id	string	商家侧spu id
delivery_list[].product_info_list[].out_sku_id	string	商家侧sku id

# RelatedAftersaleInfo

字段名	类型	说明
aftersale_list	RelatedAfterSale[]	售后单信息
aftersale_list[].aftersale_id	number	微信侧售后单id
aftersale_list[].out_aftersale_id	string	商家侧售后单id

# PayInfo

字段名	类型	说明
pay_method_type	number	0: 微信支付(目前只有微信支付)
prepay_id	string	预支付ID
prepay_time	string	预付款时间（拿到prepay_id的时间）
transaction_id	string	微信支付流水单号
pay_time	string	付款时间，yyyy-MM-dd HH:mm:ss
promotion_detail_info	PromotionDetailInfo	微信支付券信息

# PromotionDetailInfo

字段名	类型	说明
promotion_detail_list	PromotionDetail[]	是

# PromotionDetail

字段名	类型	说明
coupon_id	string	券ID
name	string	优惠名称
scope	string	优惠范围 GLOBAL：全场代金券 SINGLE：单品优惠
type	string	优惠类型: CASH：充值型代金券 NOCASH：免充值型代金券
amount	number	优惠券面额
stock_id	string	活动ID
wechatpay_contribute	number	微信出资
merchant_contribute	number	商户出资
other_contribute	numver	其他出资
goods_detail	GoodsDetail[]	单品列表信息

# GoodsDetail

字段名	类型	说明
goods_id	string	商品编码
quantity	number	商品数量
unit_price	number	商品单价
discount_amount	number	商品优惠金额
goods_reamark	string	商品备注

# OrderProductInfo

字段名	类型	说明
product_id	number	商品spuid
out_product_id	string	外部商品spuid
sku_id	number	商品skuid
out_sku_id	string	外部商品skuid
product_cnt	number	商品个数
sale_price	number	生成订单时商品的售卖价（单位：分），可以跟上传商品接口的价格不一致
sku_real_price	number	sku总实付价
title	string	生成订单时商品的标题
head_img	string	生成订单时商品的头图
path	string	绑定的小程序商品路径

# AddressInfo

字段名	类型	说明
receiver_name	string	收件人姓名
detailed_address	string	详细收货地址信息
tel_number	string	收件人手机号码
country	string	国家
province	string	省份
city	string	城市
town	string	乡镇

# PriceInfo

字段名	类型	说明
freight	number	运费
discounted_price	number	折扣费用
additional_price	number	其他费用
additional_remarks	string	其他费用说明
order_price	number	订单总价

# PromotionInfo

字段名	类型	说明
promoter_id	string	推广员唯一ID
promoter_openid	string	推广员openid(废弃，请勿使用)
finder_nickname	string	推广员视频号昵称
sharer_openid	string	分享员openid

# SettlementInfo

字段名	类型	说明
settlement_list	SettlementRecord[]	结算列表
handing_fee	number	结算最终收取的支付手续费
settle_status	number	商家结算状态，枚举值见settle_status
settle_time	string	商家结算时间
settle_abnormal_reason	string	结算异常原因

# SettlementRecord

字段名	类型	说明
type	number	分账方类型，枚举值见settlement_type
amount	number	金额，单位为分
settle_no	string	视频号系统分账单号
settle_id	string	微信支付系统分账单号
create_time	string	分账创建时间
finish_time	string	分账完成时间
result	string	分账结果，枚举值见settlement_result
fail_reason	string	分账失败原因
is_finished	number	是否完成分账，0:未完成，1:已完成

# RefundInfo

字段名	类型	说明
refund_list	RefundRecord[]	退款列表

# RefundRecord

字段名	类型	说明
type	number	退款类型，1:售后退款
amount	number	金额，单位为分
refund_no	string	视频号系统退款单号
refund_id	string	微信支付系统退款单号
create_time	string	分账创建时间
finish_time	string	分账完成时间
result	string	退款结果，枚举值见result_result
fail_reason	string	分账失败原因

# CommissionInfo

字段名	类型	说明
commission_list	CommissionRecord[]	分账列表

# CommissionRecord

字段名	类型	说明
mchid	string	商户号
account_type	number	账户类型，0:商户
out_product_id	string	外部商品spuid
out_sku_id	string	外部商品skuid
amount	number	分账金额，单位为分
commission_type	number	分账类型，1:服务商，目前仅支持1

# status enum

枚举值	描述
10	待付款
11	收银台支付完成（自动流转，对商家来说和10同等对待即可）
20	待发货(即支付完成)
21	部分发货
30	待收货
100	完成
181	超时未支付取消
200	全部商品售后之后取消
250	用户取消

# settle_status enum

枚举值	描述
1	待结算
2	已结算
3	已关闭
4	交易异常

# settlement_type enum

枚举值	描述
0	商家
1	服务商

# settlement_result enum

枚举值	描述
PENDING	待分账
SUCCESS	分账成功
CLOSED	已关闭

# refund_result enum

枚举值	描述
SUCCESS	退款成功
CLOSE	退款关闭
PROCESSING	退款处理中
ABNORMAL	退款异常