Skip to main content
The refund process begins by submitting a request with details such as the refund amount and reason. This notifies the customer that the refund is being processed. We will describe this process in more detail on this page.
Credit Cards OnlyRefunds can only be requested for transaction done through Credit Card. This option is not available for prepaid cards.
In Nayax Core, refunds can be requested through the Dynamic Transactions Monitor. Follow the steps below to do so.
  1. Access Reports > Online Reports > Dynamic Transactions Monitor.
  2. Search for the transaction to refund. You can use the filter feature to make this easier.
  3. Right-click the transaction you want to refund.
  4. Click Request Refund
  5. A pop-up window will appear. In it, choose if the refund is complete or partial and write the reason for the refund.
  6. Click Request Refund.

​
Lynx API

This process can be performed programmatically through the Lynx API. The following endpoint is used to process the refund.
Request a Payment Refund
POST
AuthenticationRefer to the Security & Token page of this documentation to learn how to access your tokens and how to properly use them to authenticate your API requests.

​
Initiating the request

To start the request, use the Request a Payment Refund endpoint to request a refund. Providing the attributes regarding the rebate in the body parameters of the request, as exemplified below:
Request
curl --request POST \
     --url https://qa-lynx.nayax.com/operational/v1/payment/refund-request \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "RefundAmount": 0,
  "RefundEmailList": "string",
  "RefundReason": "string",
  "TransactionId": 0,
  "SiteId": 0,
  "MachineAuTime": "2024-10-10T16:30:37.179Z"
}
'
Below, you can see a description of each of the parameters:
NameTypeDescription
RefundAmount`double \null`The amount to be refunded to the customer.
RefundEmailList`string \null`A list of email addresses to notify about the refund, separated by commas.
RefundReason`string \null`The reason for requesting the refund.
TransactionIdint64The unique identifier of the transaction for which the refund is requested.
SiteIdint32The unique identifier of the site where the transaction occurred.
MachineAuTimedate-timeThe machine’s authorization time is associated with the transaction.

​
How to obtain TransactionID and SiteID

The TransactionId and SiteId can be retrieved in the Lynx API using the Get Last Sales for Machine endpoint to retrieve the last sales using the MachineID and the response object should have the necessary data.

​
Request Status

Once you send the request, a notification email will be sent to the email address entered in the request parameters. The refund is now in the pending status and will need to be approved or declined. See Approve or Decline a Refund for more details.