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_fiXdfoGclhn0withToken ID: 116383). - Nayax creates a 27-character Random String and sends it to the Integrator in the
StartAuthenticationrequest (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
RandomandCipher 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.