Transactions

The ability to search by 3DS version added.

This section is used for accessing 3-D Secure transactions, when required for user support purposes, dispute resolution etc. It has the following menu options:

• Find 3-D Secure - to search for and view transactions

Find 3-D Secure¶

Transactions > Find 3-D Secure

This page allows you to search for and access 3-D Secure authentication records including the proof of authentication, which can be used for dispute resolution for example.

You can search based on Issuer, Authentication method, Date, Amount, Currency, Account number, Merchant name, Transaction ID and AAV/CAVV and more.

Search fields¶

The search fields available on this page change based on the 3-D Secure version(s) selected.

Common Search Fields¶

The following search fields are common between all 3-D Secure versions.

Use the following fields to search for 3-D Secure Transactions:

• Select a Target database from the list to search for Current or Archived transactions, if archiving has been configured on the system.

• Select at least one 3-D Secure version, by selecting/deselecting the appropriate checkboxes.

  Note

  The search fields available on this page change based on the 3-D Secure version(s) selected.

• Specify an ACS Session ID to search for a specific transaction.

• Select an Issuer (from the list of available issuers) to narrow down the search criteria or you can select All. If the Issuer has access to Rules, additional search options will be displayed below.

• Select the Authentication method from the drop down list. The options are J/Secure, ProtectBuy, SafeKey, SecureCode, SPA or VbV.

• You can specify an exact Date and time or a date and time range (inclusive) in the From and To Date fields. The date and time format is dd/mm/yyyy HH:MM. Leave the time field empty if you do not wish to limit your search for a particular time of day.

  By default the search is limited to the last 7 days, modify the From field if you wish to extend the search period.

• You can specify an exact amount or an amount range (inclusive) in the From and To Amount fields.

• Select the Currency from the drop down list.

• Enter the Merchant name in full or in part.

• Enter the full Merchant ID.

• Enter the full cardholder Account number.

• Enter the Client ID.

• Enter the AAV/CAVV/AEVV to find the transaction for which this value was generated.

  AAV (Accountholder Authentication Value) / CAVV (Cardholder Authentication Verification Value) / AEVV (American Express Verification Value) is provided in 3‑D Secure PARes for J/Secure, ProtectBuy, SafeKey, SecureCode and VbV transactions. AV (Authentication Value) is provided in 3-D Secure 2 ARes and RReq.

• Enter the Device serial number to search for transactions that were authenticated using a particular two-factor authentication device.

• Select a Device type from the list to search for transactions performed with particular type of authentication device such as SMS or OOB, etc.

• Enter an Error code/IReq code to search for in the authentication response message.

• Enter an Error message/IReq message to search for in the authentication response message.

• Rules - displayed if specified Issuer has access to Rules. Where an issuer with Rules enabled is selected, additional fields will be available so that you can search for transactions by whether they match or do not match one or more rules.

  • Select one of the following radio buttons:

    • All - all transactions, regardless of rules

    • Matched - transactions that match the rules selected from the adjacent list

    • Mismatched - transactions that do not match the rules selected from the adjacent list

  • Select one or more Rules (Ctrl + click to select multiple rules) from the list:

    • Amount Threshold

    • Domestic & International Transaction Threshold

    • Location Watchlist

    • Merchant Blacklist

    • Merchant Watchlist

    • Merchant Whitelist

    • Soft Launch List

    • Stand-In Transaction Threshold

  • If you have selected the Matched radio button, you can enter an Error code or Error message to search on.

  • If you have selected merchant or location list rules, you can enter additional search parameters:

    • Merchant ID

    • Merchant name

    • Acquirer BIN

    • Merchant country code

• Click Search to display the Transaction Search Results.

Additional 3-D Secure version 1 Search Fields¶

• Enter the Transaction ID (XID) as specified by the merchant. Transaction ID can be entered in clear or base64 format but you need to the specify the entire Transaction ID (20 character in clear or 28 characters in base64)

• Select a Transaction type from the list to limit the results to transactions that involved a second factor of authentication (Device over 3-D Secure 1) or conventional 3-D Secure 1 transactions.

• Select a VERes status from the list to search for transactions with a particular verify enrolment result. The VERes status can be:

  • Y - Cardholder is enrolled

  • N - Cardholder is not enrolled

  • U - Cardholder enrolment cannot be determined due to technical or other problems

  • Error - An error occurred whilst verifying the enrolment status of the cardholder.

• Select a PARes status from the list to search for transactions with a particular payer authentication result. The PARes status can be:

  • Y - Cardholder authentication successful

  • A - Cardholder is not enrolled but proof of authentication attempt provided to the merchant

  • N - Cardholder authentication failed

  • U - Cardholder authentication cannot be completed due to technical or other problems.

  • N/A - Cardholder authentication did not complete.

  • Error - An error occurred during cardholder authentication.

  Note

  Use PARes and VERes filters only if you are searching for 3-D Secure records, version 1.0.1 and above.

• Select the transaction Status from the list. The transactions can either be In progress or Processed. An In progress status indicates that either the cardholder has not yet finished the authentication process or the system has not yet sent the PATransReq message to the authentication history server. When you choose to search for all transactions regardless of their status, the system will first return all In progress transactions followed by Processed transactions. Please note that only the first 400 records are returned in total.

• The Registered after previous opt-outs or cancellations option provides a way of searching for and listing transactions where cardholders have completed their registration after initially opting out or cancelling activation during shopping.

Additional 3-D Secure version 2 Search Fields¶

• Enter an SDK transaction ID

• Enter a DS transaction ID

• Enter an 3DS Server transaction ID

• Select an ARes status from the list to search for transactions with a particular authentication response. The ARes status can be:

  • Y - Authentication / account verification successful

  • N - Not Authenticated / account not verified - transaction denied

  • U - Authentication / account verification could not be performed - technical or other problem, as indicated in ARes or RReq

  • A - Attempts processing performed - not authenticated / verified but a proof of attempted authentication/verification is provided

  • C - Challenge required - additional authentication is required using the CReq/CRes

  • R - Authentication / account verification rejected - Issuer is rejecting authentication / verification and requests that authorisation not be attempted.

• Select a CRes status from the list to search for transactions with a particular challenge response. The CRes status can be:

  • Y - Authentication / account verification successful

  • N - Not Authenticated / account not verified - transaction denied

• Select an RReq status from the list to search for transactions with a particular results request. The RReq status can be:

  • Y - Authentication / account verification successful

  • N - Not Authenticated / account not verified - transaction denied

  • U - Authentication / account verification could not be performed - technical or other problem, as indicated in ARes or RReq

  • A - Attempts processing performed - not authenticated / verified but a proof of attempted authentication/verification is provided

  • C - Challenge required - additional authentication is required using the CReq/CRes

  • R - Authentication / account verification rejected - Issuer is rejecting authentication / verification and requests that authorisation not be attempted.

• Select a Message cateory from the list to search for All, Payment authentication or Non payment authentication transactions.

• Select an Authentication type from the list to search for All, Static, Dynamic or OOB transactions.

• Select a Device channel from the list to search for App based, Browser or 3DS Requester Initiated (3RI) transactions.

Transaction Search Results¶

Transactions > Find Transaction > Search Result

The search result page lists transactions matching the criteria you entered on the Find Transaction page and shows transaction date, amount, currency, account number, merchant name, issuer, method, status and transaction type.

Only the first six and the last four digits of the account number are shown. An X masks the rest of the digits. You can choose to display card number in plain text in Settings.

You can browse to the transaction details page by following the link under Account Number.

Use the following steps to select a transaction and view its details:

• Click the Date (and time) hyperlink for the transaction you wish to view.

  The Transaction Details page is displayed.

Transaction Details¶

Transactions > Find Transaction > Search Result > Transaction Details

This page shows the details for the Transaction selected on the Transaction Search Result page.

The following fields can be viewed on this page:

Common Fields¶

• Issuer - Shows the card's issuing bank.

• Authentication method - Shows the authentication method relevant to this transaction. The options are: J/Secure, ProtectBuy, SafeKey. SecureCode, or Verified by Visa.

• Date - Shows the date and time of the transaction.

• Amount - Shows the transaction amount, including the currency.

• Account number - Shows the last five digits of the account number, which is used in this transaction. Links to the Card Details page.

• Client ID - An integer type with 15 digits length assigned to cards that belong to one cardholder.

• Merchant name - Shows the merchant name.

• Merchant ID - Acquirer-defined merchant identifier, up to 24 characters including the Card Acceptor ID and Card Acceptor Terminal ID.

• AAV/CAVV/AEVV - Accountholder Authentication Value / Cardholder Authentication Verification Value / American Express Verification Value for J/Secure, ProtectBuy, SafeKey, SecureCode and VbV authentication. AV (Authentication Value) for 3-D Secure 2.

• Device serial number - The unique identifier of the authentication device used in the transaction for two-factor authentication, if available.

• Device type - The type of authentication device used in the transaction for two-factor authentication, if available.

• Transaction type - 3-D Secure 1, Device over 3-D Secure 1, or 3-D Secure 2, depending on whether the transaction was a conventional password-based 3-D Secure 1 authentication, a two-factor authentication or a 3-D Secure 2 authentication.

• Error code - 0 if the authentication request was successfully completed. Any other value indicates an error condition.

• Error text - A descriptive message for the response code.

• Error detail - Detailed information for the error condition.

• Matched rules - Displays the rules against which the transaction matched, with links to the details of the rule at the time of the transaction.

  Where a transaction has matched the merchant blacklist rule, the Matched Rule Details display the matched rule highlighted in red.

• Click on the Requests and Responses link to see the details of 3-D Secure 1 messages (VEReq, VERes, PAReq, PARes, PATransReq, PATransRes) or 3-D Secure 2 messages (AReq, ARes, CReq, CRes, RReq, RRes).

Additional 3-D Secure 1 Fields¶

• Transaction ID (XID) - Transaction ID as specified by the merchant (XID for J/Secure, ProtectBuy, SafeKey, SecureCode and VbV)

Additional 3-D Secure 2 Fields¶

• SDK transaction ID

• DS transaction ID

• 3DS Server transaction ID

• ARes status - Authentication Result status.

• ARes status reason - Authentication Result reason.

• CRes status - Challenge Result status.

• RReq status - Results Request status.

• Risk decision - Action decided by Risk Assessment. Possible values are Frictionless, Frictionless by review (Visa only), Use static password, Use Device, Use OOB, and Rejected.

• Failed reason - Shows the reason for the transaction ending with a status of N or U.

• Device channel - Shows the device channel as App based, Browser or 3DS Requester Initiated.

• Message category - Shows the message category as Payment authentication or Non payment authentication.

• Authentication type - Shows the authentication type as Static, Dynamic or OOB.

• IAV generation algorithm - Shows the algorithm used to generate IAV (3DS2 only).