Payer Authentication Detail Report

This section describes the elements of the Payer Authentication Detail report. Refer to the Business Center Reporting User Guide
for instructions for downloading the report and additional report information. For more information about the

Report Element

The

Report

element is the root element of the report.

      

  (PayerAuthDetail+)

Child Elements of Report
Element Name	Description
PayerAuthDetail	Contains the transaction in the report. For a list of child elements, see .

PayerAuthDetails Element

    

      https://api.cybersource.com
      /reporting/v3/dtds/padr">

  
    ...

PayerAuthDetail Element

The

PayerAuthDetail

element contains information about a single transaction.

    
  (RequestID)
  (MerchantID)
  (RequestDate)
  (TransactionType)
  (ProofXML)?
  (VEReq)?
  (VERes)?
  (PAReq)?
  (PARes)?
  (AuthInfo)?

Child Elements of PayerAuthDetail
Element Name	Description	Type & Length
RequestID	Unique identifier generated for the transaction. This field corresponds to the API field.	Numeric (26)
MerchantID	Merchant ID used for the transaction.	String (30)
RequestDate	Date on which the transaction was processed.	DateTime (25)
ProofXML	Data that includes the date and time of the enrollment check and the VEReq and VERes elements. This field corresponds to the consumerAuthenticationInformation.Auth EnrollReply_proofXML API field. For a list of child elements, see .	String (1024)
VEReq	Verify Enrollment Request (VEReq) is sent by the merchant’s server to the directory server. The directory server also sends it to the ACS to determine whether authentication is available for the customer’s card number. For a list of child elements, see .
VERes	Verify Enrollment Response (VERes) is sent by the directory server. For a list of child elements, see .
PAReq	Payer Authentication Request message that you send to the ACS through the payment card company. Corresponds to the consumerAuthenticationInformation.payer AuthEnrollReply_paReq API field. For a list of child elements, see .
PARes	Payer Authentication Response message sent by the ACS. For a list of child elements, see .
AuthInfo	Address and card verification data. For a list of child elements, see AuthInfo Element.

PayerAuthDetail Element

    
  0004223530000167905139
  example_merchant
  2020-02-09T08:00:09-08:00
  ics_pa_enroll
  
    ...
  
  
    ...
  
  
    ...
  
  
    ...
  
  
    ...

ProofXML Element

The

ProofXML

element contains data that includes the date and time of the enrollment check and the VEReq and VERes elements. This element corresponds to the

consumerAuthenticationInformation.proofXml

API field.

    
  (Date)
  (DSURL)
  (PAN)
  (AcqBIN)
  (MerID)
  (Password)
  (Enrolled)

Child Elements of ProofXML
Element Name	Description	Type & Length
Date	Date when the proof XML is generated. (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)
DSURL	URL for the directory server where the proof XML originated.	String (50)
PAN	Customer’s masked account number. This element corresponds to the consumerAuthenticationInformation.payer AuthEnrollReply_proxyPAN API field.	String (19)
AcqBIN	First six digits of the acquiring bank’s identification number.	Numeric (6)
MerID	Identifier provided by your acquirer; used to login to the ACS URL.	String (24)
Password	Merchant's masked authentication password to the ACS; provided by your acquirer. Applies only to cards issued outside the U.S.	String (8)
Enrolled	Result of the enrollment check. This field can contain one of these values: Y : Authentication available. N : Cardholder not participating. U : Unable to authenticate regardless of the reason.	String (1)

ProofXML Element

    
  20200209 08:00:34
  https:123.456.789.01:234/DSMsgServlet
  XXXXXXXXXXXX0771
  123456
  4444444
  
  Y>

VEReq Element

The

VEReq

element contains the enrollment check request data.

    
  (PAN)
  (AcqBIN)
  (MerID)

Child Elements of VEReq
Element Name	Description	Type & Length
PAN	Customer’s masked account number. This element corresponds to the consumerAuthenticationInformation. proxyPan API field.	String (19)
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)

VEReq Element

    
  XXXXXXXXXXXX0771
  123456
  example

VERes Element

The

VERes

element contains the enrollment check response data.

    
  (Enrolled)
  (AcctID)
  (URL)

Child Elements of VERes
Element Name	Description	Type & Length
Enrolled	Result of the enrollment check. This field can contain one of these values: Y : Authentication available. N : Cardholder not participating. U : Unable to authenticate regardless of the reason.	String (1)
AcctID	Masked string used by the ACS.	String (28)
URL	URL of Access Control Server where to send the PAReq. This element corresponds to the consumerAuthenticationInformation.acsUrl API field.	String (1000)

VERes Element

    
  Y
  NDAxMjAwMTAxMTAwMDc3MQ==
  https://www.example_url.com

PAReq Element

The

PAReq

element contains the payer authentication request message. This element corresponds to the

consumerAuthenticationInformation.pareq

API field.

    
  (AcqBIN)
  (MerID)
  (Name)
  (Country)
  (URL)
  (XID)
  (Date)
  (PurchaseAmount)
  (AcctID)
  (Expiry)

Child Elements of PAReq
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)
Name	Merchant’s company name.	String (25)
Country	Two-character code for the merchant’s country of operation.	String (2)
URL	Merchant’s business website.	String
XID	Unique transaction identifier generated for each Payment Authentication Request (PAReq) message. The PARes sent back by the issuing bank contains the XID of the PAReq. To ensure that both XIDs are the same, compare it to the XID in the response. To find all requests related to a transaction, you can also search transactions for a specific XID.	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 may not because of differing time zones and synchronization between servers.)	DateTime (25)
Purchase Amount	Authorization amount and currency for the transaction. This element corresponds to the totals of the offer lines or from: orderInformation.amountDetails.totalAmount	Amount (15)
AcctID	Masked string used by the ACS.	String (28)
Expiry	Expiration month and year of the customer’s card.	Number (4)

PAReq Element

    
  123456
  444444
  example
  US
  http://www.example.com
  fr2VCDrbEdyC37MOPfIzMwAHBwE=
  2020-02-09T08:00:34-08:00
  1.00 USD
  NDAxMjAwMTAxMTAwMDc3MQ==
  2309

PARes Element

The

PARes

element contains the payer authentication response.

    
  (AcqBIN)
  (MerID)
  (XID)
  (Date)
  (PurchaseAmount)
  (PAN)
  (AuthDate)
  (Status)
  (CAVV)
  (ECI)

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

    
  123456
  4444444
  Xe5DcjrqEdyC37MOPfIzMwAHBwE=
  2020-02-09T07:59:46-08:00
  1002.00 USD
  0000000000000771
  2020-02-09T07:59:46-08:00
  Y
  AAAAAAAAAAAAAAAAAAAAAAAAAAA=
  5

AuthInfo Element

The

AuthInfo

element contains address and card verification information.

    
  (AVSResult)
  (CVVResult)

Child Elements of AuthInfo
Element Name	Description	Type & Length
AVSResult	Optional results of the address verification test.	String (1)
CVVResult	Optional results of the card verification number test.	String (1)

AuthInfo Element

    
  Y
  git

Report Examples

These examples show a complete transaction: the failed enrollment check (enrolled card) and the subsequent successful authentication.

For transactions in India, use transactionProcessor.

Failed Enrollment Check

    

      https://api.cybersource.com
      /reporting/v3/dtd/padr">

Name="Payer Authentication Detail" 
Version="1.0”
xmlns="
      https://api.cybersource.com
      /reporting/v3/dtds/padr" 
MerchantID="sample_merchant_id" 
ReportStartDate="2022-02-09T08:00:00-08:00" 
ReportEndDate="2022-02-10T08:00:00-08:00"

   
      RequestID=”1895549430000167904548”
      TransactionType=”ics_pa_enroll
      RequestDate=”2022-02-09T08:00:02-08:00”
      
         20220209 08:00:34
         https:123.456.789.01:234/DSMsgServlet
         XXXXXXXXXXXX0771
         123456
         4444444
         
         Y
      
      
         XXXXXXXXXXXX0771
         123456
         example
      
      
         Y
         NDAxMjAwMTAxMTAwMDc3MQ==
         https://www.sample_url.com
      
      
         123456
         example
         Merchant Name
         US
         http://www.merchant_url.com
         2YNaNGDBEdydJ6WI6aFJWAAHBwE=
         2022-02-09T08:00:34-08:00
         1.00 USD
         NDAxMjAwMTAxMTAwMDc3MQ==
         2309

Successful Authentication

    

      https://api.cybersource.com
      /reporting/v3/dtd/padr">


   
      RequestID=”1895549900000167904548”
      TransactionType=”ics_pa_validate”
      XID=”2YNaNGDBEdydJ6WI6aFJWAAHBwE=”
      RequestDate=”2022-02-09T08:00:02-08:00”
      
         469216
         6678516
         2YNaNGDBEdydJ6WI6aFJWAAHBwE=
         2020-02-09T07:59:46-08:00
         1.00 USD
         0000000000000771
         2022-02-09T07:59:46-08:00
         Y
         AAAAAAAAAAAAAAAAAAAAAAAAAAA=
         5