Session Status

Query the current status of an existing payment session. Use this to verify payment state, especially if a callback was not received.

Endpoint

Production

GET https://api.spayon.io/api/product/session/{session_id}
Authorization: Bearer YOUR_BEARER_TOKEN

Sandbox

GET https://api.spayon.io/api/sandbox/vendor/checkout-session/{session_id}
Authorization: Bearer YOUR_BEARER_TOKEN

Example Request

GET /api/product/session/4ae3108a-3a1c-42df-bce9-503bbd70ab24
Authorization: Bearer YOUR_BEARER_TOKEN

Response

{
  "sessionId": "4ae3108a-3a1c-42df-bce9-503bbd70ab24",
  "status": "failed",
  "productName": "Iphone 16S",
  "price": "10",
  "currency": "AMD",
  "createdAt": "2025-06-11T17:02:51.118Z",
  "updatedAt": "2025-06-11T17:03:15.202Z",
  "orderId": "ORDER_123456"
}

Status Values

Status	Description
paid	Payment completed successfully
pending	Payment is still being processed
failed	Payment failed or was declined
expired	Session has expired without payment

Session lifetime

Card sessions expire after 15 minutes. Crypto sessions are given a longer window, because a blockchain transfer can take several minutes to confirm — a crypto session stays pending while the network confirms and is not expired mid-payment. SBP sessions expire after 10 minutes, matching the validity of the QR code the customer is shown.

Response Codes

Status Code	Description
200 OK	Status retrieved successfully
401 Unauthorized	Invalid or expired Bearer Token
404 Not Found	Session ID not found

TIP

This endpoint is useful for reconciliation but should not replace callbacks as the primary payment notification mechanism. Always implement the callback flow.