手持POS机通讯协议_lzx_6_6.docx

手持POS机通讯协议一、 消息头格式偏移量字段名类型长度说明0MessageLengthInt4消息长度4OperationCodeInt4操作码8SmartMobileCodestring15手持机编号二、 心跳消息（操作码0）1、发起消息偏移量字段名类型长度说明0HeartRequestInt4心跳发起：固定为02、响应消息偏移量字段名类型长度说明0HeartResponseInt4心跳响应：固定为1三、 商家登录（操作码3001）1、请求消息序号字段名类型长度说明1UserNameString0用户名2PASSWORDString0消费商家唯一码3SignString0MD5（UserName + MD5(PASSWORD)PASSWORD为商家密码2、响应消息序号字段名类型长度说明1RespCodeInt41-成功 其它表示失败2ErrorDiscString0错误描述3BranchNostring36商家唯一码4BranchCodeString0商家编号5BranchNameString0商家名称6BranchModeString1商家模式7CommonExchangeRateString0积分与人民币兑换比率8SendScoresRateString0商家赠送积分比率9BranchStatusString1商家状态10SingleSaledTypeString1单品积分方式11 AbbrNamestring机构简称四、 卡号及消费商家鉴权（操作码3002）1- 请求消息序号字段名类型长度说明1CardNoString0卡号2ConsumeBranchNoGuid36消费商家唯一码3SignString0MD5（CardNo+ ConsumeBranchNo+MD5(PASSWORD)PASSWORD为商家密码2、响应消息序号字段名类型长度说明1RespCodeLong81-成功 其它表示失败2ErrorDiscString0错误描述3CardCodestring36卡内码4UserIndentiIDstring36用户内码5DistributeBranchNostring36发积分卡的机构6OwnerBranchCodeString0发卡商家编码7ConsumeBranchCodeString0消费商家编码8CurrentIntegralstring当前积分9CurrentHistoryScorestring当前历史积分10MinConsumeScorestring积分消费限额11CommonExchangeRatestring积分与人民币兑换比率12CurrentCashstring储值部分余额13CurrentDepositCashstring储值赠送部分余额14CurrentPointsString当前积点值15IsScorestring是否采用积分模式16IsDepositstring是否采用储值模式17RealNamestring会员名称五、金额模式积分消费判断（操作码3003）1、请求消息偏移量字段名类型长度说明1CardNostring0365积分卡卡号2ConsumeBranchNOstring消费商家唯一码3ConsumeAmountString16消费总金额4IsUsedScorestring1是否使用积分5IsUsedDepositstring是否使用储值6SignString0MD5(CardNo+ ConsumeBranchNo+ ConsumeAmount+ IsUsedScore+MD5(PASSWORD)2、响应消息序号字段名类型长度说明1RespCodeInt41-成功 其它表示失败2ErrorDiscString0错误描述3CurrentIntegralDecimal16当前积分4IsDiscountInt4是否具有折扣功能5DiscountRateDecimal16折扣率6DiscountCashDecimal16折扣金额7IsDepositCashInt4是否储值功能8CurrentCashDecimal16当前储值额9CurrentDepositCashDecimal16赠送现金额10IsScoresInt4是否具有积分功能11SendScoresRateDecimal16送积分比率12SendScoreDecimal16送积分值13IsPointsInt4是否积点14SendPointsRateDecimal16送积点比率15SendPointsDecimal16送积点值16PaymentAmountDecimal16应付金额17DeductScoreDecimal16使用积分18UseCashDecimal16使用储值19UseDepositCashDecimal16使用赠送金额20ScoreWarnRedDecimal16最低消费警戒值21IsUsedScoreint4是否使用积分22PayedFeeDecimal16已付金额23PayedTypeInt4已付金额部分的支付方式24CurrentHistoryScoreDecimal16消费前历史积分25DeductHistoryScoreDecimal16扣除的历史积分六、积分消费(操作码3004)1、请求消息序号字段名类型长度说明1ItemNostring消费单号2CardNostring0365积分卡卡号3ConsumeBranchNoGuid36消费商家唯一码4ConsumeAmountDecimal16消费总金额5ConsumeAmountMD5String0消费金额MD56ReceiptAmountDecimal16实收金额7PayPasswordString0卡密码8IsUsedScoreInt4是否使用积分9IsUsedDepositInt4是否储值10OperatorCode操作员编号11Signstring0MD5(CardNo+ ConsumeBranchNo+ ConsumeAmount+ IsUsedScore+MD5(PASSWORD)3、响应消息偏移量字段名类型长度说明1RespCodeInt41-成功 其它表示失败2ErrorDiscString0错误描述3ItemNoString 消费单号七、系统时间查询(操作码3005)1.请求消息序号字段名类型长度说明1MessageLengthInt4消息长度2OperationCodeString4操作码3SmartMobileCodeString15手持机编号2.响应消息序号字段名类型长度说明1ServerTimeDatetime服务器当前时间八、小票重打(操作码3006)1.请求消息序号字段名类型长度说明1ItemNoString4小票单号2ConsumeBranchNostring4商家内码2.响应消息序号字段名类型长度说明1RespCodestring41-成功 其它表示失败2ErrorDiscString0错误描述（中文）3BranchNamestring消费商家名称4BranchCodeString 商家编号5ReceiptNostring单号6ConsumeTimestring消费时间7OperatorCodestring操作员编号8ConsumeAmountString 消费金额9DeductScoresString 使用积分(抵扣积分)10UseCashString 使用储值11UseDepositCashString 使用储值赠送部分12PaymentAmount应付金额13PaidAmount实收金额14ChangeAmount找零金额15DistributeBranchName发卡商户名称16CardNo卡号17SendScores赠送积分(本次积分)18ScoresTotal累计积分19CashTotal储值余额20DepositCashTotal储值赠送部分余额21SendPoints本单积点22PointsTotal积点九、获取消费单号(操作码3007)1.请求消息头文件2.响应消息序号字段名类型长度说明1RespCodestring41-成功 其它表示失败2ItemNostring消费单号十、卡激活(操作码3008)1.请求消息头文件2.响应消息序号字段名类型长度说明1RespCodestring41-成功 其它表示失败2ErrorDisc String0错误描述十一、当班(操作码3009)1.请求消息序号字段名类型长度说明1BranchNoString36商家内码2BranchCodestring商家编号3OperatorCodeString操作员编号4DutyAmtString当班金额2.响应消息序号字段名类型长度说明1RespCodestring41-成功 其它表示失败2ErrorDisc String0错误描述十二、交班(操作码3010)1.请求消息序号字段名类型长度说明1BranchNoString36商家内码2.响应消息序号字段名类型长度说明1RespCodestring41-成功 其它表示失败2 String0错误描述3ItemNostring当班单号4InitAmtstring初始当班金额5UpAmtstring应交金额6ConsumeAmountstring当班过程总消费金额7DepositAmountString当班过程总充值金额8ReceiveScoreString当班过程总接收积分9ReceiveDepositString当班过程总接收储值金额10ReceivePresentString当班过程总接收