Skip to main content
POST
/
get-transaction-by-session
Retrieve Transaction Status by Session ID
curl --request POST \
  --url https://api.nayax.com/sdk/get-transaction-by-session \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "basicInfo": {
    "merchantRequestId": "REQ_GETTRANS_001"
  },
  "machineInfo": {
    "machineId": "0434334921100366"
  },
  "sessionInfo": {
    "nayaxSessionId": "ABCDEF123456"
  },
  "transactionIdentifyerType": 0
}
'
{
  "status": {
    "verdict": "Approved",
    "code": 0,
    "statusMessage": "Transaction retrieved successfully."
  },
  "externalTransactionStatus": 12
}
Retrieves the transaction status and other relevant details, including the receipt URL, using a session ID.
Integration URLWhen performing your integration to the API use the stable URL, such as:
  • https://stable-sdk-api.nayax.com/get-transaction-by-session

Authorizations

​
Authorization
string
header
required

JWT RSA token required for authentication. The token should be included in the Authorization header as Bearer <token>. Nayax will issue tokens to the VAS, signed by a private key, and decrypt them using a public key.

Body

application/json

Request to get transaction details by session ID.

Request body for retrieving transaction status.

​
basicInfo
object

Basic request information.

​
machineInfo
object

Information about the machine/terminal.

​
validationKey
string | null

Validation key from the authentication flow.

Example:

"AUTH_KEY_FROM_VALIDATE"

​
transactionIdentifyerType
enum<integer>

The type of identifier used for the transaction query.

Available options:
0,
1
Example:

0

​
sessionInfo
object

Session information, including NayaxSessionId or ExternalSessionId.

Response

Success

Response body for retrieving transaction status.

​
status
object

Transaction status.

​
externalTransactionStatus
enum<integer>

External transaction status from the billing provider.

Available options:
12,
19,
22,
53,
62,
64,
113,
250,
5000,
5001,
5002