POS消费与签到接口文档

版本号 修定人 制定日期 修订日期
1.0.0 Eric.Yang 2020-05-01 2020-05-01 
基于https协议
以POST方式请求和响应
编码集: UTF-8。标准的JSON格式的报文体。

消费

字段名 变量名 是否必填 类型 说明
mch_id 商户号 是 String(45) 商户号
tid 终端号 是 String(45) 终端号
agentno 渠道号 否 String(45) 渠道号
msg_type 消息类型 是 String(4) 消息类型默认为0200
main_acc 主帐号 否 String(45) 主帐号，非必填
trade_deal_code 交易处理码 是 String(45) 交易处理码，默认000000
total_fee 消费金额 是 int 消费金额，单位为分
trade_no 交易流水 是 String(45) 交易流水号
fwdsrfs_code 服务点输入方式码 是 String(10) 服务点输入方式码，默认为00
fwdtj_code 服务点条件码 是 String(10) 服务点条件码，默认为00
fwdpin_code 服务点PIN获取码 否 String(10) 服务点PIN获取码
slfbs_code 受理方标识码 否 String(45) 受理方标识码
trace2 第二磁道数据 否 String(45) 二磁道数据
trace3 第三磁道数据 否 String(45) 三磁道数据
trade_info 用户/交易信息 是 String(100) 用户/交易信息
grbs_code 个人标识码数据 否 String(100) 个人标识码数据
aqkzxx 安全控制信息 否 String(100) 安全控制信息
ic_card_data IC卡数据域 否 String(200) IC卡数据域
card_sn POS机读出的卡序号 否 string（30） 卡序列号
batch_no 批次号 是 String(45) 批次号
mac MAC 是 String(45) MAC
sign_type 签名类型 否 String(45) 签名类型，默认为MD5
nonce_str 随机码 是 String(45) 随机码
sign 签名 是 String(45) 签名
  • 返回的参数
字段名 变量名 是否必填 类型 说明
mch_id 商户号 是 String(45) 商户号
tid 终端号 是 String(45) 终端号
main_acc 主帐号 是 String(45) 主帐号
trade_date 交易日期 是 String(20) 交易日期
trade_time 交易时间 是 String(20) 交易时间
total_fee 消费金额 是 int 消费金额，单位为分
jsck_no 检索参考号 是 String(20) 检索参考号
yd_code 应答码 是 String(20) 应答码
qs_date 清算日期 是 String(20) 清算日期
fwdtj_code 服务点条件码 是 String(10) 服务点条件码
slfbs_code 受理方标识码 是 String(45) 受理方标识码
skfmc 受卡方名称 否 String(45) 受卡方名称
attach_resp_data 附加响应数据 是 String(100) 附加响应数据
trade_info 交易信息 否 String(100) 交易信息
aqkzxx 安全控制信息 否 String(100) 安全控制信息
attach_fee 附加金额 否 INT 附加金额
batch_no 批次号 是 String(45) 批次号
sign_type 签名类型 否 String(45) 签名类型，默认为MD5
nonce_str 随机码 是 String(45) 随机码
sign 签名 是 String(45) 签名
文档更新时间: 2020-09-27 15:07   作者：高俭