Skip to main content
POST
/
Cortina
/
CreditCard
/
Refund
Cortina Credit Card Refund
curl --request POST \
  --url https://{domain}:{port}/api/Cortina/CreditCard/Refund \
  --header 'Content-Type: application/*+json' \
  --data '
{
  "ActorInfo": {
    "Country": {
      "Alpha2Code": "US",
      "Alpha3Code": "USA",
      "Name": "UNITED STATES",
      "NumericCode": "840"
    },
    "DynamicURL": "",
    "GeoLocation": {
      "Address": "River",
      "City": "Zambezi",
      "CountryCode": "ZM",
      "State": "State",
      "ZipCode": "234234"
    },
    "Id": 2001537302,
    "MerchantId": "999999888885",
    "Name": "TestPayCC V2 OP"
  },
  "BasicInfo": {
    "Amount": 3.9,
    "CurrencyCode": "ILS",
    "CurrencyNumeric": "376",
    "MachineAuTime": "201121220429",
    "NayaxTransactionId": 3584667527,
    "PaymentMethodID": 1,
    "SiteId": 1,
    "TimeoutMS": 15000,
    "TransactionId": "S9IUQSOA46Z7MHZ51JQXB20HWRKEDC1F9LLV"
  },
  "CardData": {
    "BrandInfo": {
      "PrimaryDescription": "MASTERCARD",
      "PrimaryId": "8",
      "SecondaryDescription": "",
      "SecondaryId": "0"
    },
    "CardHolderName": "Test Card Holder",
    "CardNumber": "****",
    "EntryMode": "MCR",
    "ExpMonth": "01",
    "ExpYear": "23"
  },
  "CustomData": {
    "Actor": "****",
    "Machine": "****"
  },
  "DeviceInfo": {
    "FWVersion": "",
    "HwSerial": ""
  },
  "MachineInfo": {
    "City": "Abbeville",
    "Country": {
      "Alpha2Code": "US",
      "Alpha3Code": "USA",
      "Name": "UNITED STATES",
      "NumericCode": "840"
    },
    "DecimalPlace": 2,
    "GeoLocation": {
      "Address": "River",
      "City": "Zambezi",
      "CountryCode": "ZM",
      "ZipCode": "234234"
    },
    "Id": 0,
    "Name": "Itai_TestPayCC V2",
    "Offset": "3.00",
    "TerminalId": "8888888844",
    "ZipCode": "54321"
  },
  "PaymentInfo": {
    "AuthAmount": 3.9,
    "AuthCode": "333333",
    "AuthDateTime": "201121220429",
    "AuthSource": "55555",
    "IsGatewayTimeout": false,
    "RRN": "111111",
    "SettAmount": 3.9,
    "SettDateTime": "11/20/2021 7",
    "SrvTranId": "S9IUQSOA46Z7MHZ51JQXB20HWRKEDC1F9LLV",
    "Token": "Cortina V2 Stub Tester Token",
    "TraceNumber": "4444"
  },
  "ReasonCode": 12,
  "ReasonText": "Cashless Refunded by Operator"
}
'
{
  "Status": {
    "Code": 0,
    "StatusMessage": "Cortina V2 Stub Tester",
    "Verdict": "Approved"
  }
}
Returns money to the customer after a transaction is complete. This endpoint processes a refund for a transaction that has already been settled (finalized). It sends funds back to the cardholder, logging the reason for the refund and updating the batch status.

Body

ActorInfo
object

Merchant (Actor) details.

BasicInfo
object

Basic transaction information.

CardData
object

Additional data we read from the card (EMV data, expiration date, cvv2, etc.)

CustomData
object

Custom Fields Information, Contact Nayax TPOC to define.

DeviceInfo
object

Hardware and firmware information of the Nayax device.

EncryptInfo
object

Contains encryption metadata used for secure transmission.

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>
ReasonText
string

Response

Success

Batch
object
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