1 文档说明

1.1 文档目的

本文档为宝付资金付款交易接口规范，以帮助商户技术人员快速接入银行账户功能，并快速掌握其相关功能，便于尽快的投入使用。

1.2 阅读对象

• 商户开发人员、维护人员和管理人员

1.3 技术支持联系方式

在开发或使用此接口时，如果您有任何技术上的疑问，请按如下方式寻求帮助，宝付技术支持人员会及时处理，给予您答复。

• 技术支持热线：021-68819999-8005
• 技术支持Email：support@baofoo.com
• 技术支持QQ：800066689

2 接口须知

2.1 术语定义

2.2 返回码说明

当header的 sysRespCode 为S_0000时，body的retCode如下：
1.retCode=1 说明接口调用成功。具体业务是否成功。看具体的参数字段。
2.retCode=0 说明接口调用失败。异常或者参数校验失败。
3.retCode=2 说明接口调用处理中。需要调用查询接口查询状态。

当header的 sysRespCode 为非S_0000时，系统异常或者校验失败。和具体业务无关联。

3 余额查询接口

3.1 接口说明

1. 报文编号：T-1001-007-09
2. 接口用于查询指定商户余额情况
3. 未开通华通账号，电子户余额为0
4. 该接口为同步请求

3.2 请求报文说明

3.3 返回报文说明

响应报文判断结构

{
header.sysRespCode：S_0000(请求正常,继续查看body)
    body.retCode：1(请求成功，查询具体字段)
    body.retCode：0|2(异常,重新发起查询)
header.sysRespCode：S_E_9002(异常,重新发起查询)
header.sysRespCode：其他错误码(异常,重新发起查询)
}

4.资金划拨转账

4.1 接口说明

1. 报文编号：T-1001-007-10
2. 接口用于实现商户银行账户资金划拨
   3.接口为同步接口，
   errorCode = BF0001 为参数校验失败
   errorCode = BF0005 为系统异常
   errorCode = BF0013 商户订单号已存在，请勿重复提交
   4.网络异常未收到报文，请调用查询接口。
   5.当status 为SUCCESS时，表示划拨转账成功。
   6.当status 为PROCESSING时，表示划拨转账处理中，需要调用查询接口查询最终状态。
   7.当status 为FAIL时，表示划拨转账失败。

4.2 请求报文说明

华通银行扩展信息(必填)
shoppingInfo:商户信息(字符串)

苏宁银行扩展参数(非必填)
shoppingInfo: 商户信息(json字符串)

4.3 返回报文说明

响应报文判断结构

{
header.sysRespCode：S_0000(请求正常,继续查看body)
   body.retCode：1
         body.status = SUCCESS (成功)
         body.status = FAIL (失败)
         body.status = PROCESSING (处理中)
    body.retCode：0|2
        body.errorCode = BF0001 (失败)
        body.errorCode = 其他错误码 (异常,调用查询接口)

header.sysRespCode：S_E_9002(未知,调用查询接口)
header.sysRespCode：其他错误码(失败)
}

5.资金划拨转账查询接口

5.1 接口说明

1. 报文编号：T-1001-007-11
2. 接口用于查询商户银行账户资金划拨结果
   3.接口为同步接口，
   errorCode = BF0001 为参数校验失败
   errorCode = BF0005 为系统异常
   errorCode = BF00226 订单不存在
   4.当status 为SUCCESS时，表示划拨转账成功。
   5.当status 为PROCESSING时，表示划拨转账处理中。
   6.当status 为FAIL时，表示划拨转账失败。

5.2 请求报文说明

5.3 返回报文说明

响应报文判断结构

{
header.sysRespCode：S_0000(请求正常,继续查看body)
    body.retCode：1
         body.status = SUCCESS (成功)
         body.status = FAIL (失败)
         body.status = PROCESSING (处理中)
    body.retCode：0|2
         body.errorCode = BF00226 (订单不存在,失败)
        其他错误码重新发起查询

header.sysRespCode：S_E_9002(重新发起查询)
header.sysRespCode：其他错误码(重新发起查询)
}

6.资金代付

6.1 接口说明

1. 报文编号：T-1001-007-12
2. 接口用于实现商户银行账户资金代付，商户调用此接口，支持将银行账户划拨至宝付账户后代付至目标银行卡
   基于一定配置，支持划拨其他关联方银行账户资金至指令方宝付账户后，代付至目标银行卡
   3.该接口为异步请求。
   4.最终状态需要等待通知或者调用查询接口。
   7.网络异常未收到报文，请调用查询接口。
   5.当status 为SUCCESS时，状态为成功表示受理成功，不代表订单最终状态为成功。
   6.当status 为PROCESSING时，表示代付处理中，需要调用查询接口查询或者等待通知。
   7.当status 为FAIL时，表示代付失败。
   8.
   errorCode = BF0001 为参数校验失败
   errorCode = BF0005 为系统异常。
   errorCode = BF0013 商户订单号已存在，请勿重复提交

6.2 请求报文说明

功能说明

6.3 返回报文说明

响应报文判断结构

{
header.sysRespCode：S_0000(请求正常,继续查看body)
    body.retCode：1
         body.status = SUCCESS (成功)
         body.status = FAIL (失败)
         body.status = PROCESSING (处理中)
    body.retCode：0|2
        body.errorCode = BF0001 (失败)
        body.errorCode = 其他错误码 (异常,调用查询接口)

header.sysRespCode：S_E_9002(未知,调用查询接口)
header.sysRespCode：其他错误码(失败)
}

6.4 异步通知

代付订单最终交易状态以代付state为准
宝付返回格式为XML
商户接收到通知后务必在接收通知页面上返回大写OK
通知格式示例： https://www.baofu.com/notify?member_id=100000178&terminal_id=80226&data_type=XML&data_content=66b4deb…
注意：
宝付系统在未确认商户接收通知成功后将会通过重发机制通知商户（重发次数10次，请以第一次收到的付款成功的消息为准，避免进行多次确认）通知发给商户。
该接口除了订单成功、失败结果通知外，退款的结果也一并通知。
商户若需要该回调接口需联系技术支持人员配置回调地址等相关信息。

7.资金代付查询接口

7.1 接口说明

1. 报文编号：T-1001-007-13
2. 接口用于查询商户银行账户资金代付结果。
   3.接口为同步接口，
   errorCode = BF0001 为参数校验失败
   errorCode = BF0005 为系统异常
   errorCode = BF00226 订单不存在
   4.当status 为SUCCESS时，状态为成功表示代付成功。
   5.当status 为PROCESSING时，表示代付处理中。
   6.当status 为FAIL时，表示代付失败。

7.2 请求报文说明

7.3 返回报文说明

响应报文判断结构

{
header.sysRespCode：S_0000(请求正常,继续查看body)
    body.retCode：1
         body.status = SUCCESS (成功)
         body.status = FAIL (失败)
         body.status = PROCESSING (处理中)
    body.retCode：0|2
         body.errorCode = BF00226 (订单不存在,失败)
         其他错误码重新发起查询

header.sysRespCode：S_E_9002(重新发起查询)
header.sysRespCode：其他错误码(重新发起查询)
}

8.资金调拨（第一步）

8.1 接口说明

1. 报文编号：T-1001-007-15
2. 接口用于将银行账户余额充值到宝付账户。
   基于一定配置，支持将关联方银行账户资金充值至指令方宝付账户
   3.接口为同步接口，
   errorCode = BF0001 为参数校验失败
   errorCode = BF0005 为系统异常
   4.当status 为SUCCESS时，状态为成功表示调拨成功。
   5.当status 为PROCESSING时，表示调拨处理中。
   6.当status 为FAIL时，表示调拨失败。

8.2 请求报文说明

8.3 返回报文说明

响应报文判断结构

{
header.sysRespCode：S_0000(请求正常,继续查看body)
    body.retCode：1
         body.status = SUCCESS (成功)
         body.status = FAIL (失败)
         body.status = PROCESSING (处理中)
    body.retCode：0|2
        body.errorCode = BF0001 (失败)
        body.errorCode = 其他错误码 (异常,调用查询接口)

header.sysRespCode：S_E_9002(未知,调用查询接口)
header.sysRespCode：其他错误码(失败)
}

8.4 异步通知

宝付返回data_content 格式为XML
商户接收到通知后务必在接收通知页面上返回大写OK

以POST方式通知商户
参数如下
member_id = 会员号
terminal_id = 终端号
data_type = XML
data_content = 加密报文内容

data_content解密内容如下

9.资金调拨查询

9.1 接口说明

1. 报文编号：T-1001-007-16
2. 查询调拨状态。
   3.接口为同步接口，
   errorCode = BF0001 为参数校验失败
   errorCode = BF0005 为系统异常
   4.当status 为SUCCESS时，状态为成功表示调拨成功。
   5.当status 为PROCESSING时，表示调拨处理中。
   6.当status 为FAIL时，表示调拨失败。

9.2 请求报文说明

9.3 返回报文说明

响应报文判断结构

{
header.sysRespCode：S_0000(请求正常,继续查看body)
    body.retCode：1
         body.status = SUCCESS (成功)
         body.status = FAIL (失败)
         body.status = PROCESSING (处理中)
    body.retCode：0|2
         body.errorCode = BF00226 (订单不存在,失败)
         其他错误码重新发起查询


header.sysRespCode：S_E_9002(重新发起查询)
header.sysRespCode：其他错误码(重新发起查询)
}

10.资金代付（第二步）

10.1 接口说明

1. 报文编号：T-1001-007-17
2. 接口用于实现商户宝付账户资金代付到目标卡
   3.该接口为异步请求。
   4.最终状态需要等待通知或者调用查询接口。
   8.网络异常未收到报文，请调用查询接口。
   5.当status 为SUCCESS时，状态为成功表示受理成功，不代表订单最终状态为成功。
   6.当status 为PROCESSING时，表示代付处理中，需要调用查询接口查询或者等待通知。
   7.当status 为FAIL时，表示代付失败。
   8.errorCode = BF0001 为参数校验失败
   errorCode = BF0005 为系统异常。
   errorCode = BF0013 商户订单号已存在，请勿重复提交

10.2 请求报文说明

10.3 返回报文说明

11.注意事项

初次使用请仔细核对，信息是否有误，出现错误请及时联系宝付技术人员。

附录

1、 返回码

2、 证件图片类型

3、 宝付统一入口须知

统一入口文档地址