Skip to main content
Cortina DynamicQR Refund
curl --request POST \
  --url https://{domain}:{port}/Cortina/DynamicQR/Refund \
  --header 'Content-Type: application/*+json' \
  --data '
{
  "ActorInfo": {
    "Country": {
      "Alpha2Code": "US",
      "Alpha3Code": "USA",
      "Intra": "Europe",
      "Name": "UNITED STATES",
      "NumericCode": "840"
    },
    "DynamicURL": "https://www.nayax.com/alternativeURL",
    "GeoLocation": {
      "Address": "River",
      "City": "Zambezi",
      "CountryCode": "ZM",
      "Latitude": 51.0003431,
      "Longitude": 23.745245,
      "State": "Alabama",
      "ZipCode": "234234"
    },
    "Id": 2001537302,
    "MCC": 455,
    "MerchantId": 999999888885,
    "Name": "TestPayCC V2 OP",
    "OperatorId": 2001537302,
    "OperatorName": "TestPayCC V2 OP _ Sub Merchant",
    "SubMerchantId": 999999888886
  },
  "CustomData": {
    "Actor": "String",
    "DirectActor": "String",
    "Distributor": "String",
    "Machine": "String",
    "Operator": "String",
    "SoftDecline": "String"
  },
  "DeviceInfo": {
    "FWVersion": "4.0.0.22-RC01 - Aug 25 2021",
    "HwSerial": 434324119376526,
    "Type": "Onyx"
  },
  "MachineInfo": {
    "City": "Abbeville",
    "Country": {
      "Alpha2Code": "US",
      "Alpha3Code": "USA",
      "Intra": "Europe",
      "Name": "UNITED STATES",
      "NumericCode": "840"
    },
    "DecimalPlace": 2,
    "ExternalId": "OperatorExternalID",
    "GeoLocation": {
      "Address": "River",
      "City": "Zambezi",
      "CountryCode": "ZM",
      "Latitude": 51.0003431,
      "Longitude": 23.745245,
      "State": "Alabama",
      "ZipCode": "234234"
    },
    "GroupId": "String",
    "Id": 106791869,
    "Name": "Itai_TestPayCC V2",
    "Offset": "3.00",
    "OperatorId": 2001537302,
    "Region": "EU",
    "TerminalId": "8888888844",
    "Type": "machine type",
    "ZipCode": "22448Z"
  },
  "PaymentInfo": {
    "SrvTranId": "3584697388",
    "AuthCode": "333333",
    "AuthAmount": 5.5,
    "SettAmount": 5.5,
    "RRN": "111111",
    "Token": "string",
    "AuthDateTime": "071221133300",
    "SettDateTime": "071221133330",
    "TraceNumber": "4444",
    "AdditionalData": "string",
    "IsGatewayTimeout": false,
    "ProviderExternalData": "string",
    "InitiateTranReference": 11223344,
    "IsRevalueCard": false
  },
  "ReasonCode": 123,
  "ReasonText": "<string>"
}
'
{
  "PaymentInfo": {
    "SrvTranId": "3584697388",
    "AuthCode": "333333",
    "AuthAmount": 5.5,
    "SettAmount": 5.5,
    "RRN": "111111",
    "Token": "string",
    "AuthDateTime": "071221133300",
    "SettDateTime": "071221133330",
    "TraceNumber": "4444",
    "AdditionalData": "string",
    "IsGatewayTimeout": false,
    "ProviderExternalData": "string",
    "InitiateTranReference": 11223344,
    "IsRevalueCard": false
  },
  "Status": {
    "Code": 123,
    "CustomDeclineCode": 123,
    "StatusMessage": "<string>",
    "Verdict": "<string>"
  }
}
Returns a full or partial refund for a completed QR payment. This endpoint sends money back to the customer after a transaction completes successfully. It is typically triggered by a customer complaint (via the Nayax web system) and allows for specific refund reasons to be recorded.

Body

​
ActorInfo
object

Merchant (Actor) details.

​
BasicInfo
object

Basic transaction information.

​
CustomData
object

Custom Fields Information, Contact Nayax TPOC to define.

​
DeviceInfo
object

Hardware and firmware information of the Nayax device.

​
MachineInfo
object

Information about the machine involved in the transaction.

​
PaymentInfo
object

Identifies transaction information and references. Included in all response messages for payment calls. When used in requests (e.g. /Settlement, /Void, /Refund, /Inquiry), this object should match the PaymentInfo returned in a previous call.

​
ReasonCode
integer<int16>
  • Optional
  • length: Short integer (16)
  • Refund reason code as saved in Nayax system
​
ReasonText
string
  • Optional
  • length: 64
  • Refund description as saved in Nayax system

Response

Success

​
PaymentInfo
object

Identifies transaction information and references. Included in all response messages for payment calls. When used in requests (e.g. /Settlement, /Void, /Refund, /Inquiry), this object should match the PaymentInfo returned in a previous call.

​
Status
object

Transaction status