检查支付状态

通过对 /payments/session/{session_token} 发起 GET 请求，检查支付的当前状态。此端点是公开的 — 它使用 URL 中的 session_token，不需要 API 密钥 — 因此可以安全地从结账页面调用。

GET https://api.xenonpay.net/api/payments/session/{session_token}

成功响应

返回 200，其中包含支付会话的当前状态和详细信息。

{
  "ref_id": "XPABC123",
  "order_id": "merchant-order-123",
  "description": "Annual membership",
  "status": "SUCCESS",
  "amount": 500,
  "currency": "INR",
  "expires_at": "2026-08-24T10:10:00.000Z",
  "utr": "312482855519",
  "bank": {
    "upiId": "merchant@upi",
    "qrImageUrl": "https://example.com/qr.png",
    "bankName": "HDFC Bank"
  }
}

status 字段的值为 CREATED、UTR_SUBMITTED、PENDING_REVIEW、SUCCESS、FAILED 或 EXPIRED 之一。有关每个状态的含义，请参阅支付状态参考。

错误和速率限制

情况	状态	响应
未知的 session token	404	`{"error":"Session not found"}`
同一 token 每分钟的请求数超过 30 次	429	`{"error":{"code":"SESSION_STATUS_RATE_LIMITED","message":"Too many session status requests. Please wait a minute and try again."}}`

依靠 Webhook 确认支付，仅在备用情况下轮询状态。每个支付会话的轮询上限为每分钟 30 次请求。

这对您有帮助吗？