订购插件订单明细查询

开发环境

http://dev-cn.your-api-server.com

GET

/v3/alipay/open/servicemarket/order/query

alipay.open.servicemarket.order

第三方服务商提供服务产品被商户订购后，服务市场会推送订单信息给服务商，服务商根据订单号回查该订单明细信息。

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'http://dev-cn.your-api-server.com/v3/alipay/open/servicemarket/order/query'

响应示例

200 - 示例 1

{
  "auto_upgrade": true,
  "commodity_id": "201604290086730119",
  "current_page": 1,
  "order_items": [
    {
      "address": "西湖区XX街XX号",
      "brand_name": "肯德基",
      "category": "咖啡",
      "city": "杭州市",
      "city_code": "110100",
      "commodity_id": "201604290086730119",
      "contacts": "张三",
      "creator": "张三",
      "merchant_name": "XX网络有限公司",
      "merchant_pid": "2088101118588888",
      "mini_app_id": "2017121800945174",
      "mini_app_name": "小张火锅店小程序",
      "open_id_model": "UID模式",
      "order_status": "DONE",
      "phone_no": "13988888888",
      "province": "浙江省",
      "shop_id": "2015052000077000000000182140",
      "shop_name": "小张火锅店",
      "shop_status": "ONLINE",
      "status": "MERCHANT_ORDED---待服务商接单",
      "expire_date": {},
      "online_time": {},
      "service_effect_date": {},
      "service_expire_date": {}
    }
  ],
  "specifications": "标准版、试用版",
  "status": "MERCHANT_ORDED",
  "total_size": 1000
}

请求参数

Query 参数

commodity_order_id

string

可选

订购服务订单ID，通过支付宝发送的 https://opendocs.alipay.com/apis/api_3/alipay.open.servicemarket.order.notify(服务市场商户确认订购通知) 通知获取。

start_page

string

可选

查询开始页码，1 为第一页。

返回响应

🟢200common response

application/json

Body

auto_upgrade

boolean

可选

true：开启；false：关闭；需要同步校验commodity_id，如果没有查询到订购信息的话，忽略该字段返回值

示例值:

true

commodity_id

string

订购服务商品ID

可选

示例值:

201604290086730119

current_page

integer

可选

当前查询页（本接口支持最多查询100条记录）

示例值:

1

order_items

array[object (OrderItem) {24}]

订单明细列表

可选

address

string

店铺所在具体位置

可选

示例值:

西湖区XX街XX号

brand_name

string

品牌名称

可选

示例值:

肯德基

category

string

店铺品类

可选

示例值:

咖啡

city

string

店铺所在的市

可选

示例值:

杭州市

city_code

string

城市编码

可选

示例值:

110100

commodity_id

string

订购的服务商品ID

可选

示例值:

201604290086730119

contacts

string

订单联系人

可选

示例值:

张三

creator

string

可选

门店创建人(已删除)

示例值:

张三

merchant_name

string

商户名称

可选

示例值:

XX网络有限公司

merchant_pid

string

商户PID

可选

示例值:

2088101118588888

mini_app_id

string

可选

小程序APPID，订购实体为小程序的场景该字段必填

示例值:

2017121800945174

mini_app_name

string

可选

小程序应用名称，订购实体为小程序的场景该字段必填

示例值:

小张火锅店小程序

open_id_model

string

应用用户标识模式

可选

示例值:

UID模式

order_status

string

可选

TO_DO-未实施,DOING-实施中,TO_CONFIRM-待商户确认,CONFIRMED-商户已确认,DONE-已完成,MERCHANT_REJECTED-商户已回绝,MERCHANT_CANCELLED-商户已取消,ISV_REJECTED-服务商已回绝,ISV_CANCELLED-服务商已取消

示例值:

DONE

phone_no

string

可选

订单所属人联系方式（手机或者座机）

示例值:

13988888888

province

string

店铺所在的省份

可选

示例值:

浙江省

shop_id

string

可选

店铺ID，订购实体为口碑门店的场景该字段必填

示例值:

2015052000077000000000182140

shop_name

string

可选

店铺名称，订购实体为口碑门店的场景该字段必填

示例值:

小张火锅店

shop_status

string

可选

店铺状态（ONLINE--已上架 OFFLINE--未上架 AVAILABLE--已开通 INIT--未开通 EXPIRED--已过期）

示例值:

ONLINE

status

string

待服务商接单

可选

示例值:

MERCHANT_ORDED---待服务商接单

expire_date

string

过期时间

可选

示例值:

{}

online_time

string

上架时间

可选

示例值:

{}

service_effect_date

string

可选

订购的服务有效期生效时间

示例值:

{}

service_expire_date

string

服务有效期截止时间

可选

示例值:

{}

specifications

string

可选

用于区分同一个服务的不同版本

示例值:

标准版、试用版

status

string

可选

MERCHANT_ORDED（待服务商接单）

示例值:

MERCHANT_ORDED

total_size

integer

总记录数

可选

示例值:

1000

🔴500请求失败

服务市场商户确认订购通知

服务商接单操作