1.文档说明

1.1文档目的

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

1.2阅读对象

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

1.3技术支持

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

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

DEMO下载

1.4术语与定义

1.4.1符号含义

1.4.2术语含义

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

2.业务接口说明

2.1银行卡卡宾服务

交易URL

• 测试环境地址：https://vgw.baofoo.com/biztransfer/product/bankcard/v1/bin/info
• 正式环境地址：https://gw.baofoo.com/biztransfer/product/bankcard/v1/bin/info

请求报文

加密数据

加密数据模板:

• JSON

  {
    "member_id": "100026286",
    "terminal_id": "200001418",
    "trans_id": "XXXXXXXXXXXX",
    "trade_date": "20190123135756",
    "card_no": "6222****001",    
    "product_type": "0",
    "industry_type": "A1"
  }

应答报文

业务响应参数(data)

响应成功示例

{
   "success": true,
   "data": {
        "code":"0",
        "desc":"处理成功",
        "trans_id":"TID1564727757972",
        "trade_no":null,
        "fee":"N",
        "bank_description":"农业银行",
        "card_description":"金穗通宝卡(银联卡)",
        "card_bin":"622848",
        "card_type":"1",
        "bank_id":"ABC",
        "pay_id":"3005"
    },
    "errorCode": null,
    "errorMsg": null
}

响应异常示例

{
    "success":false,
    "data":null,
    "errorCode":"S1015",
    "errorMsg":"未找到卡bin信息"
}

附录：

1. 机构响应码

2.银行编码列表

3. 银行卡卡宾类型