3 Cardholder Authentication Flows
This section provides a description of the message flow between parties in an authentication session.
3.1 Authentication using OTP
Figure 2 provides an overview of the cardholder authentication process during a transaction, using the Cardinal 3D Secure service with One Time Password (OTP) authentication.
Figure 2: 3D Secure Authentication Process – Using RDX and OTP
Prior to using OTP, you need to set up the OTP credential on the card. See Using the Card Enrolment API.
-
The cardholder uses their card at a merchant website.
-
If the merchant is enroled in 3D Secure, they send a request for authentication to the Card Scheme (Mastercard/Visa/Discover).
-
The Card Scheme looks up the 3D Secure service provider and sends the authentication request to Cardinal.
-
Cardinal checks to confirm the card BIN range is enabled for 3D Secure. Based on the rules you set up in Cardinal for your card program, the outcome is Success, Fail/Reject or Challenge. (See Appendix 1: Cardinal 3D Secure Rules)
-
For a Success outcome, an approval response is returned to the merchant. They can continue with the transaction authorisation
Process that seeks approval for a payment transaction. The process starts when a merchant requests approval for a card payment by sending a request to the card issuer (BIN sponsor) to check that the card is valid, and that the requested authorisation amount is available on the card. process.
-
For a Fail/Reject outcome, an authentication failure/reject response is returned to the merchant. They can decide whether to continue or ask the cardholder to provide an alternative payment method.
-
For a challenge outcome, 3D Secure authentication is required. See the steps below.
-
Steps for a Challenge outcome
-
Cardinal connects to Thredd in real-time to query the types of authentication the card is registered for (e.g., Biometric, OTP SMS or KBA).
-
Thredd replies to Cardinal with the OTP as the type of authentication registered on the card (based on what you registered the card for using the Thredd API
The Thredd API consists of web services that use SOAP and the Cards API based on REST./ Cards API
The Thredd Cards API are REST-based API that enable you to create and manage the cards in your card programme using JSON messages. and on the default types set up for your cards)1.
-
Cardinal generates the OTP and sends it to Thredd in real-time.
-
Cardinal displays the OTP screens to the cardholder.
-
Thredd sends the OTP to the cardholder’s mobile number.
-
The cardholder enters the OTP to complete their authentication.
-
Cardinal validates the OTP and sends the result back to the merchant.
3.2 Authentication using Biometrics or In-App OOB
Figure 3 provides an overview of the cardholder authentication process during a transaction, using the Cardinal 3D Secure service with Biometric authentication.
Figure 3: 3D Secure Authentication Process – Using RDX and Biometrics
Authentication via Biometric or In-App OOB
Prior to using KBA, you need to set up the BIOMETRIC credential on the card. See Using the Card Enrolment API.
Steps 1-5 are as described previously.
-
Thredd replies to Cardinal with Biometric as the type of authentication (based on what you registered the card for using the API and on the default types set up for your cards)2.
-
Cardinal calls Thredd to start the Biometric authentication.
-
Thredd sends a message to your RDX service endpoint, to start authenticating using Biometric. Note that Program Managers must respond to Thredd’s
NotifyInitiateAction
API request (200 OK) within 5 seconds as Cardinal is expecting Thredd to respond within 5 seconds. The architecture allows occasional longer running transactions of up to 10 seconds; however, the average response time should be significantly lower.(See Initiating a Biometric Session) -
Cardinal shows the Biometric screens to the cardholder. This informs the cardholder that they will need to authenticate using your smart device app.
-
You connect to your cardholder via your Biometric or In-App customer smart device application.
-
The cardholder authenticates using your smart phone app (e.g., by scanning their fingerprint or face using their smart device)
-
When the authentication session is complete, then:
-
Your app must return the result of the Biometric authentication to Thredd (validate response using the
NotifyValidate
API). -
Your app should call the merchant's app (using the
MerchantAppRedirectURL
field value obtained from the ThreddNotifyInitiateAction
API request) to enable the merchant app to redirect the cardholder back to the checkout page. -
Cardinal sends a validate request to Thredd.
-
Thredd waits for your validate response (
NotifyValidate
API) and sends the results back to Cardinal. -
Cardinal returns the results to the merchant.
3.3 Authentication using KBA
Figure 4 provides an overview of the cardholder authentication process during a transaction, using the Cardinal 3D Secure service with Knowledge Based Authentication (KBA).
Figure 4: 3D Secure Authentication Process – Using RDX and KBA
Authentication via KBA
Prior to using KBA, you need to set up the KBA credential, including the question and answer pair to be used for the card during a KBA authentication session. See Using the Card Enrolment API.
An online authentication session using KBA is typically combined with OTP SMS; the KBA authentication follows directly after the OTP SMS authentication. See Authentication using OTP.
-
Cardinal connects to Thredd in real-time to query the types of authentication the card is registered for (e.g., OTP SMS and KBA).
-
Thredd replies to Cardinal with the OTP and KBA authentication types. For KBA, Thredd includes the security question to present to the cardholder.
-
Cardinal follows the process for OTP SMS, presenting the OTP screen to the customer, who enters the OTP which Thredd sends to their mobile phone.
-
Following OTP authentication, Cardinal presents an additional screen to the cardholder, asking them to answer the security question set up for their card.
-
The cardholder enters their answer.
-
Cardinal validates the OTP and sends the OTP validation result to Thredd, together with the KBA answer.
-
Thredd compares the answer returned from Cardinal to the answer stored in the Thredd database3. Thredd sends the combined OTP and KBA validation results back to Cardinal.
-
Cardinal returns the results to the merchant.
3.4 What happens after authentication?
When the cardholder is authenticated, the merchant can proceed with requesting authorisation Process that seeks approval for a payment transaction. The process starts when a merchant requests approval for a card payment by sending a request to the card issuer (BIN sponsor) to check that the card is valid, and that the requested authorisation amount is available on the card. for the transaction. (The merchant acquirer includes the 3DS secure value they receive from Cardinal within the transaction:
UCAF
field (For Mastercard), the CAVV
field 126.9 for (Visa), and Field 122 of the authorisation message for Discover/Diners.)
If requested, then Thredd will validate the AAV (Mastercard) or CAVV (Visa). If you need Thredd to validate the CAVV or AAV, then please specify this when Completing your 3DS Product Setup Form (PSF) by selecting YES in the Do you require Thredd to validate the AAV/CAVV?
field.
Depending on your External Host Interface (EHI) The External Host Interface (EHI) is a Thredd system that enables Thredd clients to receive and respond to real-time transaction data as well as financial messages. mode, Thredd approves/declines the transaction or sends to your EHI endpoint to approve or decline.
You can view details of your 3D Secure transactions in the Cardinal Portal. See Configuring Rules in Cardinal Portal Production.