请求参数是商户在与支付宝进行数据交互时,提供给支付宝的请求数据,以便支付宝根据这些数据进一步处理。
参数 |
参数名称 |
类型(字节长度) |
参数说明 |
是否可为空 |
样例 |
基本参数 |
|||||
service |
接口名称 |
String |
接口名称。 |
不可空 |
create_direct_pay_by_user |
partner |
合作者身份ID |
String(16) |
签约的支付宝账号对应的支付宝唯一用户号。 以2088开头的16位纯数字组成。 |
不可空 |
2088002396712354 |
_input_charset |
参数编码字符集 |
String |
商户网站使用的编码格式,如utf-8、gbk、gb2312等。 |
不可空 |
gbk |
sign_type |
签名方式 |
String |
DSA、RSA、MD5三个值可选,必须大写。 |
不可空 |
MD5 |
sign |
签名 |
String |
请参见签名。 |
不可空 |
be4an8ya8hbnbzmyi945f5c1ckbp6bbe |
notify_url |
服务器异步通知页面路径 |
String(190) |
支付宝服务器主动通知商户网站里指定的页面http路径。 |
可空 |
http://api.test.alipay.net/atinterface/receive_notify.htm |
return_url |
页面跳转同步通知页面路径 |
String(200) |
支付宝处理完请求后,当前页面自动跳转到商户网站里指定页面的http路径。 |
可空 |
http://api.test.alipay.net/atinterface/receive_return.htm |
业务参数 |
|||||
out_trade_no |
商户网站唯一订单号 |
String(64) |
支付宝合作商户网站唯一订单号(确保在商户系统中唯一)。 |
不可空 |
6741334835157966 |
subject |
商品名称 |
String(256) |
商品的标题/交易标题/订单标题/订单关键字等。 该参数最长为128个汉字。 |
不可空 |
贝尔金护腕式 |
payment_type |
支付类型 |
String(4) |
取值范围请参见收款类型。 默认值为:1(商品购买)。 注意: 支付类型为“47”时,公共业务扩展参数(extend_param)中必须包含凭证号(evoucheprod_evouche_id)参数名和参数值。 |
不可空 |
1 |
defaultbank |
默认网银 |
String |
银行简码,请参见银行简码——混合渠道和银行简码——纯借记卡渠道。 说明: 如果要使用纯网关功能,本参数需赋值为银行简码——混合渠道或银行简码——纯借记卡渠道中的值。 |
不可空 |
CMB |
seller_id |
卖家支付宝用户号 |
String(16) |
三个参数至少必须传递一个。 当签约账号就是收款账号时,请务必使用参数seller_id,即seller_id的值与partner的值相同。 三个参数的优先级别是:seller_id>seller_account_name>seller_email。 |
可空 |
2088002007018966 |
seller_email |
卖家支付宝账号 |
String(100) |
可空 |
alipay-test01@alipay.com |
|
seller_account_name |
卖家别名支付宝账号 |
String(100) |
可空 |
tstable02@alipay.com |
|
price |
商品单价 |
Number |
单位为:RMB Yuan。取值范围为[0.01,100000000.00],精确到小数点后两位。 规则:price、quantity能代替total_fee。即存在total_fee,就不能存在price和quantity;存在price、quantity,就不能存在total_fee。 |
可空 |
10.00 |
total_fee |
交易金额 |
Number |
该笔订单的资金总额,单位为RMB-Yuan。取值范围为[0.01,100000000.00],精确到小数点后两位。 |
可空 |
100 |
quantity |
购买数量 |
Number |
price、quantity能代替total_fee。即存在total_fee,就不能存在price和quantity;存在price、quantity,就不能存在total_fee。 |
可空 |
1 |
body |
商品描述 |
String(1000) |
对一笔交易的具体描述信息。如果是多种商品,请将商品描述字符串累加传给body。 |
可空 |
美国专业护腕鼠标垫,舒缓式凝胶软垫模拟手腕的自然曲线和运动,创造和缓的GelFlex舒适地带! |
show_url |
商品展示网址 |
String(400) |
收银台页面上,商品展示的超链接。 |
可空 |
http://www.360buy.com/product/113714.html |
paymethod |
默认支付方式 |
String |
若要使用纯网关,取值必须是bankPay(网银支付)。 如果不设置,默认为directPay(余额支付)。 说明: 必须注意区分大小写。 |
可空 |
bankPay |
need_ctu_check |
网银支付时是否做CTU校验 |
String |
商户在配置了支持CTU(支付宝风险稽查系统)校验权限的前提下,可以选择本次交易是否需要经过CTU校验。
|
可空 |
Y |
anti_phishing_key |
防钓鱼时间戳 |
String |
通过时间戳查询接口获取的加密支付宝系统时间戳。 如果已申请开通防钓鱼时间戳验证,则此字段必填。 |
可空 |
587FE3D2858E6B01E30104656E7805E2 |
exter_invoke_ip |
客户端IP |
String(15) |
用户在创建交易时,该用户当前所使用机器的IP。 如果商户申请后台开通防钓鱼选项,此字段必填,校验用。 |
可空 |
128.214.222.111 |
extra_common_param |
公用回传参数 |
String(100) |
如果用户请求时传递了该参数,则返回给商户时会回传该参数。 |
可空 |
你好,这是测试商户的广告。 |
extend_param |
公用业务扩展参数 |
String |
用于商户的特定业务信息的传递,只有商户与支付宝约定了传递此参数且约定了参数含义,此参数才有效。 参数格式:参数名1^参数值1|参数名2^参数值2|…… 多条数据用“|”间隔。 支付类型(payment_type)为47(电子卡券)时,需要包含凭证号(evoucheprod_evouche_id)参数名和参数值。 |
可空 |
pnr^MFGXDW|start_ticket_no^123|end_ticket_no^234|b2b_login_name^abc |
it_b_pay |
超时时间 |
String |
设置未付款交易的超时时间,一旦超时,该笔交易就会自动被关闭。 取值范围:1m~15d。 m-分钟,h-小时,d-天,1c-当天(1c-当天的情况下,无论交易何时创建,都在0点关闭)。 该参数数值不接受小数点,如1.5h,可转换为90m。 |
可空 |
1h |
product_type |
商户申请的产品类型 |
String(50) |
用于针对不同的产品,采取不同的计费策略。 如果开通了航旅垂直搜索平台产品,请填写CHANNEL_FAST_PAY;如果没有,则为空。 |
可空 |
CHANNEL_FAST_PAY |
注意:
https://mapi.alipay.com/gateway.do?_input_charset=gbk&defaultbank=CMB¬ify_url=http%3A%2F%2Fapi.test.alipay.net%2Fatinterface%2Freceive_notify.htm&out_trade_no=6741334835157966&partner=2088002396712354&payment_type=1&paymethod=bankPay&return_url=http%3A%2F%2Fapi.test.alipay.net%2Fatinterface%2Freceive_return.htm&seller_email=alipay-test01@alipay.com&service=create_direct_pay_by_user&subject=%B1%B4%B6%FB%BD%F0%BB%A4%CD%F3%CA%BD&total_fee=100&sign=cbbe89815204510545cb821416ddf95d&sign_type=MD5
说明:
本样例仅供参考,支付宝网关为https://mapi.alipay.com/gateway.do。