post https://api.nayax.com/sdk/validate-merchant
An initial call by Nayax to the Integrator to securely authenticate both Nayax and the 3rd party regarding a possible transaction. During this process, the integrator generates a Transaction ID ("Ecom Transaction ID") to be echoed in following calls.
Security Flow:
- Nayax and the integrator pre-share a Secret Token (e.g.,
mrV3U3nsgGFrE3w5-wnBo_WCLPce-pZ1awRvTVTkungMIKThTVbj_fiXdfoGclhn0
withToken ID: 116383
). - Nayax creates a 27-character Random String and sends it to the Integrator in the
StartAuthentication
request (e.g.,123456789qwertyuiopasdfghjk
). - The Integrator generates a 64-character Ciphertext with the structure
Ecom Transaction ID
||=
||Random String
(e.g.,12c7cec2-c690-4425-9a1f-db0db60e2d8c=123456789qwertyuiopasdfghjk
). - The Integrator produces an encryption key from the 32 rightmost characters of the Token (e.g.,
wRvTVTkungMIKThTVbj_fiXdfoGclhn0
). - The Integrator encrypts the Ciphertext using AES in ECB mode and sends the produced cipher in the
/validate-merchant
(StartAuthentication) Request. - Nayax decrypts the Cipher using the same key and performs validations on the
Random
andCipher Format
. - Nayax and the Integrator should send the Ecom Transaction ID (
12c7cec2-c690-4425-9a1f-db0db60e2d8c
) in all future API calls of the same transaction. - The Integrator shall validate that the Ecom Transaction ID sent from Nayax was generated by them in further API calls.