Cards

This section covers configurations related to 3DS1 only.

Add a New Card¶

Users > New Card

Select Issuer from the drop down list
Select the Authentication method from the drop down list (This should correspond to the card provider)
Ensure Status is set to Enabled
Enter the Card number
Enter the cardholder name in Name on card
Enter the Expiry date
Set the Internet PIN. This will be used during Activation During Shopping when registering the Pre-registered card)
Click the Apply button.

Note

Cards can also be uploaded in bulk through ActiveAccess Registration Requests and the GPayments Card Loader application. Refer to the ActiveAccess documentation, ActiveAccess Administration and GPayments Card Loader and Signer/Verification Application, for further information.

Configure Custom Pages¶

Upload Local Custom Pages¶

Issuers > Custom Pages

Select the Issuer or Issuer Group radio button and select from the drop down list
If matches are found, custom pages have previously been set up for this issuer, in which case go to Section 8 - Authentication Scenarios Setup
If no matches are found, click the Upload File link
Use the Choose File button to locate and upload the Authentication.zip file from the following path in ActiveAccess installation package: ActiveAccess/data/custompage/issuer/Any Bank

Note

You can customise the XSL pages as appropriate. Note that different custom pages are used for local and remote issuers.

Click the Apply button.

Authentication Scenarios Setup¶

Each authentication scenario covered in this section should be set up and tested independently, using a newly created card, as individual scenarios may require a different configuration within the same issuer.

Activation During Shopping (ADS) Scenario¶

Configure Issuer Settings¶

Issuer > Settings

Select the Issuer from the drop down list
Set Activation During Shopping to Enabled for all requested/configured card providers
Click the Apply button.

Perform a Test Transaction¶

Go to Section 9 - Perform a Test Transaction.

Authentication Success Scenario¶

Configure Issuer Settings¶

Issuer > Settings

Select the Issuer from the drop down list
Set Activation During Shopping to Enabled for all requested/configured card providers
Click the Apply button.

Register the Pre-Registered Card¶

Perform a test transaction with the card to register the card through Activation During Shopping (ADS). If you have access to the GPayments MPI (ActiveMerchant), follow the steps below.

ActiveMerchant Test Payment Page

Go to the ActiveMerchant Test Payment page to register a newly created card set up in Section 6 - Configure Card Numbers
Enter the Card number to perform a test transaction
Click the Submit button
On the confirmation page, click the Submit button
On the registration page, enter Name on Card and Internet Pin, which were set up in Section 6 - Configure Card Numbers
Click the Submit / Activate button
Enter a Personal Assurance Message
Set a Password to be used for authenticating the cardholder
Click the Submit button
On the next page, click the Continue / OK button to go to the Success page.

Perform a Test Transaction¶

Go to Section 9 - Perform a Test Transaction.

Authentication Fail Scenario¶

Configure Issuer Settings¶

Issuer > Settings

Select Issuer from the drop down list
Set Activation During Shopping to Enabled for all requested/configured card providers
Set an appropriate value for Maximum unsuccessful attempts. As the card will need to be locked for this scenario (Section 8.3.3 - Lock the Card), it is preferable to set a lower value, e.g. 3. Do not set the value to 0 (disable).
Set Automatic unlock to 0 (disabled)

Note

Perform this step only if you would like the cards of this issuer to stay locked and provide results for the authentication failed scenario each time.

Click the Apply button.

Register the Pre-Registered Card¶

Perform a test transaction with the card, to register the card through Activation During Shopping (ADS). If you have access to the GPayments MPI (ActiveMerchant), follow the steps below.

ActiveMerchant Test Payment Page

Go to the ActiveMerchant Test Payment Page to register the card set up in Section 6 - Configure Card Numbers
Enter the Card number to perform a test transaction
Click the Submit button
On the confirmation page, click the Submit button
On the registration page, enter Name on Card and Internet Pin which were set in Section 6 - Configure Card Numbers
Click the Submit button
Enter a Personal Assurance Message
Set a Password to be used for authenticating the cardholder
Click the Submit button
On the next page, click the Continue / OK button to go to the Success page.

Lock the Card¶

To lock the card, perform a test transaction with the card, entering an incorrect password until the card is locked. If you have access to the GPayments MPI (ActiveMerchant), follow the steps below.

ActiveMerchant Test Payment Page

Go to the ActiveMerchant Test Payment page
Enter the Card number to perform a test transaction
Click the Submit button
On the confirmation page, click the Submit button
On the authentication page, enter an incorrect password. Repeat, until the message This Account is Locked! is displayed.
Click the OK button.

Perform a Test Transaction¶

Go to Section 9 - Perform a Test Transaction.

Forgot Password Scenario¶

Configure Issuer Settings¶

System Management > Issuer Management

Find the issuer and click the Issuer Name to go to the Issuer Details page
Set Show extended account information to Yes for Question and Answer fields be shown on Card Details page
Click the Apply button.

Issuer > Settings

Select the Issuer from the drop down list
Set Activation During Shopping to Enabled for all requested/configured card providers
Click the Apply button.

Register the Pre-Registered Card¶

To register the card through Activation During Shopping (ADS), perform a test transaction with the card. If you have access to the GPayments MPI (ActiveMerchant), follow the steps below.

ActiveMerchant Test Payment Page

Go to the ActiveMerchant Test Payment page to register the card set up in Section 6 - Configure Card Numbers
Enter the Card number to perform a test transaction
Click the Submit button
On the confirmation page, click the Submit button
On the registration page, enter Name on Card and Internet Pin which were set in Section 6 - Configure Card Numbers
Click the Submit button
Enter a Personal Assurance Message
Set a Password to be used for authenticating the cardholder
Click the Submit button
On the next page, click the Continue / OK button to go to the Success page.

Configure Question & Answer¶

Users > Find Card > Card Details

Enter a Question and an Answer
Click the Apply button.

Perform a Test Transaction¶

Go to Section 9 - Perform a Test Transaction. During the transaction, click on the "Forgot your Password?" link.

Proof of Attempt Scenario¶

Configure Issuer Settings¶

Issuer > Settings

Select Issuer from the drop down list
Set Activation During Shopping to Disabled for all requested/configured card providers
Set Proof of Authentication Attempt to Enabled for all requested/configured card providers
Click the Apply button.

Perform a Test Transaction¶

Go to Section 9 - Perform a Test Transaction.

PAN Not Enrolled Scenario¶

Configure Issuer Settings¶

Issuers > Settings

Select Issuer from the drop down list
Set Activation During Shopping to Disabled for all requested/configured card providers
Set Proof of Authentication Attempt to Disabled for all requested/configured card providers
Click the Apply button.

Perform a Test Transaction¶

Go to Section 9 - Perform a Test Transaction.

Delay / Timeout Scenario¶

You can test scenarios such as delay or timeout in Verify Enrolment or Payer Authentication processes.

You can create a responseTimeout.properties file in ActiveAccess' AA_HOME directory. This configuration file can be used for testing purposes only and under no circumstances should be used in a real production environment. The properties in this configuration file should be in the following general format:

BIN.reqType=waiting time (milliseconds)
BIN: is the issuer specified BIN number for which you would like to cause a delay in the response to card numbers that match the BIN.
reqType (VE or PA): is the type of the request for which you would like to cause a given amount of delay. VE and PA stand for Verify Enrolment and Payer Authentication requests respectively.
Waiting time: The delay in milliseconds that you would like to cause in the response of VE or PA requests.
To set a VE response delay, it is recommended that it is greater than the VERES time-out defined by the MPI.
To set PA response delay, it is recommended that it is greater than the PARes time-out defined by the MPI
Info
0 means unlimited
Example
412345.VE=15000
512345.PA=20000
341234.VE=0

ActiveAccess server should be restarted for changes to take effect.

Perform a Test Transaction¶

After configuring each of the authentication scenarios, perform a test transaction with the card. If you have access to the GPayments MPI (ActiveMerchant), follow the steps below.

ActiveMerchant Test Payment Page (3-D Secure 1)

Go to the ActiveMerchant Test Payment page
Enter the Card number to perform a test transaction
Click the Submit button
Ensure that the outcome corresponds with the authentication scenario.