Set Up Events Delivery

To set up Events and Alerts Delivery to Amazon SQS, you must have access to Nayax Core with the appropriate user permissions. Specifically, the following roles are required:

  • VMO - Manager

Additionally, ensure you have the Amazon SQS Queue URL, Access Key, and Secret Key obtained during the queue setup process.

Operator Level Setup

Follow these steps to configure Events and Alerts Delivery in Nayax Core:

  1. Go to Administration > Operator.

  2. Find the Operator you wish to set up.

  3. Click the Search button.

  4. Select the operator to display all tabs and details.

  5. Go to the Events Report tab.

  6. Setup General and Alert via SQS:
    a. Select the checkbox next to Is Active to enable this option.
    b. Enter the SQS credentials (Access Key, Secret Key and Queue URL).
    c. Click the Validate button to ensure the Queue credentials are correct.
    d. Enable Encryption (Optional). See the Set Up Encryption section for details.

  7. Apply Data Filters for Event Delivery
    a. Ensure the format is set to No Formatting.
    b. Select the desired DEX Read Types. Only the selected Dex Origins will be sent to the Queue.

  8. Click the Save Information button to apply the changes.

Example Event/Alert JSON Message

Below is an example of the JSON message format for Events and Alerts that will be sent to Amazon SQS:

{  
"distributorld": "27594",  
"distributorName": "Nayax Demo",  
"operatorld": "2000144542",  
"operatorName": "Daniel_OP",  
"actorld": "2000144542",  
"actorName": "Daniel_OP",  
"machineld": "697356467",  
"machineName": "EX PP Machine",  
"machineNumber": null,  
"machineSerial": null,  
"deviceld": "25795395",  
"deviceSerial": "0404041919567757",  
"eventSourceld": "6",  
"eventSourceName": "Device",  
"eventCode": "1",  
"eventName": "Power up",  
"eventData": "Device Serial #:0404041919567757\nDevice FW Version:4.0.0.5-rc3 - Jan 9 2019\nDevice Hardware:4.13\nVPOS\nSerial #:\nVPOS FW Version:2009-rc07\nMDB Max Response Time:7\nDevice MDB Level:1\nDecimal Place:2\nManufacturer\nCode:4805701\nMachine MDB Level:1\nModem IMEI: 357036091438914\nModem Model (HW Revision): UE910-EUD\nModem FW\nVersion:12.00.414\nModem Type:3G\nSIM Card Serial #:89462008002001388010\nSIM Card Mobile Number:NO CLIn\nMobile\nOperator Name:42501\nModem CDMA SN (MEID):\nLast Power Down time: 23/03/2020 14:27:30",  
"eventDateTimeGMT": "2020-03-23T14:11:35.980",  
"eventDateTimeVMC": "2020-03-23T17:11:35.980",  
"enc_ver": "1",  
"enc_key": "63562b7245cb478cb38a509ec764e012"  
}

JSON Message Fields Description

The following table describes the fields included in the Event/Alert JSON message:

Field NameTypeDescription
distributorIdstringUnique identifier for the distributor.
distributorNamestringName of the distributor.
operatorIdstringUnique identifier for the operator.
operatorNamestringName of the operator.
actorIdstringUnique identifier for the actor.
actorNamestringName of the actor.
machineIdstringUnique identifier for the machine.
machineNamestringName of the machine.
machineNumberstringInternal number assigned to the machine.
machineSerialstringSerial number of the machine.
deviceIdstringUnique identifier for the device.
deviceSerialstringSerial number of the device.
eventSourceIdstringUnique identifier for the event source.
eventSourceNamestringName of the event source.
eventCodestringCode associated with the event.
eventNamestringName of the event.
eventDatastringData associated with the event.
eventDateTimeGMTstringEvent date and time in GMT format.
eventDateTimeVMCstringEvent date and time as recorded by the machine.
enc_verstringEncryption version used for the data.
enc_keystringEncryption key used for securing the data.