文档中心 > 网银支付(已下线)

请求参数说明

更新时间:2015/12/17 访问次数:35720

请求参数是商户在与支付宝进行数据交互时,提供给支付宝的请求数据,以便支付宝根据这些数据进一步处理。

参数

参数名称

类型(字节长度)

参数说明

是否可为空

样例

基本参数

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是以2088开头的纯16位数字。
  • seller_email是支付宝登录账号,格式一般是邮箱或手机号。
  • seller_account_name是卖家别名支付宝账号。

三个参数至少必须传递一个。

当签约账号就是收款账号时,请务必使用参数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:做CTU校验;
  • N:不做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请求;
  • 参数body(商品描述)、subject(商品名称)、extra_common_param(公用回传参数)不能包含特殊字符(如:#、%、&、+)、敏感词汇,也不能使用外国文字(旺旺不支持的外文,如:韩文、泰语、藏文、蒙古文、阿拉伯语);
  • 请按照签名中的签名方法对输入参数进行签名,该接口请求才能够被支付宝系统接收;
  • 此接口支持重复调用,前提是交易基本信息(买家、卖家、交易金额、超时时间等)在多次调用中保持一致,且交易尚未完成支付。

https://mapi.alipay.com/gateway.do?_input_charset=gbk&defaultbank=CMB&notify_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

FAQ

关于此文档暂时还没有FAQ
返回
顶部