Skip to main content

Authorizations

Authorization
string
header
required

JWT RSA token required for authentication. The token should be included in the Authorization header as Bearer <token>. Nayax will issue tokens to the VAS, signed by a private key, and decrypt them using a public key.

Body

application/json

Request to charge a saved token for a payment.

Request body for processing a transaction (charge token, close transaction).

basicInfo
object

Basic transaction details.

machineInfo
object

Information about the machine/terminal.

validationKey
string | null

Validation key from the authentication flow.

Example:

"AUTH_KEY_FROM_VALIDATE"

cardHolderInfo
object

Cardholder details.

additionalInfo
object

Additional information for the transaction and receipt.

originalTransactionId
integer<int32>

Required for second-step transactions (e.g., refund, void). The original Nayax transaction ID.

Example:

123456

paymentInfo
object

Payment-related information.

Response

Success

Response body for a transaction (charge token, close transaction).

status
object

Transaction status.

basicInfo
object

Basic information about the transaction, including amount, currency, and merchant request ID.

paymentInfo
object

Payment-related information, including Nayax token ID if applicable.