ECI codes

ECI codes
ECI value represents authentication, affects authorization and liability protection

ECI value indicates the level of authentication performed on the transaction, which is forwarded to the authorization request and determines whether the transaction receives liability protection.

To get three_ds object with eci value, use check order status API request, real-time updated card order Webhook notification, or any card payment response.

Additionally, it is possible to retrieve the three_ds object in one of the processing operations responses under certain conditions.

Visa, American Express, JCB, Discover/Diners, Cartes Bancaires (VISA), UPI

ValueDescription
05Cardholder authentication is successful.
06Authentication was attempted but could not be completed. The ECI 06 value can only be used to indicate that authentication was attempted.
07Non-authenticated e-commerce transaction.
In practice, this usually indicates that full 3DS authentication was not completed for this authorization attempt. At the same time, payment can still be approved by the issuer. Approval status and 3DS authentication status are different outcomes, so a successful payment with ECI 07 is possible.

Mastercard, Cartes Bancaires (Mastercard)

ValueDescription
003DS authentication either failed or could not be attempted. Possible reasons include either the card or its issuing bank not yet participating in 3DS or the cardholder running out of time to authorize.
013DS authentication was attempted but could not be completed. Possible reasons include either the card or its issuing bank having yet to participate in 3DS or the cardholder running out of time to authorize.
023DS authentication is successful. Both card and issuing bank are secured by 3DS.
04Data share only, non-authenticated e-commerce transaction, but merchants have chosen to share data via the 3DS flow with the issuer to improve authorization approval rates.
06Acquirer exemption.
07Recurring payments may apply to initial or subsequent transactions. If this value is received on initial recurring payments, the merchant has a liability shift. Subsequent transactions are considered as MIT and liability remains with the merchant.

For risk and reconciliation decisions, always evaluate ECI together with the final payment status and the available 3DS flow value.


ECI for digital wallets

Guide
Apple Pay offers a secure and convenient payment option for iOS device owners.
Apple Pay
and Guide
Google Pay enhances checkout experiences on Android and web platforms.
Google Pay
handle the ECI value to determine transaction authentication and liability in case of fraud.

Apple Pay

Merchants that Guide
Decrypt Apple Pay tokens and process them securely for payments.
decrypt
Apple Pay tokens on their side must send the ECI code when initiating an Apple Pay transaction without it being altered or hardcoded.

Apple Pay supports liability shift globally for all major networks. However, for Visa, the liability shift applies globally only to devices running iOS 16.2+ or European-issued cards for earlier iOS versions.

Google Pay

Google Pay supports liability shift to issuers for qualified facilitated transactions that use Mastercard and Visa Android device tokens. For non-EU Visa cards, additional actions are required by merchants.

Liability shift moves fraud responsibility from the merchant to the issuing bank. Eligible Visa transactions carry ECI 05 after the token is Guide
Decrypt Google Pay tokens and process them securely for payments.
decrypted.

You can opt into liability shift Reference through the Google Pay & Wallet console. European merchants are automatically covered by a Visa exception with liability protection for eligible transactions made with the cards issued by European issuers.

You should check with your PSP to verify if the liability shift applies.

Looking for help? Contact us
Stay informed with Changelog