文档中心 > API类目 > 服务市场API

alipay.open.servicemarket.order.query (订购插件订单明细查询)

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

公共参数

请求地址:
环境 HTTPS请求地址
正式环境 https://openapi.alipay.com/gateway.do
公共请求参数:
参数 类型 是否必填 最大长度 描述 示例值
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 256 商户请求参数的签名串,详见签名 详见示例
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 String 必须 32 商户订单ID号 20160010200000000033400
start_page String 必须 7 从第几页开始查询 1

公共响应参数

参数 类型 是否必填 最大长度 描述 示例值
code String - 网关返回码,详见文档 40004
msg String - 网关返回码描述,详见文档 Business Failed
sub_code String - 业务返回码,详见文档 ACQ.TRADE_HAS_SUCCESS
sub_msg String - 业务返回码描述,详见文档 交易已被支付
sign String - 签名,详见文档 DZXh8eeTuAHoYE3w1J+POiPhfDxOYBfUNn1lkeT/V7P4zJdyojWEa6IZs6Hz0yDW5Cp/viufUb5I0/V5WENS3OYR8zRedqo6D+fUTdLHdc+EFyCkiQhBxIzgngPdPdfp1PIS7BdhhzrsZHbRqb7o4k3Dxc+AAnFauu4V6Zdwczo=

响应参数

参数 类型 是否必填 最大长度 描述 示例值
order_items OrderItem [] 选填 - 订单明细列表
  • └ creator
  • String
  • 选填
  • 32
  • 门店创建人(已删除)
  • 张三
  • └ phone_no
  • String
  • 选填
  • 19
  • 订单所属人联系方式(手机或者座机)
  • 13988888888
  • └ online_time
  • String
  • 选填
  • 32
  • 上架时间
  • 2016-01-01 00:01:01
  • └ expire_date
  • String
  • 选填
  • 32
  • 过期时间
  • 2016-01-01 00:00:01
  • └ order_status
  • String
  • 必填
  • 10
  • TO_DO-未实施,DOING-实施中,TO_CONFIRM-待商户确认,DONE-已完成,MERCHANT_REJECTED-商户已回绝,MERCHANT_CANCELLED-商户已取消,ISV_REJECTED-服务商已回绝,ISV_CANCELLED-服务商已取消
  • DONE
  • └ shop_status
  • String
  • 选填
  • 10
  • 店铺状态(ONLINE--已上架 OFFLINE--未上架 AVAILABLE--已开通 INIT--未开通 EXPIRED--已过期)
  • ONLINE
  • └ status
  • String
  • 必填
  • 25
  • 待服务商接单
  • MERCHANT_ORDED---待服务商接单
  • └ commodity_id
  • String
  • 必填
  • 32
  • 订购的服务商品ID
  • 201604290086730119
  • └ merchant_pid
  • String
  • 必填
  • 16
  • 商户PID
  • 2088101118588888
  • └ merchant_name
  • String
  • 必填
  • 64
  • 商户名称
  • XX网络有限公司
  • └ brand_name
  • String
  • 选填
  • 256
  • 品牌名称
  • 肯德基
  • └ contacts
  • String
  • 必填
  • 64
  • 订单联系人
  • 张三
  • └ shop_name
  • String
  • 必填
  • 1024
  • 店铺名称
  • 小张火锅店
  • └ city_code
  • String
  • 选填
  • 128
  • 城市编码
  • 110100
  • └ shop_id
  • String
  • 必填
  • 64
  • 店铺ID
  • 2015052000077000000000182140
  • └ category
  • String
  • 选填
  • 128
  • 店铺品类
  • 咖啡
  • └ province
  • String
  • 选填
  • 20
  • 店铺所在的省份
  • 浙江省
  • └ city
  • String
  • 选填
  • 128
  • 店铺所在的市
  • 杭州市
  • └ address
  • String
  • 选填
  • 128
  • 店铺所在具体位置
  • 西湖区XX街XX号
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

请求示例

  • JAVA
  • .NET
  • PHP
  • HTTP请求源码
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("调用失败");
}

响应示例

  • JSON示例
{
	"alipay_open_servicemarket_order_query_response":{
		"msg":"Success",
		"code":"10000",
		"commodity_id":"201604290086730119",
		"total_size":1000,
		"specifications":"标准版、试用版",
		"current_page":1,
		"order_items":[
			{
				"phone_no":"13988888888",
				"creator":"张三",
				"address":"西湖区XX街XX号",
				"shop_status":"ONLINE",
				"city":"杭州市",
				"merchant_name":"XX网络有限公司",
				"city_code":"110100",
				"brand_name":"肯德基",
				"shop_name":"小张火锅店",
				"merchant_pid":"2088101118588888",
				"order_status":"DONE",
				"shop_id":"2015052000077000000000182140",
				"online_time":"2016-01-01 00:01:01",
				"expire_date":"2016-01-01  00:00:01",
				"commodity_id":"201604290086730119",
				"province":"浙江省",
				"category":"咖啡",
				"contacts":"张三",
				"status":"MERCHANT_ORDED---待服务商接单"
			}
		],
		"status":"MERCHANT_ORDED"
	},
	"sign":"ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}

异常示例

  • JSON示例
{
	"alipay_open_servicemarket_order_query_response":{
		"msg":"Service Currently Unavailable",
		"code":"20000",
		"sub_msg":"系统繁忙",
		"sub_code":"isp.unknow-error"
	},
	"sign":"ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}

业务错误码

错误码 错误描述 解决方案
QUERY_FAILD 查询失败 重试
NOPERMISSION_QUERY 订单明细无权限查询 该订单号不属于当前查询者,更换订单号查询

公共错误码

返回
顶部