On This Page
REST API

PARes Element

The
PARes
 element contains the payer authentication response.
<PARes>
  (AcqBIN)
  (MerID)
  (XID)
  (Date)
  (PurchaseAmount)
  (PAN)
  (AuthDate)
  (Status)
  (CAVV)
  (ECI)
</PARes>
Child Elements of PARes
Element Name
Description
Type & Length
AcqBIN
First six digits of the acquiring bank’s identification number.
Numeric (6)
MerID
Identifier provided by your acquirer; used to log in to the ACS URL.
String (24)
XID
XID value returned in the customer authentication response. This element corresponds to the
consumerAuthenticationInformation.xid
 and
consumerAuthenticationInformation.xid
 API fields.
String (28)
Date
Date and time of request.
(Although the date and time should appear sequentially during all stages of the processing of an order, they might not because of differing time zones and synchronization between servers.)
DateTime (25)
PurchaseAmount
Authorization amount and currency for the transaction. This element corresponds to the totals of the offer lines or from:
orderInformation.amountDetails.totalAmount
Amount (15)
PAN
Customer’s masked account number. This element corresponds to the
consumerAuthenticationInformation. proxyPan
 API field.
String (19)
AuthDate
Date and time of request.
(Although the date and time should appear sequentially during all stages of the processing of an order, they may not because of differing time zones and synchronization between servers.)
DateTime (25)
Status
Result of the authentication check. This field can contain one of these values:
  • Y
    : Customer was successfully authenticated.
  • N
    : Customer failed or cancelled authentication. Transaction denied.
  • U
    : Authenticate not completed regardless of the reason.
  • A
    : Proof of authentication attempt was generated.
String (1)
CAVV
CAVV (Visa, American Express, JCB, Diners Club, Discover, China UnionPay, and Elo) cards = * below) or AAV (Mastercard, and Maestro cards = ** below) returned in the customer authentication response. This element corresponds to the
consumerAuthenticationInformation.cavv
 and
consumerAuthenticationInformation.ucaf AuthenticationData
 API fields.
String (50)
ECI
Electronic Commerce Indicator returned in the customer authentication response. This element corresponds to the
consumerAuthenticationInformation.eci
 and
consumerAuthenticationInformation.ucaf CollectionIndicator
 API fields.
Numeric (1)
PARes Element
<PARes>
  <AcqBIN>123456</AcqBIN>
  <MerID>4444444</MerID>
  <XID>Xe5DcjrqEdyC37MOPfIzMwAHBwE=</XID>
  <Date>2020-02-09T07:59:46-08:00</Date>
  <PurchaseAmount>1002.00 USD</PurchaseAmount>
  <PAN>0000000000000771</PAN>
  <AuthDate>2020-02-09T07:59:46-08:00</AuthDate>
  <Status>Y</Status>
  <CAVV>AAAAAAAAAAAAAAAAAAAAAAAAAAA=</CAVV>
  <ECI>5</ECI>
</PARes>