Skip to main content

每日签到

接口用途

  • 中间件定时任务每天凌晨，调用此接口进行签到，与后台同步密钥信息和状态信息。(因签到前还未获得mwMackey，故使用mwTmk签名)

接口地址

  • https://ebuywebposp-test.e-buychina.com/ebuyweb-posp/api/signin

action

  • signin

请求参数，中间件===>易百后台

字段 类型 是否必填 字段意义 备注
traceNo String 是 请求流水号 不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列
onlineTid String 否 线上对接使用的统一终端号 对接前需提前和易百技术沟通
posModel String 是 MIS-POS型号 如门店有用到易百机具即填写相应设备机型例如：G2，如门店未用易百机具即填写收银机型号
request8583 String 否 请求报文HEX MIS-POS灌其他机构密钥，需要组包并填写该域
posSn String 否 机器序列号 例如：G8703U12345
curCommuType String 否 pos连网方式 GPRS，LAN，WIFI，CDMA
simccid String 否 sim卡号 GPRS和CDMA的必传
netClientIP String 否 pos本地IP LAN必传
netGate String 否 本地网关 LAN必传

请求报文举例

  {
    "traceNo": "99000009100010101732123",
    "posModel": "G2"
  }

返回参数，易百后台===>中间件

字段 类型 是否必填 字段意义 备注
traceNo String 是 请求流水号 原样返回
transDate String 是 交易时间 格式为：yyyyMMddHHmmss
returnCode String 是 返回码 00表示交易成功，其他表示失败
returnDesc String 是 返回信息 交易结果描述或错误原因
merchantName String 是 商户门店名称  
deviceNo String 否 收银机编号  
shopNo String 否 门店编号  
brand String 是 品牌编号  
defaultHeartbeat Number 是 默认心跳间隔 单位：秒
publicKey String 是 银联IC卡公钥 HEX格式，用于IC检验
response8583 String 否 返回报文HEX MIS-POS灌其他机构密钥，后台透传该域
pinKey String 是 易百POS PIN密钥 使用tmk进行3DES加密，HEX格式，用于卡信息，密码加密，KEY过期时间为本次签到成功即前一次密钥过期
mwMacKey String 是 中间件MAC密钥 使用mwTmk进行3DES加密，HEX格式，用于中间件报文签名，KEY过期时间为本次签到成功即前一次密钥过期
webPospUrl String 否 为终端下发请求WEB POSP的地址 用于要为终端变更新的请求地址
posUrl String 否 MIS-POS的更新地址或目录 如果为空不需要更新，否则需要更新
mwUrl String 否 中间件的更新地址或目录 如果为空不需要更新，否则需要更新
signBank String 否 中间件通知MIS-POS作收单行签到 如果为空不需要签到，否则需要根据返回的值进行对应收单行的签到，可选值参考收单机构标识
headPictureList List<headPicture> 是 广告图片 用于显示在终端顶部
functionList List<function> 是 终端功能菜单下发  
nextHearbeat Number 是 下次心跳间隔秒数 下次心跳间隔秒数
orgLogInInfos List<orgLogInInfo> 否 终端对应机构信息列表

返回报文举例

{
    "traceNo": "99000009100010101732123",
    "transDate": "20161231102201",
    "returnCode": "00",
    "returnDesc": "SUCCESS",
    "merchantName": "哈根达斯张杨路店",
    "defaultHeartbeat": 60,
    "publicKey": "9F0605A0000003339F22010BDF05083230313631323331DF060101DF070101DF0281F8CF9FDF46B356378E9AF311B",
    "pinKey": "9D93D15D6A3913AB4151C456A80841EF",
    "mwMacKey": "94365019BBF9CEEAB0DF658E67754A70",
    "posUrl": "http://ebuyweb-posp-test.e-buychina.com/upgrade/pos/G2/20170214/",
    "mwUrl": "http://ebuyweb-posp-test.e-buychina.com/upgrade/mw/G2/20170214/",
    "signBank": "citicCashpay",
    "headPictureList": [
        {
            "displayPicUrl": "",
            "linkUrl": ""
        }
    ],
    "functionList": [
        {
            "iconUrl": "",
            "title": "",
            "action": "",
            "command": "",
            "childrenFunc": [
                {
                    "iconUrl": "",
                    "title": "",
                    "action": "",
                    "command": ""
                }
            ]
        }
    ]
}
No Comments
Back to top
Entity Select