AliPay支付宝标准快速付款接口文档doc 26页Word文档格式.docx
- 文档编号:14601823
- 上传时间:2022-10-23
- 格式:DOCX
- 页数:32
- 大小:139.86KB
AliPay支付宝标准快速付款接口文档doc 26页Word文档格式.docx
《AliPay支付宝标准快速付款接口文档doc 26页Word文档格式.docx》由会员分享,可在线阅读,更多相关《AliPay支付宝标准快速付款接口文档doc 26页Word文档格式.docx(32页珍藏版)》请在冰豆网上搜索。
V1.3
增加“公用回传参数”
满足用户自定义参数的要求
2010-3-18
V1.4
通知中增加网银流水
满足商户网银支付需求
2010-3-29
V1.5
请求参数列表
支持自定义超时可以使用时间区间
2010-9-13
V1.5.1
增加4.3.2的信用卡简码
信用卡大额支付也支持纯网关
2010-10-26
说明:
本接口将支付宝即时到帐接口用作纯网关的功能做详细介绍。
在集成时处理机制和原有支付宝即时到帐一样,请求时必须增加默认支付方式(paymethod)和默认网银(defaultbank)2个参数
1前言3
1.1概述3
1.2术语3
2接口功能及参数介绍3
2.1标准即时到账接口(适用于纯网银)3
2.1.1功能描述3
2.1.2交互流程4
2.1.3交互模式4
2.1.4接口详细说明4
2.1.5接口注意事项11
2.1.6接口错误代码列表11
3签名通用策略13
3.1安全方面CheckList13
3.2签名方面13
3.2.1签名机制13
3.2.24.2.2签名方式13
3.3其他方面14
4附录14
4.1接口通用机制14
4.1.1系统调用14
4.1.2页面跳转14
4.1.3支付宝主动通知处理流程16
4.1.4通知验证17
4.2数字签名构造18
4.2.1请求参数构造18
4.3公用枚举表21
4.3.1通知返回结果枚举21
4.3.2通用交易状态枚举表21
4.3.1银行列表22
4.3.2信用卡大额银行列表23
4.3.3订单状态列表23
4.4FAQ(常见问题的的解答)24
1前言
1.1概述
本接口主要用在外部集成网银直连(纯网关)功能
1.2术语
名称
说明
外部商户、合作伙伴、商户
和支付宝进行业务合作的商户
通知页
参数名称Notify_url,所指定的互联网HTTP地址,当代扣完成之后,支付宝发送信息到该页面去,即调用该页面,该页面中的程序自动运行,并判断请求与处理获取到的信息
合作伙伴ID
签约后,为商家自动分配的唯一编号。
分润
分润指将某一部分费用分给其它的帐户
页面跳转
执行操作后跳转到其它页面
2接口功能及参数介绍
2.1标准即时到账接口(适用于纯网银)
2.1.1功能描述
调用此接口,根据用户传过来的参数创建交易,买家再付款。
目前该接口的交易全部为即时到帐纯网银支付接口,即只要买家一付款,钱就会从买家银行卡转到卖家的支付宝账号。
同时该接口还支持分润,商家传过来分润的账号和金额,系统会自动打款到该账号上。
2.1.2交互流程
2.1.3交互模式
请求/响应交互模式,页面跳转
2.1.4接口详细说明
2.1.4.1请求参数列表
特别注意:
a.)此接口只支持https请求,支付宝是以https进行验证
b.)按照支付宝外部请求接口概述中要求的签名方式,对输入参数进行签名,该接口请求才能够被支付宝系统接收。
c.)本接口支持重复调用,但是提交数据必须一样才可以。
d.)在请求时必须增加默认支付方式和默认网银2个参数
字段名
变量名
类型
可空
协议参数
接口名称
service
String
create_direct_pay_by_user
N
partner
String(16)
合作伙伴在支付宝的用户ID与支付宝签约后自动生成
通知URL
notify_url
URL(String(190))
针对该交易的交易状态同步通知接收URL。
返回URL
return_url
URL
结果返回URL,仅适用于立即返回处理结果的接口。
支付宝处理完请求后,立即将处理结果返回给这个URL。
错误通知地址
(需要支付宝功能人员开通)
error_notify_url
如果在交易过程中出错(如签名错误等),则通过此URL将错误码返回给合作伙伴系统
Y
签名
sign
见签名机制,MD5加密算法后得出的结果
签名方式
sign_type
见签名方式,现今默认是MD5加密,无需更改该参数的值
参数编码字符集
_input_charset
String(默认为GBK)
合作伙伴系统与支付宝系统之间交互信息时使用的编码字符集。
合作伙伴可以通过该参数指定使用何种字符集对传递参数进行编码。
同时,支付宝系统也会使用该字符集对返回参数或通知参数进行编码。
注:
该参数必须在queryString中传递,不论使用的是POST还是GET方式发送请求。
如:
业务参数
商品展示网址
show_url
String(400)
点击商品链接后跳转的页面
商品名称
subject
String(256)
商品的标题
商品描述
body
String(1000)
商品的具体描述,如果是多种商品,请将商品描述字符串累加传给body
外部交易号
out_trade_no
String(64)
合作伙伴交易号(确保在合作伙伴系统中唯一)
商品单价
price
Number(13,2)
price:
单位为RMBYuan0.01~100000000.00
total_fee:
单位为RMBYuan
0.01~100000000.00
quantity:
0<
quantity<
1000000
规则:
1.如果是多个商品可以汇总后传入,这个时候商品数量默认为1
2.总价和单价不可以同时出现
3.如果使用总价total_fee,则数量为quantity=1.
3.如果使用单价price,则商品数量quantity传递实际商品数量
交易金额
total_fee
购买数量
quantity
Number(6,0)
支付类型
payment_type
String(4)
默认为:
1(商品购买);
默认支付方式
paymethod
bankPay(网银)
默认网银
defaultbank
见常见银行列表
卖家Email
seller_email
String(100)
卖家在支付宝的注册Email或注册ID,两者任何一个。
卖家ID
seller_id
提成类型
royalty_type
String
(2)
目前只支持一种类型:
卖家给第三方提成(目前参数=10)
提成信息集
royalty_parameters
String(500)
信息格式下面两种都可:
1、收款方Email_1^金额^备注|付款方Email^收款方Email_2^金额^备注
2、收款方Email_1^金额^备注|收款方Email_2^金额^备注
3.(属于多级分润)收款方Email_1^金额^备注|收款方Email_1^收款方Email_2^金额^备注
如有多条则用“|”隔开,最多不能超过10条,备注最多1000个字符,即500个汉字,详见“接口注意事项”
超时时间
it_b_pay
String(3)
商户开通自定义超时功能才有用(支付宝控制权限),定义该交易的超时时间,m表示分钟,h表示小时,d表示天,c表示当天。
商户如果需要改功能,需要告知配置的时间点或者区间,有支付宝技术支持配置。
例如:
1m~15d表示在1分钟和15天之内任何一个时间都可以。
备注:
默认15d关闭交易。
当天理论上是当天的0点后关闭,但是由于是定时任务可能有所延迟。
公用回传参数
extra_common_param
String(200)
用于商户回传参数,该值不能包含=&
等
特殊字符。
如果用户请求时传递了该参
数,则返回给商户时会回传该参数.
一个完整的支付接入请求实例:
&
defaultbank=CMB&
notify_url=
2.1.4.2返回参数列表
此接口有两种返回方式:
注意:
选择具体网银支付方法,进入网银支付页面后才能创建交易,支付完成才返回通知。
需要强调的是部分网银可能不支持支付完成及时跳转,所以商户最好在异步通知中做数据处理或者2个返回处理都集成,增加订单重复接受即可
A.(同步通知):
系统根据执行的结果将相关订单信息返回(只做返回不需要商户和支付宝系统交互)
输出参数列表
基本信息
是否成功
is_success
String
(1)
表示该次操作是否成功
String(32)
见HTTP参数签名机制,
该参数需要获取做签名校验。
签名类型
见签名方式
exterface
使用支付宝的服务接口名称,用此参数可以确定是支付宝的服务
通知时间
notify_time
Timestamp
通知时间(支付宝时间),格式:
YYYY-MM-DDhh:
mm:
ss
通知ID
notify_id
支付宝通知流水号,合作伙伴可以用这个流水号询问支付宝该条通知的合法性
通知类型
notify_type
trade_status_sync
支付宝交易号
trade_no
该交易在支付宝系统中的交易流水号
p
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- AliPay支付宝标准快速付款接口文档doc 26页 AliPay 支付 标准 快速 付款 接口 文档 doc 26
![提示](https://static.bdocx.com/images/bang_tan.gif)