即时到账批量退款⽆密接⼝
(refund_fastpay_by_platform_nopwd)即时到账批量退款⽆密接⼝
交易时间字符串是什么服务名称:
refund_fastpay_by_platform_nopwd
版本号:3.9
⽀付宝(中国)⽹络技术有限公司版权所有
⽬录
1 ⽂档说明 (5)
1.1 功能描述 (5)
1.2 阅读对象 (5)
1.3 业务术语 (5)
2 功能演⽰ (6)
3 数据交互 (7)
4 请求参数说明 (8)
4.1 含义 (8)
4.2 列表 (8)
4.3 单笔数据集参数说明 (9)
4.4 单笔数据集(detail_data)注意事项 (10)
4.5 分润退款数据集格式注意事项 (10)
4.6 ⼦交易退款数据集格式注意事项 (11)
4.7 充退通知地址参数说明 (11)
4.8 退款模式优缺点列表 (11)
4.9 样例 (12)
5 xml同步返回参数说明 (12)
5.1 含义 (12)
5.2 列表 (13)
5.3 样例 (13)
6 服务器异步通知参数说明 (14)
6.1 含义 (14)
6.2 列表 (14)
6.3 处理结果详情说明 (15)
6.4 样例 (17)
7 充退异步通知参数说明 (18)
7.1 含义 (18)
7.2 列表 (18)
7.3 样例 (19)
8 通知返回数据处理 (20)
8.1 xml同步返回特性 (20)
8.2 服务器异步通知页⾯特性 (20)
8.3 通知触发条件 (21)
8.4 商户业务处理注意事项 (21)
9 签名机制 (22)
9.1 ⽣成待签名的字符串 (22)
9.1.1 需要参与签名的参数 (22)
9.1.2 ⽣成待签名字符串 (22)
9.2 签名 (23)
9.2.1 MD5签名 (23)
9.2.2 DSA、RSA签名 (24)
10 如何验证是否⽀付宝请求 (24)
11 附录 (25)
11.1 即时到账批量退款业务错误码 (25)
11.2 系统错误码 (29)
11.3 银⾏列表 (29)
1 ⽂档说明
1.1 功能描述
对通过即时到账接⼝付款完成的交易进⾏部分或全部的退还。商户⽆需输⼊⽀付密
码。
1.2 阅读对象
⽀付宝即时到账批量退款⽆密接⼝⽂档⾯向具有⼀定的⽹站开发能⼒,了解ASP、
PHP、JAVA、www.doczj/doc/f89e24354a73f242336c1eb91a37f111f0850d51.html 等开发语⾔中的⼀种及SQL数据库语⾔的⽹站开发、维
护和管理⼈员。
1.3 业务术语
表1-1业务术语
术语解释
充退即充值退回,卖家通过退款将资⾦从卖家⽀付宝账号退⾄交易买家⽀付宝账号后,⽀付宝将退款资⾦继续退⾄买家付款的银⾏卡的过程。
充退转账由于银⾏原因或者交易买家的原银⾏卡被注销,充退失败,⽀付宝允许买家上传⼀张新的有效银⾏卡或者⽀付宝账号,⽀付宝将退款资⾦退到买家提供的银⾏卡(建议买家提供新的银⾏卡)或⽀付宝账户的过程。
返回将退款请求的处理结果以XML返回给商户。分润将交易的某⼀部分费⽤分给其它账户。
请求向⽀付宝系统发起⼀次退款接⼝的调⽤。
释放当⼀个⽤户A要使⽤(修改,注册等场景)某⼿机号作为登录号,⽽⼿机号被B占⽤时,如果占⽤的⽤户符合可释放条件,A仍然可成功修改⼿机号,并可以把当前占⽤者B的登录号给释放掉,被释放的登录号会被打上释放标识。
数据集退款请求的明细数据。
通知将退款请求的处理结果数据通过服务器主动通知的⽅式通知给商户⽹站。主交易针对商户⽹站的⼀笔即时到账交易。
⼦交易针对主交易发起的补款交易。
2 功能演⽰
步骤1:商户根据接⼝的要求配置批量退款请求参数,如图2-1所⽰界⾯。参数配置详见“4 请求参数说明”。
图2-1设置批量退款接⼝参数
该界⾯仅供参考,请依据商户⾃⾝的业务逻辑或平台管理情况,把接⼝嵌⼊到商户
系统中。
步骤2:⽀付宝系统接收到合作伙伴的URL请求之后,返回如图2-2所⽰的xml数据。
图2-2批量退款请求返回数据
3 数据交互
图3-1商户系统请求/⽀付宝响应交互模式
(1) 构造请求数据
商户根据⽀付宝提供的接⼝规则,通过程序⽣成得到签名结果及要传输给⽀付宝的
数据集合。
(2) 发送请求数据
把构造完成的数据集合,通过页⾯链接跳转或表单提交的⽅式传递给⽀付宝。
(3) ⽀付宝对请求数据进⾏处理
⽀付宝得到这些集合后,会先进⾏安全校验等验证,⼀系列验证通过后便会处理完
成这次发送过来的数据请求。
(4) 返回处理的结果数据
对于处理完成的交易,⽀付宝会以两种⽅式把数据反馈给商户⽹站。
z返回XML数据格式的提⽰信息;
z⽀付宝服务器主动发起通知,调⽤商户在请求时设定好的页⾯路径(参数notify_url,如果商户没设定,则不会进⾏该操作)。
(5) 对获取的返回结果数据进⾏处理
商户在服务器异步通知页⾯(参数notify_url指定页⾯⽂件)或利⽤编程⽅法来模
拟http请求远程解析XML,获取⽀付宝返回的结果数据后,可以结合⾃⾝⽹站的
业务逻辑进⾏数据处理(如:订单更新、⾃动充值到会员账号中等)。
4 请求参数说明
4.1 含义
请求参数是商户在与⽀付宝进⾏数据交互时,提供给⽀付宝的请求数据,以便⽀付
宝根据这些数据进⼀步处理。
4.2 列表
表4-1请求参数说明
参数参数名称类型(长
度范围)
参数说明
是否可
为空
样例
基本参数
service 接⼝名称String 接⼝名称。不可空refund_fastpay_by_p latform_nopwd partner 合作者⾝份
ID
String(1
6)
签约的⽀付宝账号对应的⽀
付宝唯⼀⽤户号。
以2088开头的16位纯数字
组成。
不可空2088101010292685
_input_ charset 参数编码字
符集
String
商户⽹站使⽤的编码格式,
如utf-8、gbk、gb2312等。
不可空GBK
sign_ty pe 签名⽅式String
DSA、RSA、MD5三个值可
选,必须⼤写。
不可空MD5
sign 签名String 请参见“9 签名机制”。不可空vcki5nrx9tgvyvxpq19kh 28f6a8ygcy2 notify_ url 服务器异步
通知页⾯路
径
String(2
00)
⽀付宝服务器主动通知商户
⽹站⾥指定的页⾯http路径。
可空
www.doczj/doc/f89e24354a73f242336c1eb91a37f111f0850d51.html / atinterface/receive_notif
y.htm
dback_ notify_ url 充退通知地
版权声明:本站内容均来自互联网,仅供演示用,请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198,我们将在24小时内删除。
发表评论