No results

Verify PARes

As part of the flow for Server-to-Server payments, this is the servlet exposed to validate the PARes message validation and return the 3D Secure parameters associated to the payment signature; it receives in input the PARes message, returned by the ACS and containing the authentication outcome, and returns in output their decrypted and simplified versions.

Example of request
id=99999999&password=99999999&tenantId=10&operationtype=verifypares&paymentid=298597096655040209 &pares=eJydWFmzosqyfudXdKzzSPRmVGGHvU4UMyoIMolvTDKDCgry60+pPazdu(...)

Request parameters

NAME DESCRIPTION FORMAT
id Id associated with terminal N
Max. length: 8
password Terminal id password AN
Max. length: 50
tenantId Identification code of the acquiring service to which the merchant belongs. In the case of a merchant having an agreement with Intesa enter "10", otherwise enter "20". N
paymentid Id associated to the payment session AN
Max. length: 18
operationType 'verifypares' AN
Max. length: 50
PaRes Encrypted message obtained in response by the authentication system of the card issuer (ACS) AN
Example of response

Response parameters

NAME DESCRIPTION FORMAT
paymentid Id associated to the payment session AN
Max. length: 18
cavv Payment signature AN
Max. length: 255
cavvalgo Cavv encryption algorithm AN
Max. length: 2
eci Electronic Commerce Indicator: security level indicator of the transaction AN
Max. length: 2
merchantacquirerbin Acquirer Identification Code AN
Max. length: 6
currency Currency, 978 for Euro AN
Max. length: 3
xid Purchase date (yyyymmdd hh:mm:ss) AN
Max. length: 255
purchasedate Purchase date (yyyymmdd hh:mm:ss) AN
purchaseamount Amount N
exponent Number of decimal numbers N
Max. length: 1
time Timestamp (yyyymmdd hh:mm:ss) AN
status Authentication outcome:
  • Y = authentication successfully completed
  • N = authentication failed
  • A = Enrollment during payment
  • U = technical problem during authentication
 AN
Max. length: 1
pan Masked PAN AN
Max. length: 19
vendorcode Vendor MPI identification code AN
Max. length: 255
version Version of 3D Secure protocol AN
Max. length: 10

Expected behaviour depending on the authentication outcome

Status Pares Required action
Y Authorisation request in 3D (Full Secure) mode
N Abort payment
A Authorisation request in 3D (Half Secure) mode
U Authorisation request in NO 3D (eci 07) mode