POS功能指令接口
Request Body Parameters
application/json公共请求参数
bizContent
summaryObject可选settlementObject可选printObject可选requestIdString(64)必填唯一请求号,商户全局唯一requestTimeString(13)必填商户侧请求时间。时间戳,到毫秒deviceSnString(64)必填设备序列号,用于指定目标POS机deviceModelString(64)必填设备型号,用于指定目标POS机cmdTypeString(32)必填指令类型:- Summary - 汇总结算
- Settlement - 结算
- PrintLast - 打印最后一笔
请求报文示例
{
"accId": "SP1234567890",
"clientId": "P100001",
"signType": "SHA256",
"sign": "SIGNATURE_VALUE",
"version": "1.0",
"bizContent": {
"requestId": "REQ20241101002",
"requestTime": "1698912345678",
"deviceSn": "POS001",
"deviceModel": "M30",
"cmdType": "Settlement",
"settlement": {
"skipSettleConfirm": "N",
"printTransaction": "Y",
"needPassword": "Y"
}
}
}Responses Body Parameters
application/json公共返回参数
bizContent
requestIdString(64)必填商户请求号cmdIdString(64)必填指令IDcmdTypeString(32)必填指令类型:- Summary - 汇总结算
- Settlement - 结算
- PrintLast - 打印最后一笔
statusString(64)必填指令处理状态:- PROCESSING - 处理中
- FAILED - 失败
- SUCCESS - 成功
响应报文示例
{
"accId": "SP1234567890",
"clientId": "P100001",
"signType": "SHA256",
"sign": "SIGNATURE_VALUE",
"code": "001000",
"description": "Successful request",
"bizContent": {
"requestId": "REQ20241101002",
"cmdId": "CMD12346",
"cmdType": "Settlement",
"status": "PROCESSING"
}
}