​

1 文档说明

1.1 文档目的

本文档目的是为宝付商户转账支付定义一个接口规范，以帮助商户技术人员快速接入宝付网关，并快速掌握其相关功能，便于尽快的投入使用。
​

1.2 阅读对象

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

  1.3 技术支持联系方式

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

  1.4 术语与定义

  1.4.1 符号含义

  序号|符号缩写|符号性质|符号说明
  –|:-:|:-:|-
  1|M|强制域(Mandatory)|必须填写的属性，否则会被认为格式错误
  2|C|条件域(Conditional)|某条件成立时必须填写的属性
  3|O|选用域(Optional)|选填属性
  4|R|原样返回域(Returned)|必须与先前报文中对应域的值相同的域
  ​

  1.4.2 术语含义

• 商户号：宝付提供给商户的唯一编号，是商户在宝付的唯一标识。
• 终端号：商户在与宝付签订某项具体产品功能的合作协议自动分配的会员属性，将用于进行具体交易的必要参数。
• 原商户订单号：原先支付时商户请求提交的支付订单号。
• 商户流水号：商户请求宝付时提交的流水号，每次请求均不可重复。
• 商户订单号：商户请求宝付时提交的订单号，当天请求不可重复；
• 宝付交易号：宝付用于一笔订单的唯一标识。
  ​

  2 业务方案说明

  2.1 应用场景

  适用于高频付款场景。每次付款仅换附言即可，宝付提供固定的收款账户，为每笔交易分配一个随机码（动态转账附言）。
  注：该接口为纯后台模式
  ​

  2.2 业务流程

  1、商户开通转账支付产品，并由商务经理申请配置转账支付随机码收款功能；
  2、商户调转账支付随机码下单接口，宝付将商户随机码固定收款子账户及订单唯一对应的随机码返回给商户
  3、用户在商户平台进行正常的支付请求，商户向用户展示收款子账户及随机码（银行转账附言）信息；
  4、用户通过网银向商户展示的收款子账户转账，并输入 转账附言（随机码）；
  5、宝付收到用户付款信息后比对 收款户名、收款账号、金额、转账附言如一致，宝付自动完成资金收款并入账至商户账户，不一致则自动将资金原路退款给用户。

  账号：开通转账支付随机码权限后由宝付分配
户名：[商户主体名称]
开户银行：支付机构备付金集中存管账户
开户城市：上海
开户网点：宝付网络-备付金账户
行号：991290000793
  ​

  3.收款子账户交易接口

  3.1 转账支付建单（随机码）

  3.1.1接口说明

  交易URL
  测试环境地址：https://vgw.baofoo.com/cutpayment/api/backTransRequest
  正式环境地址：https://public.baofoo.com/cutpayment/api/backTransRequest

3.1.2 请求报文

加密数据

加密数据模板JSON
{
“member_id”:123564,
“trans_id”:”123456”,
“order_money”:”1000000”,
}

3.1.3返回报文说明

解密后报文JSON
{
“additional_info”: “”,
“data_type”: “json”,
“member_id”: “100000178”,
“order_id”: 25960005451,
“req_reserved”: “”,
“resp_code”: “0000”,
“resp_msg”: “交易成功”,
“terminal_id”: “100000935”,
“trans_id”: “20250512185554509600”,
“trans_serial_no”: “202505121855545098902”,
“txn_sub_type”: “99”,
“txn_type”: “0431”,
“version”: “4.0.0.0”
}

3.2转账支付订单查询接口

3.2.1接口说明

交易URL
测试环境地址：https://vgw.baofoo.com/cutpayment/api/backTransRequest
正式环境地址：https://public.baofoo.com/cutpayment/api/backTransRequest

3.2.2 请求报文

加密数据

3.2.3 应答报文

3.3 转账支付异步通知

3.3.1 功能说明

将结果异步通知给商户

3.3.2 通知报文

member_id= 100000178&terminal_id=1000938&data_content=09f27e40024994307c854b5bff54fdbb79e7ed9900e6013e58a816e31ef39088f42417a5d87d05e01508b93bea5be2af8fa0562b8259b07eff3fb61fee70d69a5550561731b6bf1319a98091180490d6fd783af72d20e7bf53e3b924f6455f93d7234fff06fef004f05e6795903e21535a1b19fa75473fc99a8b8ff2aadc146f85bf2bb168ccfa724a77e24f4aea12ed0634b4810feed3c1c799bdbd03b98c8378ca5fa68efd1bccd54d8f9a7ad80912f8e5c29ff74f0b8bef247c4e4319f8778366f06f3b547f9586bf229e3b15bd38523999bb58f9c11fd68df33da5ad5d99f6a528c69b178248804da25b082ab08f9c504a4db70139f1a540614fa21cebb3

解密后报文

• Xml格式

  <result>
  <resp_code>0000</resp_code>
  <resp_msg>成功</resp_msg>
  <memberTransId>test0000000000a01</memberTransId>
  <state>1</state>
  <orderMoney>1.01</orderMoney>
  <succTime>20170808143943</succTime>
  </result>

• Json格式

  {
  "resp_code":"0000"
  "resp_msg":"成功"
  "memberTransId":"test0000000000a01",
  "orderMoney":"1.01",
  "state":"1",
  "succTime":"20170808143943"
  }

加密数据

注：
宝付将掉单或超时的订单取出，补发支付结果（结果有成功和失败，不是仅仅发支付成功的订单，请商户务必要根据应答码判断支付结果是成功还是失败，再进行正确的处理），以GET和POST方式发送到商户配置的接收地址，商户接收到支付结果，并且进行相应处理之后，需要商户接收通知的地址在页面上输出 OK 表示接收成功<除了 OK 无任何其他内容>，告诉宝付已经成功接收并处理完毕，宝付系统在未得到商户接收通知成功的反馈时，将通过重发机制再次通知商户（重发次数 2~10 次，请以第一次收到的支付成功的消息为准，避免进行多次充值或支付），直到商户接收成功或达到最大重发次数为止。

3.6 收款子账号入金通知

3.6.1 接口说明

该接口用于接收收款子账号入金银行流水通知

3.6.2 应答报文

加密数据

请求响应结果的数据类型根据请求参数字段“data_type”来决定，输出内容包括

3.7 收款子账号银行流水退款通知

3.7.1 功能说明

该接口异步通知场景是针对用户通过网银将交易资金付款到商户的收款账户（我司给商户分配的收款账户），因商户建单超时或用户转账卡号中风控等原因导致转账资金流水无法登记到商户账户下的原路退回场景给商户发送的退款通知

异步通知以POST方式发送到商户配置的接收地址，商户接收到支付结果，并且进行相应处理之后，需要商户接收通知的地址在页面上输出 OK 表示接收成功<除了 OK 无任何其他内容>，告诉宝付已经成功接收并处理完毕，宝付系统在未得到商户接收通知成功的反馈时，将通过重发机制再次通知商户（重发次数 2~10 次，请以第一次收到的支付成功的消息为准，避免进行多次充值或支付），直到商户接收成功或达到最大重发次数为止。

3.7.2 通知报文

{“data_content”:”384e97a6d316e841838c49580ccb614182f8721cc6ead8d445fff3cd78065d36c098aac2e93e3e38914e40dddba09e1a1d0e22859b2ae035cfaf7fd6ba387d4a1ed274d66c9a6913553297bee86e156c8a6b3bcf98c8991d49372283eb08379774cec6c430e0e1cd00a1a4160e07fea99dfc0047863d76be0f6f33b546025e77857b7230e6b1ad4f40dcad369e1d78211caca305104cdde6d03b5279c91d49a8fc835626c9e569eadfe2724d48f7116880558b75e05fd64d9005765a3ee41ea79acf9d57d0c0858c623fde08ff697f29ea407af76538df38e4fe48caf376119f6e2109be946f5fb1965a6447931d1ccdabf853362f4bf58d3aa3c3eadbe638e333ee65a5cf44f69f60ba477b9553a01b0527b589212af23932fc8775a27b11222e61397e27c93928f92f08ac69b9add28bd360892601bc7fff063f878060e7f5ec0694e7df7f0bacaff5aa74cc62305e6206aa9e484505e31ba63dabc37984f58aab11f6ceec74a71b64874b8dbe8f371d7931c9c17905e1156f6a11a92ebecc6cb92afe6af450054c84ca92aa199e123a6dce83c1cdf6387a020000d2d66a0072f825acda029cccdd3db4302c9bfc64aab94d0ca25b4861abf39352ea29ad8624c1274643c96695a2059f6f2099b5f86340077d3e63154b13e9f935c131afaec799fac2d5da60f4030922984d4472048637da5adacd6701d4dd8d6fc2997e83”,”member_id”:”120838”,”terminal_id”:”23462”}

解密后报文

• Json格式

  {"resp_code":"0000","resp_msg":"成功","member_id":"120838","payee_acct_code":"68010200008001","order_money":"0.22","order_time":"20250909191653","bank_serial_no":"101011D511757416611137852","refund_money":"0.22","refund_succ_time":"20250909202002","refund_reason":"超时退款","payerUserName":"*婷婷","payerAcctCode":"621700*********0704"}

加密数据

附录

1 应答码

• 交易成功类

• 交易结果暂未知，需查询类

• 交易失败，无需查询类

2 银行编码

3 交易子类

4 匹配码规则

规则：2位的商户编码 + 36进制编码（当前时间与基准时间差36进制转大写）
注：1.商户编码由宝付生成并提供，请联系宝付技术支持

2. 36进制编码规则及demo请联系宝付技术支持

5 订单重复性校验

宝付为了确保交易能够准确的通知到商户，有可能会重复发送通知消息，为此宝付提醒商户，采取正确的防重复校验。
大多数校验通知都采取先查询后更新的方式，这种方式存在一个很大的漏洞，当多个通 知请求在很短的一个时间内达到时，查询数据有可能是脏数据，导致订单重复更新，后续工 作重复执行。

对于此种情况，宝付结合自身校验情况，分享两个校验方式。
1) 如果是单线程或者订单资源在一个共享区域，那么可以采取锁定资源的方式，每次 调用加锁，每次调用完毕解锁。
2) 大部分数据都存在数据库，宝付绝大多数都是这种情况，利用数据库的特性来控制， 在我们调用数据库更新信息时，数据库会返回给我们更新条目数，我们利用这个特性，这样 操作，当我们更新订单时，把这个订单的原始状态作为条件进行更新，当我们短时间内操作 更新时，第二次更新必然不成功，因为条件不满足了，状态变了，那么数据库在第二次就会 返回更新数量为0，这样我们就发现问题了，这就是熟称的“乐观锁”。
0 个附件