1.文档说明

1.1文档目的

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

1.2阅读对象

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

1.3技术支持

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

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

2.业务接口说明

2.1应用场景

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

2.2业务流程

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

2.3业务接口

2.3.1银行卡验证类交易

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

请求地址

接口地址及公共部分参数对接请参考文档《统一入口(国密版)》

接口服务编号

请求报文

• 数据模板:
  • body部分（JSON字符串）

    {
    "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"
    }

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

• 响应成功示例
  body部分（JSON字符串）

  {
     "code":"0",
     "desc":"亲，认证成功",
     "trans_id":"14744392884941234",
     "trade_no":"201611071910030000064673",
     "fee":"Y",
     "org_code":"null",
     "org_desc":"null",
     "bank_id":"ICBC",
     "bank_description":"工商银行"
  }

• 响应异常示例
  body部分（JSON字符串）

  {
  "code": 3,
  "desc":"亲，认证失败",
  "orgCode":"S1000",
  "orgDesc":"请求参数有误"
  }

附录：

1. 机构响应码

2.银行编码列表

3. 银行卡卡宾类型