A 3DS authentication attempt was completed. This event forwards values from the ACS.
- Code —
TDSS - Event trigger — Galileo's 3DS service finishes evaluating an authentication attempt.
- Process — This process contains the event trigger:
- The 3DS-enabled web site, mobile app, or merchant sends a 3DS request to Galileo's ACS.
Fields
The data elements (DEs) in the field descriptions may vary by network. All fields are strings. Your field names may vary. Default fields are included in the default webhook template. See Default and optional fields for more information.
| Field | Default | Description |
|---|---|---|
| amount | X | Amount of the attempted transaction. Example: |
| bin | X | The Bank Identification Number of the card, which is the first 6–8 digits. Example: |
| cad | X | Galileo-generated card ID. Example: |
| card_program_id | X | A UUID for your card program configuration as assigned by the 3DS system. Example: |
| category | X | The type of transaction that is being attempted: |
| ch_group_id | Corporate Hierarchy group identifier. Example: |
|
| challenge_method_type | X | The method used to validate the user's identity: |
| currency | X | The currency of |
| device_channel | X | The device on which the transaction is being attempted: |
| ds_transaction_id | X | Mastercard only. Directory server transaction ID. A UUID that the merchant passes in the authorization request to link 3DS authentication and authorization data. Mastercard DE048SE66SF2. Example: |
| eci | X | The electronic commerce indicator that is sent in the authorization request. See Raw ECI values for valid values. Example: |
| error_code | X | Code to describe the error, if any. See TDSS Values for valid values. Example: |
| fraud_state | X | Whether the transaction attempt is fraudulent: |
| mcc | X | Merchant category code (DE018). Example: |
| merchant_id | X | The identifier for the merchant, as assigned by the network. Example: |
| merchant_name | X | The name of the merchant, as forwarded by the ACS. Example: |
| msg_event_id | X | Unique Galileo-generated identifier for this message. Example: |
| msg_id | X | The four-letter code to identify this event. Example: |
| protocol_version | X | The 3DS protocol version. Example: |
| risk_profile_id | X | UUID for the risk profile configuration that the ACS used. Example: |
| scheme | X | Card-network scheme: |
| state | X | Status of the 3DS authentication attempt: |
| timestamp | X | Date-time when this event was created in Mountain Standard Time (GMT -0700). Format: |
| trans_type | X | Type of transaction being attempted. See TDSS Values for valid values. Example: |
| type | X | The name of this event: |
| was_challenged | X | Whether a step-up was required: |
| was_frictionless | X | Whether the frictionless path was followed: |
| was_presented_choice | X | Whether the cardholder had the choice to accept or reject the transaction: |
Example
# three_ds_status example:
{
"amount": 35.45,
"bin": 59990000,
"cad": "12534",
"card_program_id": "03669fa5-8680-4e2e-a189-ecf74475c6bf",
"category": "PAYMENT",
"challenge_method_type": "SMS_OTP",
"currency": "EUR",
"device_channel": "APP",
"ds_transaction_id": "f38e6948-5388-41a6-bca4-b49723c19437",
"eci": "02",
"error_code": "validation_error",
"fraud_state": "NOT_FRAUD",
"mcc": "5712",
"merchant_id": "39AJKEO30634KVN3",
"merchant_name": "Amazon",
"msg_event_id": "243693",
"msg_id": "TDSS",
"protocol_version": "2.1.0 ",
"risk_profile_id": "74d754ec-1e29-4370-bc04-4ca75d5c820d",
"scheme": "MASTERCARD",
"state": "SUCCEEDED",
"timestamp": "2025-01-31 17:20:33 MST",
"trans_type": "PAYMENT",
"type": "three_ds_status",
"was_challenged": "True",
"was_frictionless": "False",
"was_presented_choice": "False"
}