宝付资金托管接口文档v2.2
宝付资金托管接口文档
宝付网络科技（上海）有限公司
2014年4月29日定制
历史修改记录
目录
一、引言 (8)
1. 目的 (8)
2. 适用对象 (8)
3. 数据安全 (8)
二、托管业务接口参数描述 (9)
1. 资金托管业务 (9)
2. 请求地址 (9)
3. 请求参数 (9)
4. requestParams参数 (10)
5. 调用时候sign 的值 (11)
6. 业务接口 (11)
（6-1）投标 (11)
（6-2）满标 (13)
（6-3）流标 (14)
（6-4）还款 (16)
（6-5）请求响应 (17)
三、充值（页面请求） (18)
1.请求地址 (18)
2.请求参数 (19)
3. requestParams参数 (19)
4. 请求sign (20)
5.请求响应 (20)
四、提现 (22)
(一、页面请求) (22)
1.请求地址 (22)
3. requestParams参数 (23)
5.请求响应 (24)
(二、接口请求) (25)
1.请求地址 (26)
2.请求参数 (26)
3. requestParams参数 (26)
4. 请求sign (27)
5. 请求响应 (27)
五、查询余额(接口) (29)
1.请求地址 (30)
2.请求参数 (30)
3. requestParams参数 (30)
4.请求sign (31)
5. 请求响应 (31)
六、绑定宝付账户(页面请求) (32)
1.请求地址 (32)
2.请求参数 (32)
3. requestParams参数 (33)
4. 请求sign 的值 (34)
5.请求响应 (34)
七、快速注册详情(接口) (36)
1. 请求地址 (37)
2.请求参数 (37)
4. 请求sign (39)
5.请求响应 (39)
八、快速注册-绑定验证码获取(接口) (40)
1.请求地址 (40)
2.请求参数 (40)
3.请求响应 (41)
九、查询接口 (42)
2.请求参数 (42)
3. 请求sign (43)
4. 请求响应 (44)
十、授权协议 (46)
2.请求参数 (46)
3.响应结果 (46)
十一、转账(接口) (47)
1.请求地址 (48)
2.请求参数 (48)
3. requestParams参数 (48)
4.请求sign (50)
5.请求响应 (50)
十二、银行卡绑定、删除接口 (51)
2.请求参数 (51)
3. requestParams参数 (51)
4.请求sign (53)
5.请求响应 (53)
十三、附录 (56)
1 正式接口地址 (56)
2 绑定宝付帐号的流程 (56)
3.AES算法说明 (56)
4. MD5 算法说明 (58)
5. 返回码列表 (58)
6 充值、提现注意事项 (60)
7 其他注意事项 (60)
8 宝付技术支持联系方式 (61)
一、引言
随着电子商务发展日趋成熟，信息化潮流浩浩荡荡，P2P网贷平台却成为舆论关注的焦点。p2p借贷即由具有资质的网站作为中介平台，借款人在平台发放借款标，投资者向借款人放贷的行为。它是随着互联网的发展和民间借贷的兴起而发展起来的一种新的金融模式，这也是未来金融服务的发展趋势。P2P行业中对第三方资金托管、安全支付、高效结算的需求，宝付为P2P行业商户量身定制的资金托管整体解决方案，富有前瞻性地提供了合规、便捷、共赢的一系列解决方案，对P2P用户资金托管，保障用户的资金安全。
本文档对宝付资金托管平台使用和接口对接进行详细说明，帮助商户熟悉宝付资金托管的支付交易流程，达到方便与商户系统集成，快速接入宝付资金托管平台的目的。
1.目的
本接口文档的主要目的是帮助P2P平台商户熟练掌握资金托管的交易流程和网关技术接口。
2.适用对象
本接口文档的阅读对象是宝付接入资金托管商户的应用开发人员、维护人员和管理人员
3.数据安全
在所有的资金的流转过程中，数据传输都采用https安全协议和数字摘要，以保证传输过程中数据的安全性。
二、托管业务接口参数描述
1. 资金托管业务
接口类型描述：支持投标、满标、流标、还款
接口注意事项：
1请求必须为POST请求，请求编码为：utf-8
2业务类型和订单号组合唯一，如action=1(投标)和20140712(商户订单号)。
如果用户重复调用，会返回指令已经存在。
2. 请求地址
https://https://www.360docs.net/doc/372725690.html,/baofoo-custody/custody/p2pRequest.do(仅测试用)
测试商户号：100000675
测试终端号：100000701
测试密钥：n725d5gsb7mlyzzw
3. 请求参数
表格1-1
4.requestParams参数
以下参数为投标、满标、流标、还标总共用到的参数的说明，具体业务，请参考对应的接口参数描述。
表格1-2 5. 调用时候sign 的值
sign = Md5(requestParams + "~|~" + "商户密钥");
6. 业务接口
sign = Md5(requestParams + "~|~" + "商户密钥");
（6-1）投标
1.action_type=1
2.仅允许一个action(投标人) 参数案例：
（6-2）满标
1.action_type=2
2.仅一个action(一个收款人)，支持担保(可选) 参数案例：
（6-3）流标
1.action_type=3
2.多个action(至少一个投标人) 参数案例：
（6-4）还款
1．action_type=4
2．仅一个还款人(“
（6-5）请求响应
1.响应以xml字符串描述
CSD000
2. 响应参数描述
3.响应验签
Md5sign = Md5(code + "~|~" + msg + "~|~" + "商户密钥");
然后检查接受的sign 和Md5sign是否一致。
三、充值（页面请求）
测试商户号：100000675
测试终端号：100000701
测试密钥：n725d5gsb7mlyzzw
1.请求地址
https://https://www.360docs.net/doc/372725690.html,/baofoo-custody/custody/recharge.do
2.请求参数
3. requestParams参数
表1-3
注意：如果使用的是平台承担费用，请确保平台的可用账户资金足够,否则，用户资金会无法正常到账。
requestParams参数案例：
4. 请求sign
s ign = Md5(requestParams + "~|~" + "商户密钥");
5.请求响应
1.响应参数列表
result以xml字符串描述，内容例子如下：