跳转到主要内容
query 方法允许客户端应用程序使用 requestId 或 transactionId 轮询终端以获取特定交易的当前状态。这是处理网络超时或应用程序崩溃的关键安全机制,可确保 POS 和终端在支付结果方面保持同步。 使用此方法可以:
  • 如果由于连接中断导致原始响应丢失,则通过检查最终结果来恢复事务状态。
  • 验证交易的当前状态(例如待处理、已授权或已拒绝),而无需重新触发支付逻辑。
  • 检索交易元数据,以支持本地日志记录、审计和对账。

请求

要查询交易,必须提供与原始请求关联的标识符。 以下示例展示了一个典型的请求:

参数定义

下表描述了此请求可用的参数:

回应

终端返回交易的当前已知状态。如果交易仍在进行中,响应将反映其当前阶段。 以下示例展示了一个典型的响应:

响应参数

data 对象将包含该特定请求可用的最新信息: