1.文档说明

1.1文档目的

本文档的目的是为宝付验卡产品定义一个标准接口规范，以帮助商户技术人员快速接入宝付验卡服务，并快速掌握其相关功能，便于尽快的投入使用。

1.2阅读对象

商户开发人员、维护人员和管理人员
宝付安全服务产品相关的技术人员

1.3技术支持

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

技术支持热线：021-68819999-8119
技术支持Email：support@baofoo.com

1.4术语与定义

1.4.1符号含义

1.4.2术语含义

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

2.业务接口说明

2.1应用场景

宝付服务类产品是为了满足商户直接进行身份验证、银行卡验证等相关服务类认证，商户开通相关产品后认证的手续费直接从商户在宝付开通的账户中扣除。

2.2业务流程

流程图：

流程说明：
1、商户调用宝付五要素验证接口，发送验证请求；
2、宝付发送验证请求至下家（银行/银联/其它）；
3、下家将验证结果通知宝付；
4、宝付同步将验证结果通知商户；

2.3业务接口

2.3.1银行卡验证类交易

商户可通过发起银行卡实名验证类交易对持卡人的身份信息、银行卡信息和银行预留手机号码进行验证。
交易URL

测试环境地址：https://vgw.baofoo.com/biztransfer/bankcard/v2/authWithSign
正式环境地址：https://gw.baofoo.com/biztransfer/bankcard/v2/authWithSign

请求报文

• 加密数据

加密数据模板:
➤JSON

{
    "member_id": "100026286",
    "terminal_id": "200001418",
    "trans_id": "XXXXXXXXXXXX",
    "trade_date": "20190123135756",
    "acc_no": "6222****001",
    "id_card": "3203****9142",
    "id_type": "0",
    "id_holder": "钱*宝",
    "card_type": "101",
    "mobile": "186****765",
    "valid_date": "",
    "valid_no": "",
    "verify_element": "1234-1",
    "industry_type": "A1",
    "acc_type": "01"
}

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

加密业务成功数据 解密后参数(data)

响应成功示例

{
   "success": true,
   "data": "wef0weuf283h2bvkdv0u-09j1ph1f7twf9y1o3flao",
   "errorCode": null,
   "errorMsg": null,
   "encrypt_type": "RSA",
   "data_type": "json",
   "data_sign":"wef0weuf283h2bvkdv0u-09j1ph1f7twf9y1o3flao"
}

加密业务成功数据 解密后示例

{
       "code":"0",
       "desc":"亲，认证成功",
       "trans_id":"14744392884941234",
       "trade_no":"201611071910030000064673",
       "fee":"Y",
       "org_code":"null",
       "org_desc":"null",
       "bank_id":"",
       "bank_description":"",
       "acc_type":"01"
}

响应异常示例

{
    "success": false,
    "data":null,
    "errorCode":"S1000",
    "errorMsg":"请求参数有误",
    "encrypt_type": "RSA",
    "data_type": "json",
    "data_sign":null
}

附录：

1. 机构响应码

2. errorcode响应码

3.银行编码列表

4. 银行卡卡bin类型