Skip to main content
POST
/
Cortina
/
DynamicQR
/
Refund
Cortina DynamicQR Refund
curl --request POST \
  --url https://{domain}:{port}/api/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
  },
  "BasicInfo": {
    "Amount": 5,
    "CurrencyCode": "ILS",
    "CurrencyNumeric": "376",
    "TransactionId": "N99O4XURDQYJZIK4OTCAWF1RHHA40TZWVCRB",
    "AgeLimitation": 18,
    "AuditNumber": 342,
    "BillingProviderId": 1,
    "IsDeferredAuthorization": true,
    "IsProductSelected": true,
    "IsSoftDeclineCompletion": true,
    "MachineAuTime": 71221132914,
    "NayaxRRN": "111111",
    "NayaxTransactionId": 3584697384,
    "PaymentMethodID": 1,
    "SiteId": 1,
    "TimeoutMS": 15000,
    "TransitElement": {
      "DenyListIndication": 0,
      "TransitTransactionType": 1
    }
  },
  "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": "<string>",
    "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