Class ExternalCardholderAuthenticationData

Inheritance
object
ExternalCardholderAuthenticationData
Inherited Members
Namespace: Worldline.Connect.Sdk.V1.Domain
Assembly: Worldline.Connect.Sdk.dll
Syntax
public class ExternalCardholderAuthenticationData

Properties

AcsTransactionId

Identifier of the authenticated transaction at the ACS/Issuer.

Declaration
public string AcsTransactionId { get; set; }
Property Value
Type Description
string

AppliedExemption

When you request an exemptions via your non-Worldline 3D Secure provider successfully, you need to provide in this property the exemption that was granted, in combination with all 3DS results given by issuer.
Possible values:

  • transaction-risk-analysis - You have determined that this transaction is of low risk and are willing to take the liability. Please note that your fraud rate needs to stay below thresholds to allow your use of this exemption.
  • low-value - The value of the transaction is below 30 EUR. Please note that the issuer will still require every 5th low-value transaction pithing 24 hours to be strongly authenticated. The issuer will also keep track of the cumulative amount authorized on the card. When this exceeds 100 EUR strong customer authentication is also required.
  • whitelist - You have been whitelisted by the customer at the issuer.
Declaration
public string AppliedExemption { get; set; }
Property Value
Type Description
string

Cavv

The CAVV (cardholder authentication verification value) or AAV (accountholder authentication value) provides an authentication validation value.

Declaration
public string Cavv { get; set; }
Property Value
Type Description
string

CavvAlgorithm

The algorithm, from your 3D Secure provider, used to generate the authentication CAVV.

Declaration
public string CavvAlgorithm { get; set; }
Property Value
Type Description
string

DirectoryServerTransactionId

The 3-D Secure Directory Server transaction ID that is used for the 3D Authentication

Declaration
public string DirectoryServerTransactionId { get; set; }
Property Value
Type Description
string

Eci

ECI (Electronic Commerce Indicator) indicates the level of authentication obtained for a transaction. Possible values for each level of authentication are listed below.

  • For ValidationResult = Y (Successful Authentication)
    • MC → ECI 02
    • Visa, CB, Amex, JCB, DCI, UPI → ECI 05
  • For ValidationResult = A (Attempt)
    • MC → ECI 01
    • Visa, Amex, JCB, DCI, UPI → ECI 06
    • CB → 06 (or null from ACS - populate as 06)
  • For ValidationResult = I (Exemption Accepted)- for all below values, ECI must be sent with the resulted CAVV
    • MC → ECI 06 (PSD2 Exemption)
    • Visa → ECI 07 (TRA Exemption) or ECI 05 (other exemptions)
    • CB, JCB, UPI → ECI 05
    • Amex, DCI → ECI 05/0
Declaration
public int? Eci { get; set; }
Property Value
Type Description
int?

SchemeRiskScore

Global score calculated by the Carte Bancaire (130) Scoring platform. Possible values from 0 to 99.

Declaration
public int? SchemeRiskScore { get; set; }
Property Value
Type Description
int?

ThreeDSecureVersion

The 3-D Secure version used for the authentication. Possible values:

  • v1
  • v2
  • 1.0.2
  • 2.1.0
  • 2.2.0
  • 2.3
  • 2.3.0
  • 2.3.1
  • 2.3.1.1
Declaration
public string ThreeDSecureVersion { get; set; }
Property Value
Type Description
string

ThreeDServerTransactionId

The 3-D Secure Server transaction ID that is used for the 3-D Secure version 2 Authentication.

Declaration
[Obsolete("No replacement")]
public string ThreeDServerTransactionId { get; set; }
Property Value
Type Description
string

ValidationResult

The transaction status given by the 3D Secure provider. Possible values below:

  • Y: Cardholder successfully authenticated
  • A: Authentication attempt (merchant attempted, issuer not participating or ACS unavailable)
  • I: Informational only (SCA exemption accepted)
Declaration
public string ValidationResult { get; set; }
Property Value
Type Description
string

Xid

The transaction ID that is used for the 3D Authentication

Declaration
public string Xid { get; set; }
Property Value
Type Description
string