POS功能指令接口
POST
Request Body Parameters
application/json公共请求参数
bizContent
summaryObject可选汇总查询参数，cmdType=Summary时传入skipSettleConfirmString(3)按条件选是否跳过结算查看；根据渠道能力决定此传参是否生效。
枚举值：Y、N
默认值：Y
如果渠道不支持输入密码，传任何值都会处理printTransactionString(3)按条件选Y-打印；N-不打印
枚举值：Y、N
默认值：Y
如果渠道不支持输入密码，传任何值都会处理needPasswordString(3)按条件选是否需要在POS输入密码，做结算确认；Y-需要；N-不需要
枚举值：Y、N
默认值：N
如果渠道不支持输入密码，传任何值都会处理
settlementObject可选结算参数，cmdType=Settlement时传入skipSettleConfirmString(3)按条件选是否跳过结算查看；根据渠道能力决定此传参是否生效。
枚举值：Y、N
默认值：Y
如果渠道不支持输入密码，传任何值都会处理printTransactionString(3)按条件选Y-打印；N-不打印
枚举值：Y、N
默认值：Y
如果渠道不支持输入密码，传任何值都会处理needPasswordString(3)按条件选是否需要在POS输入密码，做结算确认；Y-需要；N-不需要
枚举值：Y、N
默认值：N
如果渠道不支持输入密码，传任何值都会处理
printObject可选打印参数，cmdType=PrintLast时传入printCopyOptionString(32)按条件选打印选项，默认值：DEFAULT
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"
}
}