Prepaid card- Authorization- WIP!

The terminal uses the Authorization command to notify the integrator about the result of a card tap in order to initiate the authorization process with the Cortina payment provider.

This command is essential for proceeding to transaction confirmation or rejection handling.

Request

Nayax's servers send a POST request to your configured Authoirzation endpoint, which would be of the following format:

(customer's URL)/Cortina/PrePaid/Authorization

The payload includes the full result of the card scan operation:

{
"BasicInfo": {
"TransactionId": "N99O4XURDQYJZIK4OTCAWF1RHHA40TZWVCRB",
"NayaxTransactionId": 3584697384,
"Amount": 5,
"CurrencyCode": "ILS",
"CurrencyNumeric": "376",
"SiteId": 1,
"MachineAuTime": "071221132914",
"TimeoutMS": 15000,
"IsProductSelected": true,
"PaymentMethodID": 1,
"BillingProviderId": 1,
"AuditNumber": 342,
"NayaxRRN": "111111",
"IsDeferredAuthorization": true,
"AgeLimitation": 18,
"IsSoftDeclineCompletion": true,
"TransitElement": {}
},
"DeviceInfo": {
"HwSerial": "0434324119376526",
"FWVersion": "4.0.0.22-RC01 - Aug 25 2021",
"Type": "Onyx"
},
"MachineInfo": {
"Id": 106791869,
"Name": "Itai_TestPayCC V2",
"ExternalId": "OperatorExternalID",
"Type": "machine type",
"TerminalId": "8888888844",
"DecimalPlace": 2,
"Offset": "3.00",
"GroupId": "String",
"OperatorId": 2001537302,
"Region": "EU",
"City": "Abbeville",
"ZipCode": "22448Z",
"Country": {},
"GeoLocation": {}
},
"ActorInfo": {
"Id": 2001537302,
"Name": "TestPayCC V2 OP",
"OperatorId": 2001537302,
"OperatorName": "TestPayCC V2 OP _ Sub Merchant",
"MerchantId": 999999888885,
"DynamicURL": "https://www.nayax.com/alternativeURL",
"Country": {},
"GeoLocation": {},
"MCC": 455,
"SubMerchantId": 999999888886
},
"CustomData": {
"DirectActor": "String",
"Operator": "String",
"Distributor": "String",
"Actor": "String",
"Machine": "String",
"SoftDecline": "String"
},
"CardData": {
"CardNumber": "****",
"EntryMode": "MCR",
"ExpYear": "23",
"ExpMonth": "01",
"EMVData": "string",
"CVV2": "****",
"IDNumber": "****",
"RandomNumber": "string",
"BrandInfo": {},
"CardHolderName": "Test Card Holder",
"IsDebitCard": true
},
"PaymentInfo": {
"SrvTranId": "3584697388",
"AuthCode": "333333",
"AuthAmount": 5.5,
"SettAmount": 5.5,
"RRN": "111111",
"Token": "string",
"AuthDateTime": "071221133300",
"SettDateTime": "071221133330",
"TraceNumber": "4444",
"AuthSource": "string",
"AdditionalData": "string",
"IsGatewayTimeout": false,
"ProviderExternalData": "string",
"InitiateTranReference": 11223344,
"IsRevalueCard": false
}
}

Request Parameters- WIP!!!

The table below describes all the parameters of the request:

Field	Type	Required	Description
`NayaxTransactionId`	Integer	Yes	Internal Nayax transaction ID.
`SparkTransactionId`	String	Yes	Unique session ID generated in `StartAuthentication`.
`SiteId`	Integer	Yes	ID of the vending site or Spark location.
`TerminalId`	String	Yes	Unique ID of the terminal that read the card.
`MachineId`	Integer	Yes	Identifier of the vending machine or device.
`HwSerial`	String	Yes	Hardware serial number of the terminal.
`AuthStatus`	Object	Yes	Card authorization result.
`AuthStatus.Verdict`	String	Yes	Authorization decision (`Approved`, `Declined`, etc.).
`AuthStatus.ErrorCode`	Integer	No	An optional error code if the card was declined.
`AuthStatus.ErrorDescription`	String	No	Explanation of the error, if any.
`AuthStatus.StatusMessage`	String	No	Status message returned by Spark.
`CardLast4Digits`	String	Yes	The last four digits of the presented card.
`CardHash`	String	Yes	One-way hash of the full card number.
`CardUid`	String	Yes	UID of the card (for prepaid cards). See a more detailed explanation on the SMC Support page.
`MachineAuTime`	String	Yes	Timestamp from the machine in the format `yyyyMMddHHmmssSSS`.
`Amount`	Integer	Yes	Transaction amount in the smallest currency unit (e.g., cents)
`CardBrand`	String	No	Card brand used (e.g., Visa, MasterCard).
`CardFirst6Digits`	String	No	The first 6 digits of the credit card (card BIN).
`AuthCode`	String	No	Authorization code returned by the payment provider.
`AuTime`	String	No	Authorization server timestamp.
`CurrencyCode`	String	No	ISO currency code (e.g., "EUR").
`CurrencyNumeric`	String	No	ISO 4217 numeric code (e.g., "978").
`FiscalRrn`	String	No	Fiscal reference number for accounting/reporting.
`NayaxRRN`	String	No	Internal Nayax settlement reference number.

Response

WIP!