AccountNumber String

The account number to profile or the network tokens. Account number must be the full PAN of the cardholder between 13-19 digits.

CardBrand String

Types of cards used for purchase. Currently VISA is the only supported card brand for FIDO.

ReferenceID String

A Cardinal generated identifier used to ensure that a data remains accurate during the various calls.

AcquirerCountryCode String

Issuers need to be aware of the acquirer's country code when the acquirer country differs from the merchant country. This field is required for a merchant acquiring in India and the European Economic Area (EEA).

This should be in alignment with ISO 3166-1

LanguagePreference Array

A list of preferred languages used during an authentication prompt. The preferred option will be the left most option.

Example:  ["en", "es"]

Email String

The cardholder’s email.

Payment Object

Contains payment fields.

Amount String

The total transaction amount with decimalization.

CurrencyCode String

A 3-digit alpha ISO 4217 currency code for the sale amount.

MerchantName String

The name of the merchant requesting the FIDO transaction. This value will be presented to the merchant during the authentication step.

 {
   "Signature": "KmL2SLBeTRRU9TlxA6XfnAYg5yWn1QwEO0GL1RtP8mg=",
   "Timestamp": "2024-02-21T20:10:20.872Z",
   "Identifier": "59c282d02f3e7357b4aa6f13",
   "OrgUnitId": "59c2745f2f3e7357b4aa516a",
   "Algorithm": "SHA-256",
   "Payload": {
      "AccountNumber": "400009******0800",
      "CardBrand":"Visa",
      "ReferenceId": "12345-1234-123145-1423",
      "AcquirerCountryCode": "840",
      "LanguagePreference": ["en", "es"],
      "Email": "someone@somewhere.com",
      "Payment": {
        "Amount": "12.34",
        "CurrencyCode": "USD",
        "MerchantName": "Amazon",
      }
   }
}

Account Object

Indicates information related to the Account.

Issuer Object

Indicates information related to the Issuer.

ReferenceId String

This identifier represents the DeviceDataCollection session that has been started and must be passed in the Authentication JWT when invoking the DeviceDataCollectionUrl.

CardBrand String

Types of cards used for purchase. Currently VISA is the only supported card brand for FIDO.

LastFour String

Unformatted total transaction amount without any decimalizationThe last four digits on the card.

FIDO Object

An object with FIDO specific fields

FlowType String

Indicates the flow type of the FIDO process with three possible values:

• ENROLLMENT- Move forward with a 3DS authentication to continue the enrollment flow.

• AUTHENTICATION- Move forward with FIDO authentication by running the /FIDO/Challenge request.

• FAILURE- Move forward with 3DS authentication without FIDO.

ReasonCode String

The error code for the FIDO attempt. Only returned in an error scenario

ReasonDescription String

The error description for the FIDO attempt. Only returned in an error scenario

SupportedVersions Array of Objects

Indicates what EMV 3DS versions are supported by the Issuer, and what authentication options are supported for each listed version name.

SupportedVersions.Version String

Specifies all the active 3DS protocol versions supported by the Issuer ACS.

SupportedVersions.Capabilities Array

Provides information for each capabilities array, which indicates the authentication options an Issuer supports for the given EMV 3DS version.

SupportedVersions.MethodURLPresent Object

Indicates whether there is a 3DS Method associated with the Issuer Range

 {
    "ErrorNumber": 0,
    "ErrorDescription": "Success",
    "RequestId": "b3933183-48df-409f-94ff-12952364009b",
    "Payload": {
        "Account": {
            "CardBrand": "Visa",
            "LastFour": "0094",
            "FIDO": {
                "FlowType": "ENROLLMENT", 
                "ReasonCode": "1001",
                "ReasonDescription": "Error"
            }
        },
        "Issuer": {
            "SupportedVersions": [
                {
                    "Version": "2.1.0",
                    "Capabilities": [
                        "AuthenticationAvailableAtACS",
                        "DAF"
                    ],
                    "MethodURLPresent": true
                },
                {
                    "Version": "2.2.0",
                    "Capabilities": [
                        "AuthenticationAvailableAtACS",
                        "DecoupledAuthentication",
                        "DataOnly",
                        "DelegatedAuthentication",
                        "IssuerTRA",
                        "DAF"
                    ],
                    "MethodURLPresent": true
                }
            ]
        },
        "ReferenceId": "51ca6679-12ed-47c4-8982-1a29e10d4587"
    }
}