query 方法允许客户端应用程序使用 requestId 或 transactionId 轮询终端以获取特定交易的当前状态。这是处理网络超时或应用程序崩溃的关键安全机制,可确保 POS 和终端在支付结果方面保持同步。
使用此方法可以:
- 如果由于连接中断导致原始响应丢失,则通过检查最终结果来恢复事务状态。
- 验证交易的当前状态(例如待处理、已授权或已拒绝),而无需重新触发支付逻辑。
- 检索交易元数据,以支持本地日志记录、审计和对账。
请求
要查询交易,必须提供与原始请求关联的标识符。 以下示例展示了一个典型的请求:参数定义
下表描述了此请求可用的参数:回应
终端返回交易的当前已知状态。如果交易仍在进行中,响应将反映其当前阶段。 以下示例展示了一个典型的响应:响应参数
data 对象将包含该特定请求可用的最新信息: