余额查询

测试环境：http://47.95.131.62:8080/api/v1/pay/bankcard/balance

请求参数(O-非必传 ,M-必传):

  • 本接口无需包含接口公共参数，仅传输下列参数即可：
参数 参数名称 类型 参数说明 样例 可空
mac 消费报文的签名值 String HEX编码 针对除mac参数以外的其它参数的签名值 M
requestData 消费报文 JSONObject 消费交易核心数据，整段requestData的值，需要用MACKey签名 M

requestData

参数 参数名称 类型 参数说明 样例 可空
f22 服务点输入方式码 N3 具体参见银行卡支付附录。常用代码：021-刷卡有密、051-插卡有密、071-挥卡有密、022-刷卡无密、052-插卡无密、072挥卡无密 051 M
f23 卡序列号 N3 IC卡交易时必填 O
f35 2磁道数据 z..37 22域磁条输入且存在二磁道信息 M
f36 3磁道数据 z…104 22域磁条输入且存在三磁道信息 O
f41 受卡机终端标识码 ANS…50 SaaS终端编号 M
f52 个人标识码数据 b64 对于磁条卡交易和手机芯片交易有PIN时必选；对于基于PBOC借/贷记标准的IC卡交易，当使用脱机密码验证时，该域不出现；当使用联机密码验证时，该域出现 O
f55 IC卡数据域 最大255字节数据 以下子域中的M仅当该交易为IC卡交易时有效 M
9F26（tag） 应用密文 b64 M
9F27（tag） 应用信息数据 b8 M
9F10（tag） 发卡行应用数据 b…256 M
9F37（tag） 不可预知数 b32 M
9F36（tag） 应用交易计数器 b16 M
95（tag） 终端验证结果 b40 M
9A（tag） 交易日期 n6 M
9C（tag） 交易类型 n2 M
9F02（tag） 交易金额 n12 M
5F2A（tag） 交易货币代码 n3 M
82（tag） 应用交互特征 b16 M
9F1A（tag） 终端国家代码 n3 M
9F03（tag） 其它金额 n12 M
9F33（tag） 终端性能 b24 M
9F34（tag） 持卡人验证结果 b24 O
9F35（tag） 终端类型 n2 O
9F1E（tag） 接口设备序列号 an8 如果终端标识不能隐含确定接口设备序列号，则出现 O
84（tag） 专用文件名称 b…128 O
9F09（tag） 应用版本号 b16 O
9F41（tag） 交易序列计数器 n…4 O
9F63（tag） card_pro_id b…128 当终端能够获取该卡域信息时，本域出现；否则，本域不出现。 O

请求示例:

{
    "mac":"3744454537353435",
    "requestData":{"f11":"000034","f22":"071","f23":"001","f25":"00","f26":"12","f3":"020000","f35":"6217000010070258077D23134205751120000","f41":"M0000007","f49":"156","f52":"6BE2B13434E20550","f55":"9F260832CDF645CD4FE7259F123307010103A00000010A010000000000C4402AEC9F37043EFE9B119F36020445950500000000009A032003269C01009F02060000000000015F2A02015682027C009F1A0201569F3303E0F0C89F3501228408A0000003345101019F090200209F6310303130353030303000000000000000009F1E0843413838373735389F03060000000000009F4104000000009F2701809F3403000000"}
}

返回参数

参数 参数名称 类型 参数说明 样例 可空
balance 余额 String 单位：元 O
mac 返回报文的签名值 String HEX编码 M
result 业务结果 String 0 : 成功；1 : 失败 M
msg 错误信息 String result为1时显示错误信息 O

返回示例:

错误：
{
    "result":"1",
    "msg":"获取的银行商户或银行终端为空",
    "mac":"4642423945444441"
}
文档更新时间: 2024-10-01 15:23   作者：admin