# 解码订单包含的敏感数据

# 接口说明

为保护敏感数据(如收货人昵称、电话号码、详细收货地址),平台对这些信息进行了部分隐藏。通过本接口操作订单后,可以获取到这些信息的完整数据。

# 注意事项

  • 本接口仅适用于已付款的订单;
  • 解码操作对订单数量有严格限制。请合理调用,避免不必要的重复请求。超出限制将导致接口报错。对同一订单的多次调用,系统仅计算一次;
  • 每个店铺每月可用的解码数为上月已发货订单量的10%,但不少于200次。

# 接口调用请求说明

POST https://api.weixin.qq.com/channels/ec/order/sensitiveinfo/decode?access_token=ACCESS_TOKEN

# 请求参数说明

参数 类型 是否必填 描述
order_id string 订单id

# 请求参数示例

{
    "order_id": "123456"
}

# 返回参数说明

参数 类型 描述
errcode number 错误码
errmsg string 错误信息
address_info Object AddressInfo 收货信息,具体枚结构请参考AddressInfo结构体

# 返回参数示例

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

# 错误码

错误码 错误描述
公共错误码 -
10020123 订单解码数达到当月限制
10020124 未完成支付的订单不支持API解码操作

# 结构体

# AddressInfo

收货信息

字段名 类型 描述
user_name string 收货人姓名
postal_code string 邮编
province_name string 省份
city_name string 城市
county_name string
detail_info string 详细地址
national_code string 国家码
tel_number string 联系方式
house_number string 门牌号码
virtual_order_tel_number string 虚拟发货订单联系方式,在发货方式为无需快递(deliver_method=1)时返回