请求参数说明

外部商户创建订单并支付


公共参数


请求地址


环境

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

quit_url

String

400

添加该参数后在h5支付收银台会出现返回按钮,可用于用户付款中途退出并返回到该参数指定的商户网站地址。注:该参数对支付宝钱包标准收银台下的跳转不生效。

http://www.taobao.com/product/113714.html 

ext_user_info

ExtUserInfo


外部指定买家,详见下表的“外部用户ExtUserInfo参数说明”。




业务扩展参数说明

参数

类型

是否必填

最大长度

描述

示例值

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

网银



外部用户ExtUserInfo参数说明


参数

类型

是否必填

最大长度

示例值

描述

name

String

16

李明

姓名


注: need_check_info=T时该参数才有效

mobile

String

20

16587658765

手机号


注:该参数暂不校验

cert_type

String

32

IDENTITY_CARD

身份证:IDENTITY_CARD、护照:PASSPORT、军官证:OFFICER_CARD、士兵证:SOLDIER_CARD、户口本:HOKOU等。如有其它类型需要支持,请与蚂蚁金服工作人员联系。


注: need_check_info=T时该参数才有效

cert_no

String

64

362334768769238881

证件号


注:need_check_info=T时该参数才有效

min_age

String

3

18

允许的最小买家年龄,买家年龄必须大于等于所传数值


注:

1. need_check_info=T时该参数才有效

2. min_age为整数,必须大于等于0

fix_buyer

String

8

F

是否强制校验付款人身份信息


T:强制校验,F:不强制

need_check_info

String

1

F

是否强制校验身份信息


T:强制校验,F:不强制


前台回跳参数

公共参数:

参数

类型

是否必填

最大长度

描述

示例值

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


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

.NET


 1IAopClient client = new DefaultAopClient("https://openapi.alipay.com/gateway.do", "app_id", "merchant_private_key", "json", "1.0", "RSA2", "alipay_public_key", "GBK", false);
 2AlipayTradeWapPayRequest  request= new AlipayTradeWapPayRequest() ;
 3request.BizContent="{" +
 4"    \"body\":\"body\"," +
 5"    \"subject\":\"\"," +
 6"    \"out_trade_no\":\"70501111111S001111119\"," +
 7"    \"timeout_express\":\"90m\"," +
 8"    \"total_amount\":9.00," +
 9"    \"product_code\":\"QUICK_WAP_WAY\"" +
10"  }";
11AlipayTradeWapPayResponse response=client.pageExecute(request);
12string  form  =  response.Body;
13Response.Write(form);

PHP


 1$aop = new AopClient ();
 2$aop->gatewayUrl = 'https://openapi.alipay.com/gateway.do';
 3$aop->appId = 'your app_id';
 4$aop->rsaPrivateKey = '请填写开发者私钥去头去尾去回车,一行字符串';
 5$aop->alipayrsaPublicKey='请填写支付宝公钥,一行字符串';
 6$aop->apiVersion = '1.0';
 7$aop->postCharset='GBK';
 8$aop->format='json';
 9$aop->signType='RSA2';
10$request = new AlipayTradeWapPayRequest ();
11$request->setBizContent("{" .
12"    \"body\":\"对一笔交易的具体描述信息。如果是多种商品,请将商品描述字符串累加传给body。\"," .
13"    \"subject\":\"大乐透\"," .
14"    \"out_trade_no\":\"70501111111S001111119\"," .
15"    \"timeout_express\":\"90m\"," .
16"    \"total_amount\":9.00," .
17"    \"product_code\":\"QUICK_WAP_WAY\"" .
18"  }");
19$result = $aop->pageExecute ( $request); 
20echo $result;

HTTP请求源码


1https://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=
2  {
3    "body":"对一笔交易的具体描述信息。如果是多种商品,请将商品描述字符串累加传给body。",
4    "subject":"大乐透",
5    "out_trade_no":"70501111111S001111119",
6    "timeout_express":"90m",
7    "total_amount":9.00,
8    "product_code":"QUICK_WAP_WAY"
9  }

前台回跳示例


1https://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


onlineServer