FAQ

What are the endpoints for each of the commands?

Each method would have its own endpoint, based on the URL provided to Nayax. StartSession and SaleEndNotification being of the format of: (customer's URL)/Cortina/StartSession (customer's URL)/Cortina/SaleEndNotification

Whereas the rest of the commands would be of the following format (include the integration type): (customer's URL)/Cortina/StaticQR/Authorization (customer's URL)/Cortina/StaticQR/Settlement (customer's URL)/Cortina/StaticQR/Cancel

(customer's URL)/Cortina/StaticQR/Sale (customer's URL)/Cortina/StaticQR/Void

How do I use the QR sticker which comes with the device to wake up the machine (instead of the device's SN)?

You need to first connect the sticker to your device via the MOMA app. A video of how to do that:

https://www.youtube.com/watch?v=DLaMQ-x-ra8

Once you've done that, the URL which you'd scan would be linked to your device- meaning you'd see the smart sticker ID (the number that's written bellow the QR ) on the device's virtual machine and our servers would know to match the scanned URL to the virtual machine with the corresponding number.

In the example above, the smart sticker ID is 907531, and when I hover my phone over the QR I get the URL of: https://preview.page.link/m.monyx.com/?link=https://m.monyx.com/?data%3D1;https://qr.nayax.com/v1/rWg_p6pZh1pwjvbkGrmBLy3KgwSz3dq-y63r5FPxk2NOWw2&apn=com.monyx.wallet&isi=1455956409&ibi=com.monyx.wallet

• Note: you need to use only the part which starts with http://qr.nayax.com/v1/x (until the "&"), meaning in my case I'd use https://qr.nayax.com/v1/rWg_p6pZh1pwjvbkGrmBLy3KgwSz3dq-y63r5FPxk2NOWw2

You would use "UniQR" field instead of "TerminalID", and insert the value of the QR code (NOT the number written on it) as the value of it:

Creating QRs of your own

If you'd like to use another QR code of your own (not use the Monyx one) we can generate a list of HASH codes (one for each machine) and when you create your QR you'd use your desired link and add

/{hashCode}

At the end. That would connect your link to the machine and will allow you to go through your app. The HASH details we'd provide you would look something like the following:

What you need to do is to create a QR based on this URL, and attach the original QR provided to you to the virtual machine via the MOMA app:

You'd need to go to the MOMA App and through Actions>attach a sticker>scan the desired QR. Once you'd do that the "UniQRNumber" would appear on your virtual machine's "Smart Sticker ID":

Now you can use the:

/{hashCode}

At the end of the QR's in order to create your own QR. This has would need to be at the end of your desired URL and you'd need to make a match between the hash to the "UniQRNumber" and send the "Start Session" with the UniQR.

Example

Let's say that I've got a customer who is named "MagicQR" and they want to generate their own QR code and have it be able to trigger their app, and they've got this UniQRNumber and UniQRCode:

They would need to first link the UniQRCode to the MoMa app as mentioned above (in order to get the UniQRNumber to be linked to the desired virtual machine) in order to link the hash. After the link was made, they would use the same hash in their own URL: https://MagicQR.com/IzwdM76Sh3kIw9pCXk8SOsE3WcLO6jrslw_eeT4yn3gUjg2

This would mean that once a consumer has scanned this URL and MagicQR is ready to direct them for payment- they would need to take the hash at the end of the URL and revert it back to the UniQRCode provided by Nayax, and then have "StartSession" include the URL in the "UniQR" field:

Whitelisting of Nayax's Ips

IPs for you to whitelist on your end (Nayax's servers)- there are 2 options which are essentially the same (option 1 includes all of the addresses of option 2- option 2 just includes more options for subnet)

Option 1 (all range):
185.159.232.0/22
Option 2 (IPs of each server):

IL - 185.159.232.0/24

DE - 185.159.234.0/24

US - 185.159.233.0/24

Remote Vend

Pulse machine

Starting which firmware is it supported?

4.0.10.23

What is the format of the call?

Cortina V1/V2:

{

"AppUserId":"260760",

"TerminalId":"0456789456789456",

"TransactionId":"12345129",

"SecretToken":"r3fcOqgODDqYgkJbSU-Vxw0MkZM1XjHvbQeSTnHmhwltUM_5kB-ZSgofkCxNk3ZN0",

"Products":

[
 {
      
 "PulseLineNumber":2

 }

 ]

}

Not Pulse (MDB, Marshall etc.)

What is the format of the call?

Cortina V1 (relevant for old integrations only):

{

"AppUserId":"260760",

"TerminalId":"0456789456789456",

"TransactionId":"12345129",

"SecretToken":"r3fcOqgODDqYgkJbSU-Vxw0MkZM1XjHvbQeSTnHmhwltUM_5kB-ZSgofkCxNk3ZN0",

"Products":

[
 {
      
 "ProductCode":2

 }

 ]

}

Cortina V2:

{

"AppUserId":"260760",

"TerminalId":"0456789456789456",

"TransactionId":"12345129",

"SecretToken":"r3fcOqgODDqYgkJbSU-Vxw0MkZM1XjHvbQeSTnHmhwltUM_5kB-ZSgofkCxNk3ZN0",

"Products":

[
 {
      
 "Code":2

 }

 ]

}