Skip to main content

Documentation Index

Fetch the complete documentation index at: https://devzone.nayax.com/llms.txt

Use this file to discover all available pages before exploring further.

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:
NameTypeRequiredDescription
amountintegerYesThe exact amount to be charged (refer to decimalPlace).
channelsarrayNoDefines 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:
NameTypeDescription
transactionIdstringThe unique identifier for the completed transaction.
amountintegerThe final amount that was successfully charged.
statestringReturns SETTLED (or PAID) upon success.
cardBrandstringThe brand of the card used (e.g., VISA, MASTERCARD).
cardEntryModestringThe method used to read the card (e.g., CTLS).
maskedPanstringThe masked card number for receipts.
approvalCodestringThe bank-issued authorization code for the charge.