diagnosis

2026-05-15 09:30

Note: Translation in progress.

POST /v2/device/diagnosis

diagnosis 接口由您的 POS 调用，用于检查支付终端的状态。请确保在创建任何支付请求之前调用此接口，以确认支付终端已准备就绪，可以接受支付请求。

结构

报文由报文头和报文体组成。本文主要介绍报文体结构信息，有关报文头的结构信息，请参阅：

请求参数

无

响应参数

参数名称	类型	是否必需	描述
result	Result	是	接口调用的结果。
networkStatus	String	是	网络连接状态。有效值为： `Y`：连接正常。 `N`：连接异常。建议您检查网络状态、路由器，使终端设备重新连接网络。
printerStatus	String	是	打印机状态。有效值为： `Y`：连接正常。 `N`：连接异常。建议您检查终端设备打印机。
globalStatus	String	是	设备整体状态，用于准备接收请求。有效值为： `Y`：连接正常。 `N`：连接异常。建议您重启终端设备。

Result

参数名称	类型	是否必需	描述
resultStatus	String	是	结果状态。有效值为： `S`：成功 `F`：失败 `U`：未知
resultCode	String	否	结果码。（最大长度：64 个字符）
resultMessage	String	否	详细描述结果码的结果消息。（最大长度：256 个字符）

结果码

结果码	状态码	结果信息	后续操作
`SUCCESS`	`S`	成功	无需后续操作。
`PROCESS_FAIL`	`F`	发生常规业务故障。请勿重试。	联系 Antom 技术支持。
`INVALID_API`	`F`	调用的接口无效。	检查进行接口调用时是否使用了正确的接口名称。接口名称不区分大小写。
`CLIENT_INVALID`	`F`	客户端 ID 无效。	检查是否使用了正确的客户端 ID。支付终端集成使用支付终端的序列号（SN）作为客户端 ID。
`INVALID_SIGNATURE`	`F`	签名未通过验证。	参考集成示例代码，检查是否使用了正确的公钥、签名消息和签名算法。
`INVALID_ENCRPT_DATA`	`F`	加密数据无效。	参考集成示例代码，检查是否使用了正确的加密数据。
`METHOD_NOT_SUPPORTED`	`F`	服务器未实现请求的 HTTP 方法。	确保 HTTP 方法为 `POST`。
`UNKNOWN_EXCEPTION`	`U`	未知原因引起的接口调用失败。	重新调用接口。

示例

以下代码展示了一个响应报文：

copy
{
  "result":{
    "resultCode": "SUCCESS",
    "resultStatus": "S",
    "resultMessage": "Success."
  },
  "networkStatus": "Y",
  "printerStatus": "Y",
  "globalStatus": "Y"
}