淘宝开放平台 - 文档中心

请求地址：

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

公共请求参数：

参数	类型	是否必填	最大长度	描述	示例值
app_id	String	是	32	支付宝分配给开发者的应用ID	2014072300007148
method	String	是	128	接口名称	alipay.trade.wap.pay
format	String	否	40	仅支持JSON	JSON
return_url	String	否	256	HTTP/HTTPS开头字符串	https://m.alipay.com/Gk8NF23
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
notify_url	String	否	256	支付宝服务器主动通知商户服务器里指定的页面http/https路径。	https://api.xx.com/receive_notify.htm
biz_content	String	是	-	业务请求参数的集合，最大长度不限，除公共参数外所有请求参数都必须放在这个参数中传递，具体参照各产品快速接入文档

参数	类型	是否必填	最大长度	描述	示例值
body	String	否	128	对一笔交易的具体描述信息。如果是多种商品，请将商品描述字符串累加传给body。	Iphone6 16G
subject	String	是	256	商品的标题/交易标题/订单标题/订单关键字等。	大乐透
out_trade_no	String	是	64	商户网站唯一订单号	70501111111S001111119
timeout_express	String	否	6	该笔订单允许的最晚付款时间，逾期将关闭交易。取值范围：1m～15d。m-分钟，h-小时，d-天，1c-当天（1c-当天的情况下，无论交易何时创建，都在0点关闭）。该参数数值不接受小数点，如 1.5h，可转换为 90m。注：若为空，则默认为15d。	90m
time_expire	String	否	32	绝对超时时间，格式为yyyy-MM-dd HH:mm。注：1）以支付宝系统时间为准；2）如果和timeout_express参数同时传入，以time_expire为准。	2016-12-31 10:05
total_amount	Price	是	9	订单总金额，单位为元，精确到小数点后两位，取值范围[0.01,100000000]	9.00
auth_token	String	否	40	针对用户授权接口，获取用户相关数据时，用于标识用户授权关系注：若不属于支付宝业务经理提供签约服务的商户，暂不对外提供该功能，该参数使用无效。	appopenBb64d181d0146481ab6a762c00714cC27
product_code	String	是	64	销售产品码，商家和支付宝签约的产品码。该产品请填写固定值：QUICK_WAP_WAY	QUICK_WAP_WAY
goods_type	String	否	2	商品主类型：0—虚拟类商品，1—实物类商品注：虚拟类商品不支持使用花呗渠道	0
passback_params	String	否	512	公用回传参数，如果请求时传递了该参数，则返回给商户时会回传该参数。支付宝会在异步通知时将该参数原样返回。本参数必须进行UrlEncode之后才可以发送给支付宝	merchantBizType%3d3C%26merchantBizNo%3d2016010101111
promo_params	String	否	512	优惠参数注：仅与支付宝协商后可用	{"storeIdType":"1"}
extend_params	String	否		业务扩展参数，详见下面的“业务扩展参数说明”	{"sys_service_provider_id":"2088511833207846"}
enable_pay_channels	String	否	128	可用渠道，用户只能在指定渠道范围内支付当有多个渠道时用“,”分隔注：与disable_pay_channels互斥	pcredit,moneyFund,debitCardExpress
disable_pay_channels	String	否	128	禁用渠道，用户不可用指定渠道支付当有多个渠道时用“,”分隔注：与enable_pay_channels互斥	pcredit,moneyFund,debitCardExpress
store_id	String	否	32	商户门店编号。该参数用于请求参数中以区分各门店，非必传项。	NJ_001
quit_url	String	否	400	添加该参数后在h5支付收银台会出现返回按钮，可用于用户付款中途退出并返回到该参数指定的商户网站地址。注：该参数对支付宝钱包标准收银台下的跳转不生效。	http://www.taobao.com/product/113714.html

业务扩展参数说明

参数	类型	是否必填	最大长度	描述	示例值
sys_service_provider_id	String	否	64	系统商编号，该参数作为系统商返佣数据提取的依据，请填写系统商签约协议的PID。注：若不属于支付宝业务经理提供签约服务的商户，暂不对外提供该功能，该参数使用无效。	2088511833207846
needBuyerRealnamed	String	否	1	是否发起实名校验 T：发起 F：不发起	T
TRANS_MEMO	String	否	128	账务备注注：该字段显示在离线账单的账务备注中	促销
hb_fq_num	String	否	5	花呗分期数（目前仅支持3、6、12）注：使用该参数需要仔细阅读“花呗分期接入文档”	3
hb_fq_seller_percent	String	否	3	卖家承担收费比例，商家承担手续费传入100，用户承担手续费传入0，仅支持传入100、0两种，其他比例暂不支持注：使用该参数需要仔细阅读“花呗分期接入文档”	100

渠道说明

渠道名称	说明
balance	余额
moneyFund	余额宝
coupon	红包
pcredit	花呗
pcreditpayInstallment	花呗分期
creditCard	信用卡
creditCardExpress	信用卡快捷
creditCardCartoon	信用卡卡通
credit_group	信用支付类型（包含信用卡卡通、信用卡快捷、花呗、花呗分期）
debitCardExpress	借记卡快捷
mcard	商户预存卡
pcard	个人预存卡
promotion	优惠（包含实时优惠+商户优惠）
voucher	营销券
point	积分
mdiscount	商户优惠
bankPay	网银

公共参数：

参数	类型	是否必填	最大长度	描述	示例值
app_id	String	是	32	支付宝分配给开发者的应用ID	2016040501024706
method	String	是	128	接口名称	alipay.trade.wap.pay.return
sign_type	String	是	10	签名算法类型，目前支持RSA2和RSA，推荐使用RSA2	RSA2
sign	String	是	256	支付宝对本次支付结果的签名，开发者必须使用支付宝公钥验证签名	详见示例
charset	String	是	10	编码格式，如utf-8,gbk,gb2312等	utf-8
timestamp	String	是	19	前台回跳的时间，格式"yyyy-MM-dd HH:mm:ss"	2016-08-11 19:36:01
version	String	是	3	调用的接口版本，固定为：1.0	1.0

业务参数：

参数	类型	是否必填	最大长度	描述	示例值
out_trade_no	String	是	64	商户网站唯一订单号	70501111111S001111119
trade_no	String	是	64	该交易在支付宝系统中的交易流水号。最长64位。	2016081121001004630200142207
total_amount	Price	是	9	该笔订单的资金总额，单位为RMB-Yuan。取值范围为[0.01，100000000.00]，精确到小数点后两位。	9.00
seller_id	String	是	16	收款支付宝账号对应的支付宝唯一用户号。以2088开头的纯16位数字	2088111111116894

JAVA

public void doPost(HttpServletRequest httpRequest,
                      HttpServletResponse httpResponse) throws ServletException, IOException {
    AlipayClient alipayClient = ... //获得初始化的AlipayClient
    AlipayTradeWapPayRequest alipayRequest = new AlipayTradeWapPayRequest();//创建API对应的request
    alipayRequest.setReturnUrl("http://domain.com/CallBack/return_url.jsp");
    alipayRequest.setNotifyUrl("http://domain.com/CallBack/notify_url.jsp");//在公共参数中设置回跳和通知地址
    alipayRequest.setBizContent("{" +
		"    \"out_trade_no\":\"20150320010101002\"," +
		"    \"total_amount\":88.88," +
		"    \"subject\":\"Iphone6 16G\"," +
		"    \"product_code\":\"QUICK_WAP_WAY\"" +
		"  }");//填充业务参数
    String form = alipayClient.pageExecute(alipayRequest).getBody(); //调用SDK生成表单
    httpResponse.setContentType("text/html;charset=" + AlipayServiceEnvConstants.CHARSET);
    httpResponse.getWriter().write(form);//直接将完整的表单html输出到页面
    httpResponse.getWriter().flush();
}

.NET

IAopClient client = new DefaultAopClient("https://openapi.alipay.com/gateway.do", "app_id", "merchant_private_key", "json", "1.0", "RSA2", "alipay_public_key", "GBK", false);
AlipayTradeWapPayRequest  request= new AlipayTradeWapPayRequest() ;
request.BizContent="{" +
"    \"body\":\"对一笔交易的具体描述信息。如果是多种商品，请将商品描述字符串累加传给body。\"," +
"    \"subject\":\"大乐透\"," +
"    \"out_trade_no\":\"70501111111S001111119\"," +
"    \"timeout_express\":\"90m\"," +
"    \"total_amount\":9.00," +
"    \"product_code\":\"QUICK_WAP_WAY\"" +
"  }";
AlipayTradeWapPayResponse response=client.pageExecute(request);
string  form  =  response.Body;
Response.Write(form);

PHP

$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->postCharset='GBK';
$aop->format='json';
$aop->signType='RSA2';
$request = new AlipayTradeWapPayRequest ();
$request->setBizContent("{" .
"    \"body\":\"对一笔交易的具体描述信息。如果是多种商品，请将商品描述字符串累加传给body。\"," .
"    \"subject\":\"大乐透\"," .
"    \"out_trade_no\":\"70501111111S001111119\"," .
"    \"timeout_express\":\"90m\"," .
"    \"total_amount\":9.00," .
"    \"product_code\":\"QUICK_WAP_WAY\"" .
"  }");
$result = $aop->pageExecute ( $request); 
echo $result;

HTTP请求源码

https://openapi.alipay.com/gateway.do?timestamp=2013-01-01 08:08:08&method=alipay.trade.wap.pay&app_id=1990&sign_type=RSA2&sign=ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE&version=1.0&biz_content=
  {
    "body":"对一笔交易的具体描述信息。如果是多种商品，请将商品描述字符串累加传给body。",
    "subject":"大乐透",
    "out_trade_no":"70501111111S001111119",
    "timeout_express":"90m",
    "total_amount":9.00,
    "product_code":"QUICK_WAP_WAY"
  }

https://m.alipay.com/Gk8NF23?total_amount=9.00&timestamp=2016-08-11+19%3A36%3A01&sign=ErCRRVmW%2FvXu1XO76k%2BUr4gYKC5%2FWgZGSo%2FR7nbL%2FPU7yFXtQJ2CjYPcqumxcYYB5x%2FzaRJXWBLN3jJXr01Icph8AZGEmwNuzvfezRoWny6%2Fm0iVQf7hfgn66z2yRfXtRSqtSTQWhjMa5YXE7MBMKFruIclYVTlfWDN30Cw7k%2Fk%3D&trade_no=2016081121001004630200142207&sign_type=RSA2&charset=UTF-8&seller_id=2088111111116894&method=alipay.trade.wap.pay.return&app_id=2016040501024706&out_trade_no=70501111111S001111119&version=1.0

开放平台

开放平台

手机网站支付请求参数说明

公共参数

请求参数

前台回跳参数

请求示例

JAVA

.NET

PHP

HTTP请求源码

前台回跳示例

FAQ