Retrieve
Get 3DS authentication
Get 3DS Authentication by token
Path Parameters
Returns
Globally unique identifier for the 3DS authentication. Permitted values: 36-digit version 4 UUID (including hyphens).
Type of account/card that is being used for the transaction. Maps to EMV 3DS field acctType.
Indicates the outcome of the 3DS authentication process.
Indicates whether the expiration date provided by the cardholder during checkout matches Lithic's record of the card's expiration date.
Globally unique identifier for the card on which the 3DS authentication has occurred. Permitted values: 36-digit version 4 UUID (including hyphens).
Object containing data about the cardholder provided during the transaction.
Channel in which the authentication occurs. Maps to EMV 3DS field deviceChannel.
Date and time when the authentication was created in Lithic's system. Permitted values: Date string in the ISO 8601 format yyyy-MM-dd'T'hh:mm:ssZ.
Object containing data about the merchant involved in the e-commerce transaction.
Either PAYMENT_AUTHENTICATION or NON_PAYMENT_AUTHENTICATION. For NON_PAYMENT_AUTHENTICATION, additional_data and transaction fields are not populated.
Indicates whether a challenge is requested for this transaction
NO_PREFERENCE- No PreferenceNO_CHALLENGE_REQUESTED- No Challenge RequestedCHALLENGE_PREFERENCE- Challenge requested (3DS Requestor preference)CHALLENGE_MANDATE- Challenge requested (Mandate)NO_CHALLENGE_RISK_ALREADY_ASSESSED- No Challenge requested (Transactional risk analysis is already performed)DATA_SHARE_ONLY- No Challenge requested (Data Share Only)OTHER- Other indicators not captured by above. These are rarely used
Object containing additional data about the 3DS request that is beyond the EMV 3DS standard spec (e.g., specific fields that only certain card networks send but are not required across all 3DS requests).
Object containing data about the app used in the e-commerce transaction. Present if the channel is 'APP_BASED'.
Type of authentication request - i.e., the type of transaction or interaction is causing the merchant to request an authentication. Maps to EMV 3DS field threeDSRequestorAuthenticationInd.
Object containing data about the browser used in the e-commerce transaction. Present if the channel is 'BROWSER'.
Metadata about the challenge method and delivery. Only present when a challenge is triggered.
Entity that orchestrates the challenge. This won't be set for authentications for which a decision has not yet been made (e.g. in-flight customer decisioning request).
Entity that made the authentication decision. This won't be set for authentications for which a decision has not yet been made (e.g. in-flight customer decisioning request).
Type of 3DS Requestor Initiated (3RI) request — i.e., a 3DS authentication that takes place at the initiation of the merchant rather than the cardholder. The most common example of this is where a merchant is authenticating before billing for a recurring transaction such as a pay TV subscription or a utility bill. Maps to EMV 3DS field threeRIInd.
Object containing data about the e-commerce transaction for which the merchant is requesting authentication.
curl https://api.lithic.com/v1/three_ds_authentication/$THREE_DS_AUTHENTICATION_TOKEN \
-H "Authorization: $LITHIC_API_KEY"{
"token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
"account_type": "CREDIT",
"authentication_result": "DECLINE",
"card_expiry_check": "MATCH",
"card_token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
"cardholder": {
"address_match": true,
"billing_address": {
"address1": "address1",
"address2": "address2",
"address3": "address3",
"city": "city",
"country": "xxx",
"postal_code": "postal_code"
},
"email": "x",
"name": "x",
"phone_number_home": "x",
"phone_number_mobile": "x",
"phone_number_work": "x",
"shipping_address": {
"address1": "address1",
"address2": "address2",
"address3": "address3",
"city": "city",
"country": "xxx",
"postal_code": "postal_code"
}
},
"channel": "APP_BASED",
"created": "2019-12-27T18:11:19.117Z",
"merchant": {
"id": "id",
"country": "xxx",
"mcc": "xxxx",
"name": "name",
"risk_indicator": {
"delivery_email_address": "delivery_email_address",
"delivery_time_frame": "ELECTRONIC_DELIVERY",
"gift_card_amount": 0,
"gift_card_count": 0,
"gift_card_currency": "xxx",
"order_availability": "FUTURE_AVAILABILITY",
"pre_order_available_date": "2019-12-27T18:11:19.117Z",
"reorder_items": "FIRST_TIME_ORDERED",
"shipping_method": "DIGITAL_GOODS"
}
},
"message_category": "NON_PAYMENT_AUTHENTICATION",
"three_ds_requestor_challenge_indicator": "NO_PREFERENCE",
"additional_data": {
"network_decision": "LOW_RISK",
"network_risk_score": 0
},
"app": {
"device_info": "device_info",
"ip": "ip"
},
"authentication_request_type": "ADD_CARD",
"browser": {
"accept_header": "accept_header",
"ip": "ip",
"java_enabled": true,
"javascript_enabled": true,
"language": "language",
"time_zone": "time_zone",
"user_agent": "user_agent"
},
"challenge_metadata": {
"method_type": "SMS_OTP",
"phone_number": "phone_number"
},
"challenge_orchestrated_by": "LITHIC",
"decision_made_by": "LITHIC_RULES",
"three_ri_request_type": "ACCOUNT_VERIFICATION",
"transaction": {
"amount": 0,
"cardholder_amount": 0,
"currency": "xxx",
"currency_exponent": 0,
"date_time": "2019-12-27T18:11:19.117Z",
"type": "ACCOUNT_FUNDING"
}
}