1 文档说明

1.1 文档目的

本文档的目的是为联合放款相关业务定义一个接口规范，以帮助商户技术人员快速接入宝付平台，并快速掌握其相关功能，便于尽快的投入使用。

1.2 阅读对象

• 商户开发人员、维护人员和管理人员
• 宝付相关的技术人员

1.3 技术支持

在开发或使用联合放款API接口时，如果您有任何技术上的疑问，请按如下方式寻求帮助，宝付技术支持人员会及时处理，给予您答复：
技术支持热线：021-68819999-8005
技术支持Email：support@baofoo.com
技术支持QQ：800066689

1.4 术语与定义

1.4.1 符号含义

1.4.2 术语含义

• 商户号：宝付提供给商户的唯一编号，是商户在宝付的唯一标识；
• 终端号：商户在与宝付签订某项具体产品功能的合作协议自动分配的会员属性，将用于进行具体交易的必要参数。
• 商户订单号：商户请求宝付时提交的订单号，当天请求不可重复，如果商户开通“发送短信类交易”，该订单号从发送短信类交易到当前交易都有效；
• 宝付交易号：宝付用于一笔订单的唯一标识；

2. 业务接口说明

2.1 业务说明

借款人向平台/资方申请借贷，平台/资方联合另外一个或者多个资方，由平台发起指令，进行联合放款。
流程图：

流程说明：
1）借款人向平台申请借款；
2）平台向宝付发起放款指令，指令中包含自己出款金额、多个资方、多个资方相应出款金额，放款账户信息，放款总金额；
3）宝付内部处理指令，将多个资方账户资金扣款，并进行合并，最后进行一笔放款，由宝付备付金单笔出款至借款人银行卡账户；
宝付单笔合并付款，单笔总金额放款成功/失败，失败时资金可以原路返回至各资方虚拟账户；
4）宝付执行，并反馈处理结果；

2.2 交易接口

2.2.1 接口URL

• 测试环境地址：https://vgw.baofoo.com/fo-finance-web/facmkt/api/unionPayOrder
• 正式环境地址：https://public.baofoo.com/fo-finance-web/facmkt/api/unionPayOrder

请求报文

签名数据

签名数据模板:

• JSON示例

{
    "memMermberId": "100000178",
    "memTerminalId": "100000859",
    "memTransNo:"100000178201412011230405687",
    "memTotalMoney": "10000",
    "capitalInfos": "100000178,100;100000249,100;100000223,800",
    "foTransTarget": "0",
    "foAccountName": "李四股份有限公司",
    "foAccountNo": "****",
    "foBankName": "招商银行",
    "foBankPro": "上海市",
    "foBankCity": "上海市",
    "foBankDept": "张江高科支行",
    "memRemark": "给李四的转账",
    "memNoticeUrl": "http://www.xxxx.com",
    "memVersion": "4.0.0.0"
}

应答报文（宝付返回报文）

响应结果都是宝付通过非对称加密公私钥方式发送给商户。商户接收到宝付的响应报文，将接收到的DataContent内容，先进行十六进制解码，再用宝付发给商户且后缀为（*.cer）的公钥证书进行验签。

签名数据

返回报文实例：

DataContent= eyJBZGRpdGlvbmFsSW5mbyI6IiIsIkJrQWNjdE5tIjoi5byg5a6dIiwiQmtBY2N0Tm8iOiI2MjIyMDIwMTExMTIyMjIwMDAwIiwiSURObyI6IjMyMDMwMTE5ODUwMjE2OTE0MiIsIklEVHAiOiIwMSIsIk1vYk5vIjoiMTM5MTg1MDQ1MTUiLCJNcmNoZW50Tm8iOiIxMDAwMDA3NDkiLCJSZXFSZXNlcnZlZCI6IiIsIlRybU5vIjoiMTAwMDAwOTQ5IiwiVHJ4RHRUbSI6IjIwMTcwNTAyMTAwNDAyIiwiVHJ4SWQiOiIyMDE3MDUwMjEwMDQwMiIsIlZlcnNpb24iOiIifQ==

签名报文：

• JSON

{
    "memVersion":"4.0.0.0",
    "memTransNo":"100000178201412011230405687",
    "memOrderId:"452167544",
    "memRetCode":"00000",
    "memRetMessage":"交易成功",
    "memMermberId":"100000178",
    "memTerminalId:"100000859",
    "memOrderState":"P",
    "memOrderDetailState":"P00"
}

2.3 交易查询接口

2.3.1 接口URL

• 测试环境地址：https://vgw.baofoo.com/fo-finance-web/facmkt/api/unionPayOrderQuery
• 正式环境地址：https://public.baofoo.com/fo-finance-web/facmkt/api/unionPayOrderQuery

请求报文

签名数据

签名数据模板:

• JSON示例

{
    "memMermberId":"100000178",
    "memTerminalId":"100000859",
    "memOrderId:"452167544",
    "memTransNo":"100000178201412011230405687",
    "memVersion":"4.0.0.0"
}

应答报文（宝付返回报文）

响应结果都是宝付通过非对称加密公私钥方式发送给商户。商户接收到宝付的响应报文，将接收到的DataContent内容，先进行十六进制解码，再用宝付发给商户且后缀为（*.cer）的公钥证书进行验签。

签名数据

返回报文实例：

DataContent= eyJBZGRpdGlvbmFsSW5mbyI6IiIsIkJrQWNjdE5tIjoi5byg5a6dIiwiQmtBY2N0Tm8iOiI2MjIyMDIwMTExMTIyMjIwMDAwIiwiSURObyI6IjMyMDMwMTE5ODUwMjE2OTE0MiIsIklEVHAiOiIwMSIsIk1vYk5vIjoiMTM5MTg1MDQ1MTUiLCJNcmNoZW50Tm8iOiIxMDAwMDA3NDkiLCJSZXFSZXNlcnZlZCI6IiIsIlRybU5vIjoiMTAwMDAwOTQ5IiwiVHJ4RHRUbSI6IjIwMTcwNTAyMTAwNDAyIiwiVHJ4SWQiOiIyMDE3MDUwMjEwMDQwMiIsIlZlcnNpb24iOiIifQ==

签名报文：

• JSON

{
    "memVersion":"4.0.0.0",
    "memOrderId:"452167544",
    "memTransNo:"201703121311122312345",
    "memRetCode":"00000",
    "memRetMessage":"交易成功",
    "memMermberId":"100000178",
    "memTerminalId:"100000859",
    "memOrderState":"P",
    "memOrderDetailState":"P01"
}

2.4 交易通知接口

支付同步返回的结果是付款受理结果不是最终的支付结果，支付最终的结果异步发送给商户交易时传送的通知地址；
支付响应结果都是宝付通过非对称加密公私钥方式发送给商户。商户接收到宝付的响应报文，将接收到的DataContent内容，先进行Base64解码，再用宝付发给商户且后缀为（*.cer）的公钥证书进行验签

注：确认付款同步返回支付结果，代表支付受理成功，并不代表交易成功，请切记不可使用该地址的服务进行交易结果处理。

请求地址：商户在订单请求时传送，代付交易成功（失败）后用于通知商户交易结果的地址

请求报文

签名数据

商户接收通知后
商户提交订单支付请求后，用户通过正常的支付流程支付成功或者支付失败后，支付接口将支付结果通知给商户。
支付结果通知由宝付系统确保一定成功发送给商户。成功发送是指由宝付发出结果通知 到商户后，能够成功获取商户的返回确认（商户接收通知的ReturnUrl在页面上输出OK表 示接收成功<除了OK无任何其他内容>），宝付系统在未确认商户接收通知成功后将会通过 重发机制通知商户（重发次数2~10次，请以第一次收到的支付成功的消息为准，避免进行重复通知）