Skip to main content
POST
/
Cortina
/
CreditCard
/
Authorization
Cortina Credit Card Authorization
curl --request POST \
  --url https://{domain}:{port}/api/Cortina/CreditCard/Authorization \
  --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": 5,
    "CurrencyCode": "ILS",
    "CurrencyNumeric": "376",
    "MachineAuTime": 71221132914,
    "NayaxTransactionId": 3584697384,
    "PaymentMethodID": 1,
    "SiteId": 1,
    "TimeoutMS": 15000,
    "TransactionId": "N99O4XURDQYJZIK4OTCAWF1RHHA40TZWVCRB"
  },
  "CardData": {
    "BrandInfo": {
      "PrimaryDescription": "VISA",
      "PrimaryId": "6",
      "SecondaryDescription": "",
      "SecondaryId": "0"
    },
    "CardHolderName": "Test Card Holder",
    "CardNumber": "****",
    "EMVData": "xxxxxxxx",
    "EntryMode": "CON",
    "ExpMonth": "12",
    "ExpYear": "22"
  },
  "CustomData": {
    "Actor": "****",
    "Machine": "****"
  },
  "DeviceInfo": {
    "FWVersion": "4.0.0.22-RC01 - Aug 25 2021",
    "HwSerial": 434324119376526
  },
  "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": 106791869,
    "Name": "Itai_TestPayCC V2",
    "Offset": "3.00",
    "TerminalId": "8888888844",
    "ZipCode": ""
  }
}
'
{
  "ECom3DSResponseInfo": {
    "ECom3DSRedirectUrl": "https://the-verigication-example-url.com",
    "ECom3DSStatus": 2
  },
  "EMVTags": {
    "Tag71": "860D8424000008D466284E10D1FF7C",
    "Tag72": "860D8424000008D466284E10D1FF7C",
    "Tag8A": "3030",
    "Tag91": "A93381BFF8C5E9EC0012"
  },
  "PaymentInfo": {
    "AdditionalData": "",
    "AuthAmount": 5,
    "AuthCode": "333333",
    "AuthDateTime": 71221132914,
    "AuthSource": "555555",
    "RRN": "111111",
    "SettAmount": 5,
    "SettDateTime": "12/7/2021 10:29:16 AM",
    "SrvTranId": "222222",
    "Token": "Cortina V2 Stub Tester Token",
    "TraceNumber": "4444"
  },
  "Status": {
    "Code": 0,
    "StatusMessage": "Cortina V2 Stub Tester",
    "Verdict": "Approved"
  }
}
Initiates a credit card pre-authorization transaction. This POST endpoint verifies the card’s validity and available balance while handling security protocols like EMV, DUKPT, and 3-D Secure (SCA). It returns an authorization verdict, issuer authentication data (EMV tags), or a redirection URL if further user authentication is required.

Body

application/json
​
BasicInfo
object

Basic transaction information.

​
DeviceInfo
object

Hardware and firmware information of the Nayax device.

​
MachineInfo
object

Information about the machine involved in the transaction.

​
ActorInfo
object

Merchant (Actor) details.

​
CustomData
object

Custom Fields Information, Contact Nayax TPOC to define.

​
CardData
object

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

​
Products
object[]
​
ECom3DSInfo
object

Contains 3-D Secure (3DS) data used for Strong Customer Authentication (SCA) in electronic commerce transactions.

​
DukptInfo
object

Contains encryption details using the DUKPT (Derived Unique Key Per Transaction) method.

​
EncryptInfo
object

Contains encryption metadata used for secure transmission.

Response

200 - text/json

Success

​
ECom3DSResponseInfo
object
​
EMVTags
object

Response EMV tags, Mandatory for Contact.

​
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