Get Machine's Last Sales

In some cases, you may want to see the last sales of a machine to retrieve information about specific transactions. Nayax Core allows you to do so in the following way:

  1. Go to Operations > Machines .
  2. Choose your machine and click Info > Last Sales .

You will be presented with a list containing the latest machine transactions.

Lynx API

Lynx API allows you to do this process programmatically through a GET request. This page will guide you on how to do so using the endpoint below.

🚧

Authentication

Refer to the Security & Token page of this documentation to learn how to access your tokens, and how to properly use it to authenticate your API requests.

Retrieving the Last Sales

You'll use the Get Last Sales for Machine endpoint, adding the machine's unique identifier as a path parameter to retrieve details about the respective machine. This lets you view the latest sales activity associated with the searched machine. See the example request in the code block below:

curl -X GET "https://lynx.nayax.com/operational/api/v1/machines/<MachineID>/lastSales" \
-H "Authorization: Bearer <YOUR_ACCESS_TOKEN>" \
-H "Content-Type: application/json"

📘

Path Params

Replace <MachineID> with the actual machine unique identifier you want to search.

With a successful request, the endpoint will return with a list of recent sales related to the machine. This response JSON will have the following format:

[
  {
    "TransactionID": 2108816976,
    "PaymentServiceTransactionID": "PS123456789",
    "PaymentServiceProviderName": "Stripe",
    "MachineID": 942488501,
    "MachineName": "Marshall Vending",
    "MachineNumber": "MV001",
    "InstituteLocationName": "New York Warehouse",
    "AuthorizationValue": 10.00,
    "SettlementValue": 9.50,
    "CurrencyCode": "USD",
    "PaymentMethod": "Credit Card",
    "RecognitionMethod": "Chip",
    "CardNumber": "************1234",
    "CardBrand": "Visa",
    "CLI": "+1234567890",
    "ProductName": "Bottled Water",
    "MultivendTransactionBit": true,
    "MultivendNumverOfProducts": 2,
    "UnitOfMeasurement": "Item",
    "Quantity": 2,
    "EnergyConsumed": 0,
    "AuthorizationDateTimeGMT": "2024-10-09T16:53:51.225Z",
    "MachineAuthorizationTime": "2024-10-09T16:53:51.225Z",
    "SettlementDateTimeGMT": "2024-10-09T16:54:51.225Z",
    "SiteID": 2,
    "SiteName": "IL1"
  }
]

The table below describes the parameters on the response:

FieldDescription
TransactionID2108816976, identifying the transaction.
PaymentServiceTransactionIDProvides details about the payment processor transaction.
PaymentServiceProviderNameIndicates the name of the payment processor.
MachineIDRefers to the machine where the transaction took place.
MachineNameName of the machine where the transaction occurred.
AuthorizationValueThe authorized transaction amount.
SettlementValueThe settled transaction amount.
CurrencyCodeThe currency used in the transaction (e.g., USD).
PaymentMethodThe method used for payment.
RecognitionMethodHow the payment was recognized.
CardNumberThe card number used for payment.
CardBrandThe brand of the card used for payment.
ProductNameSpecifies the item sold in the transaction.
QuantityThe quantity of the item sold.
AuthorizationDateTimeGMTThe authorization timestamp in GMT.
SettlementDateTimeGMTThe settlement timestamp in GMT.