淘宝开放平台

请求地址：

环境	HTTPS请求地址
正式环境	https://openapi.alipay.com/gateway.do

公共请求参数：

参数	类型	是否必填	最大长度	描述	示例值
app_id	String	是	32	支付宝分配给开发者的应用ID	2014072300007148
method	String	是	128	接口名称	koubei.trade.order.consult
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	是	-	请求参数的集合，最大长度不限，除公共参数外所有请求参数都必须放在这个参数中传递，具体参照各产品快速接入文档

参数	类型	是否必填	最大长度	描述	示例值
request_id	String	必须	64	唯一请求id，开放者请确保每次请求的唯一性	0ad1e47b1500473065347103327127
user_id	String	必须	16	支付宝用户Id	2088212151390950
total_amount	Price	必须	9	订单总金额，单位元，精确到小数点后两位，取值范围[0.01,999999999] 如果同时传入了【不可打折金额】，【订单总金额】两者，则必须满足【不可打折金额】<=【订单总金额】	88.88
undiscountable_amount	Price	可选	9	不可打折金额，单位为元，精确到小数点后两位，取值范围[0,999999999] 如果同时传入了【不可打折金额】、【订单总金额】，则必须满足【不可打折金额】<=【订单总金额】	10.00
shop_id	String	必须	28	支付宝门店编号	2015051100077000000000000300
goods_info	GoodsInfo []	可选	-	商品明细列表。注意：单品总金额不能大于订单金额
└ goods_id String 必填 32 商户自定义商品外部编号 apple-01 └ goods_name String 必填 256 商户自定义商品名称苹果手机 └ goods_category String 可选 24 商品类目 201701000 └ quantity String 必填 9 商品数量,支持小数，但是小数位不能超过两位 2 └ price Price 必填 9 商品单价，单位元,精确到小数点后两位，取值范围[0.01,100000000] 10.00
apdid_token	String	必须	1024	用户设备信息,通过钱包容器提供的JSAPI接口获取，一、接口使用方法： AlipayJSBridge.call('getO2ODeviceToken', { appName: 'kb_isv_110229', appKey:'98y6VvdaDLpoqWZw' }, function (result) { } ); }); 二、result数据结构： 1、调用失败： {"error":xxx,"errorMessage":"xxx"} 2、调用成功： {'appToken':'xxxssajkjkjkxdkwqkqwb'}	FItOt3WEvOe0Re4NLgrUINWSP8B2AVOdSp1YTotRG7LAJos1tPJMbes4/GTrJew5/ITdibdWlv8XsEnfwuCyntY6eAO0M84ivvie4JyH19vYUnk58HYVs3XnjzgSY0Uw

参数	类型	是否必填	最大长度	描述	示例值
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=

参数	类型	是否必填	最大长度	描述	示例值
buyer_pay_amount	Price	必填	9	用户实付金额	10.00
request_id	String	选填	64	请求中的request_id	874JKK4H5J43H3K35J4543K5J3K45J34KJ
m_card_detail	MCardDetail	选填	-	储值卡信息
└ name String 必填 256 储值卡名称商家储值卡 └ available_amount Price 必填 9 储值卡可用余额 100000.00 └ pay_amount Price 必填 9 储值卡支付金额 1000.00
discount_detail	DiscountDetail []	选填	-	优惠信息
└ id String 必填 64 优惠ID或活动ID 2017CVCJD788E889EC └ discount_desc String [] 选填 256 优惠描述，比如至多优惠XX元，满XX减XX 最高优惠10元；储值卡专属 └ discount_type String 必填 32 优惠类型,商家优惠（M_DISCOUNT），平台优惠（RT_DISCOUNT） RT_DISCOUNT └ is_hit String 必填 8 优惠是否命中, true代表命中了优惠；false代表未命中优惠 true └ is_purchased String 必填 8 是否是购买券, true代表是购买的券，false调表不是购买的券 true └ name String 必填 256 优惠名称 5折优惠 └ discount_amount Price 选填 9 优惠金额 100.00

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");
KoubeiTradeOrderConsultRequest request = new KoubeiTradeOrderConsultRequest();
request.setBizContent("{" +
"\"request_id\":\"0ad1e47b1500473065347103327127\"," +
"\"user_id\":\"2088212151390950\"," +
"\"total_amount\":88.88," +
"\"undiscountable_amount\":10.00," +
"\"shop_id\":\"2015051100077000000000000300\"," +
"\"goods_info\":[{" +
"\"goods_id\":\"apple-01\"," +
"\"goods_name\":\"苹果手机\"," +
"\"goods_category\":\"201701000\"," +
"\"quantity\":\"2\"," +
"\"price\":10.00" +
"}]," +
"\"apdid_token\":\"FItOt3WEvOe0Re4NLgrUINWSP8B2AVOdSp1YTotRG7LAJos1tPJMbes4/GTrJew5/ITdibdWlv8XsEnfwuCyntY6eAO0M84ivvie4JyH19vYUnk58HYVs3XnjzgSY0Uw\"" +
"}");
KoubeiTradeOrderConsultResponse response = alipayClient.execute(request);
if(response.isSuccess()){
System.out.println("调用成功");
} else {
System.out.println("调用失败");
}

IAopClient client = new DefaultAopClient("https://openapi.alipay.com/gateway.do", "app_id", "merchant_private_key", "json", "1.0", "RSA2", "alipay_public_key", "GBK", false);
KoubeiTradeOrderConsultRequest  request= new KoubeiTradeOrderConsultRequest() ;
request.BizContent="{" +
"\"request_id\":\"0ad1e47b1500473065347103327127\"," +
"\"user_id\":\"2088212151390950\"," +
"\"total_amount\":88.88," +
"\"undiscountable_amount\":10.00," +
"\"shop_id\":\"2015051100077000000000000300\"," +
"\"goods_info\":[{" +
"\"goods_id\":\"apple-01\"," +
"\"goods_name\":\"苹果手机\"," +
"\"goods_category\":\"201701000\"," +
"\"quantity\":\"2\"," +
"\"price\":10.00" +
"}]," +
"\"apdid_token\":\"FItOt3WEvOe0Re4NLgrUINWSP8B2AVOdSp1YTotRG7LAJos1tPJMbes4/GTrJew5/ITdibdWlv8XsEnfwuCyntY6eAO0M84ivvie4JyH19vYUnk58HYVs3XnjzgSY0Uw\"" +
"}";
KoubeiTradeOrderConsultResponse response=client.execute(request);
Console.WriteLine(response.Body);

$aop = new AopClient ();
$aop->gatewayUrl = 'https://openapi.alipay.com/gateway.do';
$aop->appId = 'your app_id';
$aop->rsaPrivateKey = '请填写开发者私钥去头去尾去回车，一行字符串';
$aop->alipayrsaPublicKey='请填写支付宝公钥，一行字符串';
$aop->apiVersion = '1.0';
$aop->signType = 'RSA2';
$aop->postCharset='GBK';
$aop->format='json';
$request = new KoubeiTradeOrderConsultRequest ();
$request->setBizContent("{" .
"\"request_id\":\"0ad1e47b1500473065347103327127\"," .
"\"user_id\":\"2088212151390950\"," .
"\"total_amount\":88.88," .
"\"undiscountable_amount\":10.00," .
"\"shop_id\":\"2015051100077000000000000300\"," .
"\"goods_info\":[{" .
"\"goods_id\":\"apple-01\"," .
"\"goods_name\":\"苹果手机\"," .
"\"goods_category\":\"201701000\"," .
"\"quantity\":\"2\"," .
"\"price\":10.00" .
"}]," .
"\"apdid_token\":\"FItOt3WEvOe0Re4NLgrUINWSP8B2AVOdSp1YTotRG7LAJos1tPJMbes4/GTrJew5/ITdibdWlv8XsEnfwuCyntY6eAO0M84ivvie4JyH19vYUnk58HYVs3XnjzgSY0Uw\"" .
"}");
$result = $aop->execute ( $request); 

$responseNode = str_replace(".", "_", $request->getApiMethodName()) . "_response";
$resultCode = $result->$responseNode->code;
if(!empty($resultCode)&&$resultCode == 10000){
echo "成功";
} else {
echo "失败";
}

https://openapi.alipay.com/gateway.do?timestamp=2013-01-01 08:08:08&method=koubei.trade.order.consult&app_id=4862&sign_type=RSA2&sign=ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE&version=1.0&biz_content=
  {
"request_id":"0ad1e47b1500473065347103327127",
"user_id":"2088212151390950",
"total_amount":88.88,
"undiscountable_amount":10.00,
"shop_id":"2015051100077000000000000300",
      "goods_info":[{
        "goods_id":"apple-01",
"goods_name":"苹果手机",
"goods_category":"201701000",
"quantity":"2",
"price":10.00
        }],
"apdid_token":"FItOt3WEvOe0Re4NLgrUINWSP8B2AVOdSp1YTotRG7LAJos1tPJMbes4/GTrJew5/ITdibdWlv8XsEnfwuCyntY6eAO0M84ivvie4JyH19vYUnk58HYVs3XnjzgSY0Uw"
  }

//为确保安全通信，需自行验证响应示例中的sign值是否为蚂蚁金服所提供。

JSON示例

{
	"koubei_trade_order_consult_response":{
		"msg":"Success",
		"code":"10000",
		"m_card_detail":{
			"pay_amount":1000.00,
			"name":"商家储值卡",
			"available_amount":100000.00
		},
		"buyer_pay_amount":10.00,
		"request_id":"874JKK4H5J43H3K35J4543K5J3K45J34KJ",
		"discount_detail":[
			{
				"is_hit":"true",
				"discount_desc":[
					"最高优惠10元；储值卡专属"
				],
				"discount_amount":100.00,
				"name":"5折优惠",
				"id":"2017CVCJD788E889EC",
				"discount_type":"RT_DISCOUNT",
				"is_purchased":"true"
			}
		]
	},
	"sign":"ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}

JSON示例

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

错误码	错误描述	解决方案
SYSTEM_ERROR	系统繁忙	系统繁忙，请稍后重试
INVALID_PARAMETER	参数有误	入参有误，请参考文档检查入参是否传错
SHOP_NOT_EXIST	店铺不存在	请检查传入的shop_id是否正确
ILLEGAL_SHOP_STATUS	店铺状态非法	店铺必须是OPEN状态，请检查店铺状态。
USER_NOT_EXIST	用户不存在	请检查传入的user_id是否正确
HAS_NO_PRIVILEGE	没有订单预咨询权限	传入的门店必须是商户授权的门店或ISV自己的门店，请检查传入门店是否真正确
ACCESS_IS_FORBIDDEN	服务禁止访问	业务灰度情况下，门店不在灰度名单，将返回此错误码

公共错误码

营销API

koubei.trade.order.consult (口碑订单预咨询)

公共参数

请求参数

公共响应参数

响应参数

请求示例

响应示例

异常示例

业务错误码

公共错误码