服务市场订单明细查询接口 -凯发app官方网站

参数	类型	是否必选	最大长度	描述	示例值
app_id	string	必选	32	支付宝分配给开发者的应用id	2014072300007148
method	string	必选	128	接口名称	alipay.open.servicemarket.order.query
format	string	可选	40	仅支持json	json
charset	string	必选	10	请求使用的编码格式，如utf-8,gbk,gb2312等	utf-8
sign_type	string	必选	10	商户生成签名字符串所使用的签名算法类型，目前支持rsa2和rsa，推荐使用rsa2	rsa2
sign	string	必选	344	商户请求参数的签名串，详见签名	详见示例
timestamp	string	必选	19	发送请求的时间，格式"yyyy-mm-dd hh:mm:ss"	2014-07-24 03:07:50
version	string	必选	3	调用的接口版本，固定为：1.0	1.0
app_auth_token	string	可选	40	详见应用授权概述
biz_content	string	必选		请求参数的集合，最大长度不限，除公共参数外所有请求参数都必须放在这个参数中传递，具体参照各产品快速接入文档

业务请求参数

commodity_order_id｜服务市场订单id必选string(32)

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

【示例值】20160010200000000033400

start_page必选string(7)

【描述】查询开始页码，1 为第一页。

【示例值】1

参数	类型	是否必选	最大长度	描述	示例值
commodity_order_id	string	必选	32	订购服务订单id，通过支付宝发送的 https://opendocs.alipay.com/apis/api_3/alipay.open.servicemarket.order.notify(服务市场商户确认订购通知) 通知获取。	20160010200000000033400
start_page	string	必选	7	查询开始页码，1 为第一页。	1

常见请求示例

默认示例

javac#phphttp

alipayclient alipayclient = new defaultalipayclient("https://openapi.alipay.com/gateway.do","app_id","your private_key","json","gbk","alipay_public_key","rsa2");
alipayopenservicemarketorderqueryrequest request = new alipayopenservicemarketorderqueryrequest();
request.setbizcontent("{" 
"  \"commodity_order_id\":\"20160010200000000033400\"," 
"  \"start_page\":\"1\"" 
"}");
alipayopenservicemarketorderqueryresponse response = alipayclient.execute(request);
if(response.issuccess()){
system.out.println("调用成功");
} else {
system.out.println("调用失败");
}

说明：本示例仅供参考。

公共响应参数

参数	类型	是否必选	最大长度	描述	示例值
code	string	必选	-	网关返回码,	40004
msg	string	必选	-	网关返回码描述,	business failed
sub_code	string	可选	-	业务返回码，参见具体的api接口文档	acq.trade_has_success
sub_msg	string	可选	-	业务返回码描述，参见具体的api接口文档	交易已被支付
sign	string	必选	-	签名,	dzxh8eetuahoye3w1j poiphfdxoybfunn1lket/v7p4zjdyojwea6izs6hz0ydw5cp/viufub5i0/v5wens3oyr8zredqo6d futdlhdc efyckiqhbxizgngpdpdfp1pis7bdhhzrszhbrqb7o4k3dxc aanfauu4v6zdwczo=

业务响应参数

commodity_id必选string(32)

【描述】订购服务商品id

【示例值】201604290086730119

specifications必选string(128)

【描述】用于区分同一个服务的不同版本

【示例值】标准版、试用版

status必选string(25)

【描述】merchant_orded（待服务商接单）

【示例值】merchant_orded

order_items特殊可选orderitem[]

【描述】订单明细列表

order_status必选string(10)

【描述】to_do-未实施,doing-实施中,to_confirm-待商户确认,confirmed-商户已确认,done-已完成,merchant_rejected-商户已回绝,merchant_cancelled-商户已取消,isv_rejected-服务商已回绝,isv_cancelled-服务商已取消

【示例值】done

status必选string(25)

【描述】待服务商接单

【示例值】merchant_orded---待服务商接单

commodity_id必选string(32)

【描述】订购的服务商品id

【示例值】201604290086730119

merchant_pid必选string(16)

【描述】商户pid

【示例值】2088101118588888

merchant_name必选string(64)

【描述】商户名称

【示例值】xx网络有限公司

contacts必选string(64)

【描述】订单联系人

【示例值】张三

creator可选string(32)

【描述】门店创建人(已删除)

【示例值】张三

phone_no可选string(19)

【描述】订单所属人凯发k8官方网娱乐官方的联系方式（手机或者座机）

【示例值】13988888888

online_time可选string(32)

【描述】上架时间

【示例值】2016-01-01 00:01:01

expire_date可选string(32)

【描述】过期时间

【示例值】2016-01-01 00:00:01

shop_status可选string(10)

【描述】店铺状态（online--已上架 offline--未上架 available--已开通 init--未开通 expired--已过期）

【示例值】online

brand_name可选string(256)

【描述】品牌名称

【示例值】肯德基

city_code可选string(128)

【描述】城市编码

【示例值】110100

shop_name可选string(1024)

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

【示例值】小张火锅店

shop_id可选string(64)

【描述】店铺id，订购实体为口碑门店的场景该字段必填

【示例值】2015052000077000000000182140

mini_app_id可选string(64)

【描述】小程序appid，订购实体为小程序的场景该字段必填

【示例值】2017121800945174

mini_app_name可选string(1024)

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

【示例值】小张火锅店小程序

open_id_model可选string(10)

【描述】应用用户标识模式

【枚举值】

uid模式: uid

openid模式: open_id

【示例值】uid模式

category可选string(128)

【描述】店铺品类

【示例值】咖啡

province可选string(20)

【描述】店铺所在的省份

【示例值】浙江省

city可选string(128)

【描述】店铺所在的市

【示例值】杭州市

address可选string(128)

【描述】店铺所在具体位置

【示例值】西湖区xx街xx号

service_effect_date｜服务有效期生效时间可选string(30)

【描述】订购的服务有效期生效时间

【示例值】2023-04-03 12:01:45

service_expire_date｜服务有效期截止时间可选string(30)

【描述】服务有效期截止时间

【示例值】2023-04-03 12:01:45

total_size特殊可选number(7)

【描述】总记录数

【示例值】1000

current_page特殊可选number(4)

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

【示例值】1

auto_upgrade｜自动升级开关特殊可选boolean(10)

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

【示例值】true

参数	类型	是否必选	最大长度	描述	示例值
order_items	orderitem[]	特殊可选		订单明细列表
total_size	number	特殊可选	7	总记录数	1000
commodity_id	string	必选	32	订购服务商品id	201604290086730119
specifications	string	必选	128	用于区分同一个服务的不同版本	标准版、试用版
current_page	number	特殊可选	4	当前查询页（本接口支持最多查询100条记录）	1
status	string	必选	25	merchant_orded（待服务商接单）	merchant_orded
auto_upgrade	boolean	特殊可选	10	true：开启；false：关闭；需要同步校验commodity_id，如果没有查询到订购信息的话，忽略该字段返回值	true

响应示例

正常示例

异常示例

{
    "alipay_open_servicemarket_order_query_response": {
        "code": "10000",
        "msg": "success",
        "order_items": [
            {
                "creator": "张三",
                "phone_no": "13988888888",
                "online_time": "2016-01-01 00:01:01",
                "expire_date": "2016-01-01  00:00:01",
                "order_status": "done",
                "shop_status": "online",
                "status": "merchant_orded---待服务商接单",
                "commodity_id": "201604290086730119",
                "merchant_pid": "2088101118588888",
                "merchant_name": "xx网络有限公司",
                "brand_name": "肯德基",
                "contacts": "张三",
                "city_code": "110100",
                "shop_name": "小张火锅店",
                "shop_id": "2015052000077000000000182140",
                "mini_app_id": "2017121800945174",
                "mini_app_name": "小张火锅店小程序",
                "open_id_model": "uid模式",
                "category": "咖啡",
                "province": "浙江省",
                "city": "杭州市",
                "address": "西湖区xx街xx号",
                "service_effect_date": "2023-04-03 12:01:45",
                "service_expire_date": "2023-04-03 12:01:45"
            }
        ],
        "total_size": 1000,
        "commodity_id": "201604290086730119",
        "specifications": "标准版、试用版",
        "current_page": 1,
        "status": "merchant_orded",
        "auto_upgrade": true
    },
    "sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}

说明：本示例仅供参考。

公共错误码

业务错误码

错误码	错误描述	凯发app官方网站的解决方案
nopermission_query	订单明细无权限查询	该订单号不属于当前查询者，更换订单号查询
query_faild	查询失败	重试

公共请求参数

业务请求参数

公共响应参数

业务响应参数

公共错误码

业务错误码

相关问题