Refund

The unique identifier for this transaction.

• Echoes the encrypted ID from /StartSession if used.
• Otherwise, the Nayax Engine generates this value.

The Nayax internal unique ID for the transaction, echoed in further requests.

The Integrator's internal transaction ID.

• Conditional: Required if /StartSession was not used.
• If used, it should be empty or echo the Transaction ID.

Reference Retrieval Number (RRN). Recommended to be visible to the consumer/card holder for support.

External Authorization Code (usually from the Card Issuer's bank).

A unique token for the transaction. For Nayax internal use only.

Trace number. For Nayax internal use only.

For Nayax internal use only.

Conditional: Reflects the original Nayax Transaction ID for prepaid loyalty card re-attempts. Provided as a String in JSON format.

The payment amount (Decimal with max 3 digits for cents).

• Example: 1 cent = 0.01.
• Note: Currencies with no decimal places are still represented as a double (e.g., 234 JYN = 234.0).

The original amount requested in the /Authorization request. Conditional on /Authorization response.

The original amount requested in the /Settlement or /Sale process. Irrelevant for the Authorization command.

The date and time the /Authorization took place. Format:ddMMyyHHmmss.

The Settlement Date/Time. Irrelevant for the Authorization command.

Currency code in ISO 4217 Alpha-3 format.

Currency code in ISO 4217 Numeric-3 format.

Card details provided based on transaction type:

• Full Track 2 for card-present Authorization/Sale.
• Card PAN only for other transaction types.

How the card details were read:

• MCR: Magnetic Stripe Read (swipe)
• CON: Contact Chip (insert)
• CLS: Contactless Chip (tap)
• NFC: Phone/Mobile contactless
• QR: QR code read by DOT
• Consult Nayax POC for specific edge cases.

Card expiration year (YY format). Conditional (only when Interface is 1 or 10).

Card expiration month (MM format). Conditional (only when Interface is 1 or 10).

EMV tags data in TLV (Tag-Length-Value) format.

Cardholder ID Number.

Further information is unavailable.

Primary Brand ID.

Primary Brand Description.

Secondary Brand ID.

Secondary Brand Description.

Card Holder Name.

Indication if card is allowed revalue.

Indicates if a gateway timeout occurred (valid in the response).

Additional data string in JSON format. Contact Nayax TPOC to define.

External data from the provider in JSON format string.

The final status of the request. Must be one of the constant string values:

• Approved
• Declined

The Decline Code. Conditional—only present if Verdict is 'Declined'. Valid codes include:

• 1: Insufficient funds
• 5: Suspected Fraud
• 6: General system failure
• 7: Invalid amount
• 8 / 998: Format/parsing error or Validation error
• 992: Timeout exception
• 997: Missing mandatory parameters
• 999: General exception
• See full list for other status and internal errors.

A free text field containing the transaction status message or additional varying data regarding the outcome.

Used for specifying a custom decline code (e.g., related to Soft Decline or Switch Interface). May reflect the acquirer's response code.

The original amount requested in the /GenerateQR request.

The original amount requested in /Settlement or /Sale process. Conditional on /Inquiry request.

The date and time the /Authorization or /Sale took place. Format:ddMMyyHHmmss.

The date and time the /Settlement or /Sale took place. Format:ddMMyyHHmmss.

The Integrator's internal transaction ID.

• Conditional: Required if /StartSession was not used.
• If used, it should be empty or echo the Transaction ID.

External Authorization Code (usually from the Card Issuer's bank).

Reference Retrieval Number (RRN).

• Used as External Transaction ID for external parties (e.g., Card schemes).
• Highly recommended to be visible to the consumer/card holder for support.
• Note: The RRN must match the preceding value sent in the /GenerateQR response for an /Inquiry request.

A unique token for the transaction. For Nayax internal use only.

Trace number. For Nayax internal use only.

For Nayax internal use only.

Conditional: Reflects the original Nayax Transaction ID for prepaid loyalty card re-attempts.

Defines the unit of measure for RegularCredit (Enum values):

• 0: Credit is counted in transactions (count).
• 1: Credit is counted as an amount (currency).

The regular credit value (amount or transaction count) based on the RegularCreditType. Uses Decimal place 2.

The revalue credit amount. Only present if the associated card is configured as revalue-able.

Indication if card is allowed revalue.

Indicates if a gateway timeout occurred (valid in the response).

External data from the provider in JSON format string.

Additional data string in JSON format.