1.文档说明

1.1文档目的

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

1.2阅读对象

  • 开发人员、维护人员和管理人员
  • 宝付相关的技术人员

1.3技术支持

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

2.接口须知

2.1 术语定义

符号 符号性质 符号说明
M 强制域(Mandatory) 必须填写的域
C 条件域(Conditional) 某条件成立时必须填写的域
O 选用域(Optional) 选填属性（可选预）
R 原样返回域(Returned) 必须与先前报文中对应域的值相同的域

2.2 接口调用说明

1..密文数据采用JSON格式，具体数据结构参考每个接口请求
2.请求地址、加密方式见统一入口文档

3.银行卡宾查询接口

3.1接口说明:

1.报文编号：T-1001-032-01

3.2请求报文说明：

域名 变量名 类型 长度 出现要求 参数备注
商户号memberIdString128M
终端号terminalIdString128M
商户订单号transIdString50M订单号唯一不可重复，长度String(50)；
订单日期tradeDateString14C格式：yyyyMMddHHmmss
卡号cardNoString128C卡号：需要加密
产品类型productTypeString128M0:默认产品类型
行业类型cardCnapString128O行业,取值：默认A1

格式样例:

{"body": {
    "memberId":"100000178",
    "productType":"0",
    "cardNo":"45A03A42301DC1DE8563D8A2E04ACBFAC399BF4E6EF358952B6947028DB3055B",
    "transId":"20230912210544749",
    "industryType":"A1",
    "tradeDate":"20230912210544",
    "terminalId":"100003229"
},"header": {
    "member_id":"100000178",
    "charset":"UTF-8",
    "dgtlEnvlp":"04AEB13E2CFB020E6AF5E113F51F97675E01EF5EE457F596954BF78733CB7F655C0D9F213A3A757A4E3FB47AC5F44315B24D782E57E488EEF470C778D88EEBBD7FE8E5F000191D2E8BC9B03A6928BAC1212A9EDA4B3B5427FF4F6CFEBE6450EA36A62225A0AECC47B2492641954338C236",
    "ncrptnSn":"4026170978",
    "version":"1.0",
    "signSn":"1387287848",
    "terminal_id":"100003229",
    "verifyType":"10",
    "timestamp":"2023-09-12 21:05:44"
}
}

3.3返回报文说明：

域名 变量名 类型 长度 出现要求 参数备注
认证结果codeString2M0：查询成功 1：渠道方返回失败 2：查询无结果
结果描述descString32M结果描述
商户订单号transIdString50R商户请求时上送的订单号
交易流水号tradeNoString64O
收费标示feeString1MY：收费N：不收费
银行名称bankDescriptionString32O银行信息卡片开户行信息
卡片信息描述cardDescription String32O卡片信息卡片描述信息
银行卡卡宾cardBinString32O卡宾信息卡宾信息
银行卡类型cardTypeString32O详见文档《附录3》卡类型
银行简称bankId String32O银行简称银行简称
支付方式payIdString32O支付方式id

格式样例:

{
    "body":"{\"bankDescription\":\"华夏银行\",\"bankId\":\"HXB\",\"cardBin\":\"623020\",\"cardDescription\":\"华夏普卡\",\"cardType\":\"1\",\"code\":\"0\",\"desc\":\"处理成功\",\"fee\":\"N\",\"payId\":\"3050\",\"transId\":\"20230912210544749\"}",
    "header":"{\"dgtlEnvlp\":\"044FF1915E93D06689E7ECBC90B84E0F615D50A1456595C6C29FF5B138C6D798A89D9B0EFFC838D00351719F6775C356373EE5BD8FF151FF348FB71D06D4073C8CB32FB6546B9C75AC79FFAA9E7253AC62F771F66F739C48DF85AEE3CF7697C43EBF566510798129579B94C4540D0A9F36\",\"memberId\":\"100000178\",\"ncrptnSN\":\"1387287849\",\"serviceTp\":\"T-1001-032-01\",\"signSN\":\"4026178988\",\"sysRespCode\":\"S_0000\",\"sysRespDesc\":\"请求正常\",\"terminalId\":\"100003229\",\"verifyType\":\"10\"}",
    "sign":"304502203D2AE9464606242359F1A02CA3C5C697A4A3D1776FC0813F14F4FB7766CED3DB02210090EAD440149B307E9AF651E72E962C93D9A88FBC14C89C47859DD990A9EE9EBD"
}

附录：

1. 机构响应码

错误码 含义
S0001 系统繁忙，请稍后再试
S1000 请求参数有误（具体以响应参数错误为准）
S1001 请求订单不存在或已过期，请重新发起交易
S1002 请求订单已受理，请稍后查询交易结果
S1004 请求订单创建失败
S1005 请求报文解析失败
S1006 请求报文加密数据处理失败
S1007 请求明文数据与密文数据不一致
S1008 手机号无效
S2000 商户不存在
S2001 商户状态异常
S2002 商户终端信息不存在
S2003 商户终端信息状态异常
S2004 商户暂不支持该产品
S2005 商户暂不支持该功能
S2006 商户余额不足
S1015 未找到卡bin信息

2.银行编码列表

序号 银行代码 银行名称
1 ICBC 工商银行
2 ABC 农业银行
3 CCB 建设银行
4 BOC 中国银行
5 BCOM 交通银行
6 CIB 兴业银行
7 CITIC 中信银行
8 CEB 光大银行
9 PAB 平安银行
10 PSBC 邮储银行
11 SHB 上海银行
12 SPDB 浦发银行
13 CMB 招商银行
14 CMBC 民生银行
15 GDB 广发银行
16 HXB 华夏银行
17 BOB 北京银行

3. 银行卡卡宾类型

卡类型 名称
1 借记卡
2 贷记卡
3 预付卡
4 准贷记
附件
作者：闫婷  创建时间：2023-09-14 14:02
最后编辑：闫婷  更新时间：2025-01-09 17:41