Skip to main content

每日签到

接口用途

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

接口地址

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

action

  • signin

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

字段类型是否必填字段意义备注
traceNoString是请求流水号不允许重复,必须以yyyyMMdd(当天)作为流水号开头+递增序列
posModelString是MIS-POS型号如门店有用到易百机具即填写相应设备机型例如：G2，如门店未用易百机具即填写收银机型号
request8583String否请求报文HEXMIS-POS灌其他机构密钥，需要组包并填写该域
posSnString否机器序列号例如：G8703U12345
curCommuTypeString否pos连网方式GPRS，LAN，WIFI，CDMA
simccidString否sim卡号GPRS和CDMA的必传
netClientIPString否pos本地IPLAN必传
netGateString否本地网关LAN必传

请求报文举例

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

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

字段类型是否必填字段意义备注
traceNoString是请求流水号原样返回
transDateString是交易时间格式为：yyyyMMddHHmmss
returnCodeString是返回码00表示交易成功，其他表示失败
returnDescString是返回信息交易结果描述或错误原因
merchantNameString是商户门店名称 
deviceNoString否收银机编号 
shopNoString否门店编号 
brandString是品牌编号 
defaultHeartbeatNumber是默认心跳间隔单位：秒
publicKeyString是银联IC卡公钥HEX格式，用于IC检验
response8583String否返回报文HEXMIS-POS灌其他机构密钥，后台透传该域
pinKeyString是易百POS PIN密钥使用tmk进行3DES加密，HEX格式，用于卡信息，密码加密，KEY过期时间为本次签到成功即前一次密钥过期
mwMacKeyString是中间件MAC密钥使用mwTmk进行3DES加密，HEX格式，用于中间件报文签名，KEY过期时间为本次签到成功即前一次密钥过期
webPospUrlString否为终端下发请求WEB POSP的地址用于要为终端变更新的请求地址
posUrlString否MIS-POS的更新地址或目录如果为空不需要更新，否则需要更新
mwUrlString否中间件的更新地址或目录如果为空不需要更新，否则需要更新
signBankString否中间件通知MIS-POS作收单行签到如果为空不需要签到，否则需要根据返回的值进行对应收单行的签到，可选值参考收单机构标识
headPictureListList<headPicture>是广告图片用于显示在终端顶部
functionListList<function>是终端功能菜单下发 
nextHearbeatNumber是下次心跳间隔秒数下次心跳间隔秒数
orgLogInInfosList<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": ""
                }
            ]
        }
    ]
}
Back to top