pay - Nayax Developer Portal

The pay method initiates an immediate transaction where detection, authorization, and settlement occur in one continuous flow. Unlike the two-phase fuel workflow, this serves fixed-price sales or “Pay-Inside” scenarios where the final amount is known before the card is presented. Use this method to:

Facilitate instant fulfillment for car washes, vacuum stations, or kiosk items where the price remains fixed.
Simplify integration by removing the need for a separate settlement call.
Increase throughput in high-traffic environments where users pay a set fee and move on quickly.

Requests

All requests must include the command, requestId, and the exact amount to be charged. The terminal will activate the reader and wait for the customer to present their payment method. The following example shows a typical request:

{
"command": "pay",
"requestId": "req-001",
"data": {
"channels": ["CTLS", "CHIP", "SWIPE"],
"amount": 5000,
"volume": 30000,
"product": "Diesel"
}
}

Parameter definitions

The table below describes the parameters available for this request:

Name	Type	Required	Description
amount	integer	Yes	The exact amount to be charged (refer to `decimalPlace`).
channels	array	No	Defines allowed payment methods: `CTLS`, `CHIP`, `SWIPE`, or `QR`. Defaults to all if omitted.

Responses

The terminal returns a response only after the payment has been fully authorized and captured by the gateway. The following example shows a typical response:

{
"requestId": "req-001",
"data": {
"transactionId": "TXN-20260113-001234",
"state": "SETTLED",
"amount": 5000,
"cardBrand": "VISA",
"cardEntryMode": "CTLS",
"maskedPan": "************1234",
"aid": "A0000000031010",
"timeStamp": "2026-01-13T14:30:05Z"
}
}

Response parameters

Below are the parameters returned in the data object upon a successful payment:

Name	Type	Description
transactionId	string	The unique identifier for the completed transaction.
amount	integer	The final amount that was successfully charged.
state	string	Returns `SETTLED` (or `PAID`) upon success.
cardBrand	string	The brand of the card used (e.g., VISA, MASTERCARD).
cardEntryMode	string	The method used to read the card (e.g., CTLS).
maskedPan	string	The masked card number for receipts.
approvalCode	string	The bank-issued authorization code for the charge.