测试环境：http://47.95.131.62:8080/api/v2/pay/bankcard/forward

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

  • 本接口无需包含接口公共参数，仅传输下列参数即可：
参数 参数名称 类型 参数说明 样例 可空
batch_no 批次号 String O
valid_date 卡有效期 String O
pay_mode 支付模式 String 支付模式（预授权固定PREAUTH） PREAUTH M
station 基站 String 基站信息为小区号+基站号 O
out_trade_no 外部流水号 String M
agent_no 服务商编号 String M
notify_url 通知地址 String 交易成功后的异步通知地址 O
mac 消费报文的签名值 String HEX编码 针对除mac参数以外的其它参数的签名值 M
limit_pay 限制贷记卡支付 String (v1.19增加)
0：不限制贷记卡支付
1：禁止使用贷记卡支付。
不上送此参数时，limit_pay默认为0，即：不限制贷记卡支付		 O
request_data 消费报文 JSON M

request_data

参数 参数名称 类型 参数说明 样例 可空
f3 交易处理码 N6 固定为030000 030000 M
f4 交易金额 N12 以分为单位 M
f11 受卡方系统跟踪号 N6 POS终端交易流水为6位数字，值从1至999999循环使用 000010 M
f22 服务点输入方式码 N3 具体参见银行卡支付附录。常用代码：021-刷卡有密、051-插卡有密、071-挥卡有密、022-刷卡无密、052-插卡无密、072-挥卡无密,911-人脸支付 051 M
f23 卡序列号 N3 IC卡交易时必填 O
f25 服务点条件码 N2 00 M
f26 服务点PIN获取码 N2 12 O
f35 2磁道数据 z..37 22域磁条输入且存在二磁道信息(人脸支付获取人脸路由接口返回的token值进行上送) M
f36 3磁道数据 z…104 22域磁条输入且存在三磁道信息 O
f41 受卡机终端标识码 ANS…50 SaaS终端编号 M
f49 交易货币代码 an3 人民币的货币代码为156 156 M
f52 个人标识码数据 b64 对于磁条卡交易和手机芯片交易有PIN时必选；对于基于PBOC借/贷记标准的IC卡交易，当使用脱机密码验证时，该域不出现；当使用联机密码验证时，该域出现 O
f54 21号文数据 ANS…600 21号文需要的数据，内容采用TLV格式，例如：“720812345678”，tag是“72”，len是“08”，value是“12345678” M
16（tag） 机身号 ANS…50 设备机身号 M
24（tag） 经度信息 ANS…10 终端的实时经度信息，格式3位整数+1位小数点+6位小数；可选上送 O
25（tag） 纬度信息 ANS…10 终端的实时纬度信息，格式1位正负号+2位整数+1位小数点+6位小数；可选上送 O
26（tag） 终端入网认证编号 ANS…5 银行卡受理终端产品入网认证编号，该编号由”中国银联标识产品企业资质认证办公室”为通过入网认证的终端分配 M
27（tag） 加密随机因子 ANS…10 10字节变长字符，由终端生成并上送 M
28（tag） 硬件序列号密文数据 ANS…8 长度为8字节 M
29（tag） 应用程序版本号 ANS…8 终端应用程序版本号 M
f55 IC卡数据域 最大255字节数据 以下子域中的M仅当该交易为IC卡交易时有效 O
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

请求示例:

{
    "agent_no":"ISV23134123",
    "batch_no":"000001",
    "pay_mode":"PREAUTH",
    "mac":"4141344243363135",
    "notify_url":"http://www.baidu.com",
    "out_trade_no":"1585208338613",
    "request_data":{"f11":"000042","f22":"071","f23":"001","f25":"00","f26":"12","f3":"000000","f35":"6217000010070255677D24122205651020000","f4":"000000000001","f41":"M0000007","f49":"156","f52":"6BE2B14524E20550","f54":"1622000001041959CA88775827062580772808485FEDFF29011","f55":"9326081712EDDB5D42932F9F101307010103A00000010A010000000000675860E99F370472B993ED9F36020443950500000000009A032003269C01009F02060000000000015F2A02015682027C009F1A0201569F3303E0F0C89F3501228408A0000003330101019F090200209F6310303130353030303000000000000000009F1E0843413838373733489F03060000000000009F4104000000009F2701809F3403000000"},
    "valid_date":"2412"
}

返回参数

参数 参数名称 类型 参数说明 样例 可空
return_code 业务校验状态码 String 10000为通过，其余不通过 10000 M
return_msg 业务校验状态码说明 String 对return_code进行说明 成功 M
trade_no 消费交易订单号 String return_code为10000时返回 BA210316154907397916903097 O
trade_status 交易状态 String 1(成功),2（失败）,3（进行中）,4(超时);return_code为10000时返回 1 O
trade_msg 交易状态说明 String 对trade_status失败时进行解释说明,return_code为10000时返回 一般没有 O
channel_code 银联通道状态码 String 对标银联39域,return_code为10000时返回 00 O
bank_iss_no 发卡机构代码 String return_code为10000时返回 01020000 O
mac 返回报文的签名值 String HEX编码 针对除mac参数以外的其它参数的签名值，result为0时返回 O

返回示例:

{
  "bank_iss_no": "01020000",
  "trade_no": "BA210316171627414909245264",
  "return_msg":"成功",
  "return_code": "10000",
  "trade_status":"1",
  "channel_code": "00",
  "mac": "3137344444344335"
}
文档更新时间: 2024-01-12 16:04   作者：暴兴