---
url: >-
  https://acquirer-api-docs-v4-en.pingpongx.com/notes/zh/api/services/InPersonPayments/cmdDeclare/index.md
description: >-
  POS功能指令接口用于向POS设备发送功能类指令，支持汇总查询、结算执行和打印最后一笔交易等操作。通过此接口，商户可以远程控制POS设备完成日常运营所需的各项功能操作。
---
# POS功能指令接口

```apidef
endpoint: POST /onsiteAcquirer/cmd/declare
name: POS功能指令接口
```

POS功能指令接口用于向POS设备发送功能类指令，支持汇总查询、结算执行和打印最后一笔交易等操作。通过此接口，商户可以远程控制POS设备完成日常运营所需的各项功能操作。

## 请求参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| accId | string | M | 店铺唯一标识 |
| clientId | string | M | PingPong 商户号 |
| signType | string | M | 支持 MD5 、 SHA256 ，具体⻅本文签名规约: /notes/zh/onlinePayment/developer/sign/一栏 |
| sign | string | M | 签名，具体⻅本文签名规约: /notes/zh/onlinePayment/developer/sign/，所有参数均参与签名 |
| version | string | M | 版本号，当前固定为1.0，后续随接口变动可能有调整 |
| bizContent | string | M | 请求参数的集合，最大长度不限，除公共请求参数外所有请求参数都必须放在这个参数中传递，格式：JSON字符串。该字段内容为 JSON 字符串，反序列化后的结构见 contentSchema。 |
| └─ requestId | string | M | 唯一请求号，商户全局唯一 |
| └─ requestTime | string | M | 商户侧请求时间。时间戳，到毫秒 |
| └─ deviceSn | string | M | 设备序列号，用于指定目标POS机 |
| └─ deviceModel | string | M | 设备型号，用于指定目标POS机 |
| └─ cmdType | string | M | 指令类型： Summary - 汇总结算; Settlement - 结算; PrintLast - 打印最后一笔; |
| └─ summary | object | O | 汇总查询参数，cmdType=Summary时传入 |
| └─ └─ skipSettleConfirm | string | C | 是否跳过结算查看；根据渠道能力决定此传参是否生效。
枚举值：Y、N
默认值：Y
如果渠道不支持输入密码，传任何值都会处理 |
| └─ └─ printTransaction | string | C | Y-打印；N-不打印
枚举值：Y、N
默认值：Y
如果渠道不支持输入密码，传任何值都会处理 |
| └─ └─ needPassword | string | C | 是否需要在POS输入密码，做结算确认；Y-需要；N-不需要
枚举值：Y、N
默认值：N
如果渠道不支持输入密码，传任何值都会处理 |
| └─ settlement | object | O | 结算参数，cmdType=Settlement时传入 |
| └─ └─ skipSettleConfirm | string | C | 是否跳过结算查看；根据渠道能力决定此传参是否生效。
枚举值：Y、N
默认值：Y
如果渠道不支持输入密码，传任何值都会处理 |
| └─ └─ printTransaction | string | C | Y-打印；N-不打印
枚举值：Y、N
默认值：Y
如果渠道不支持输入密码，传任何值都会处理 |
| └─ └─ needPassword | string | C | 是否需要在POS输入密码，做结算确认；Y-需要；N-不需要
枚举值：Y、N
默认值：N
如果渠道不支持输入密码，传任何值都会处理 |
| └─ print | object | O | 打印参数，cmdType=PrintLast时传入 |
| └─ └─ printCopyOption | string | C | 打印选项，默认值：DEFAULT |

### 请求示例

```json
{
  "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\"}}"
}
```

## 响应参数

| 参数名 | 类型 | 说明 |
|--------|------|------|
| accId | string | 店铺唯一标识 |
| clientId | string | PingPong 商户号 |
| signType | string | 支持 MD5 、 SHA256 ，具体⻅本文签名规约: /notes/zh/onlinePayment/developer/sign/一栏 |
| sign | string | 签名，具体⻅本文签名规约: /notes/zh/onlinePayment/developer/sign/，所有参数均参与签名 |
| code | string | 结果状态码，见附录状态码表: /notes/zh/appendix/successCodeList/ |
| description | string | 结果描述 |
| bizContent | string | 业务响应参数。该字段内容为 JSON 字符串，反序列化后的结构见 contentSchema。 |
| └─ requestId | string | 商户请求号 |
| └─ cmdId | string | 指令ID |
| └─ cmdType | string | 指令类型： Summary - 汇总结算; Settlement - 结算; PrintLast - 打印最后一笔; |
| └─ status | string | 指令处理状态： PROCESSING - 处理中; FAILED - 失败; SUCCESS - 成功; |

### 响应示例

```json
{
  "accId": "SP1234567890",
  "clientId": "P100001",
  "signType": "SHA256",
  "sign": "SIGNATURE_VALUE",
  "code": "001000",
  "description": "Successful request",
  "bizContent": "{\"requestId\":\"REQ20241101002\",\"cmdId\":\"CMD12346\",\"cmdType\":\"Settlement\",\"status\":\"PROCESSING\"}"
}
```