Adyen: Missing 3DS2 fingerprint (Checkout 14_0402)

Adyen: Missing 3DS2 fingerprint (Checkout 14_0402)

TL;DR: After /payments returns IdentifyShopper, you must run the device fingerprint and send threeds2.fingerprint in the /payments/details call. Skipping straight to authorisation, or sending details without the fingerprint field, gives 14_0402.

14_0402 - Missing 3DS2 fingerprint

Steps

1. Handle the IdentifyShopper action. When /payments returns resultCode IdentifyShopper with a threeDS2 action, run the fingerprint step through the SDK or your 3DS2 implementation. Dont skip it.

   • Success check: the fingerprint step executes and returns fingerprint data.

2. Include threeds2.fingerprint in /payments/details. Send the fingerprint data plus the paymentData from the action response.

   • Success check: the details payload contains the threeds2.fingerprint field.

3. Check the response. You should get ChallengeShopper (continue to the challenge) or a frictionless authorisation, not 14_0402.

   • Success check: no 14_0402; the flow advances.

When to use this

• /payments/details fails with 14_0402 after an IdentifyShopper step.
• A custom 3DS2 integration that authorises without doing the fingerprint.

When NOT to use this

• 14_033 (the provided fingerprint is invalid). That means you sent a fingerprint and it was rejected, which is a data problem, not a missing step.
• 14_032 (provide either threeds2.fingerprint or threeds2.challengeResult). That is about sending the wrong field for the step.

Compatibility

Adyen Checkout API 3DS2 native flows, Web/iOS/Android.

Why it happens

The 3DS2 protocol requires the device fingerprint before the issuer decides on frictionless vs challenge. Adyen enforces the sequence: no fingerprint data in the details call, no onward flow.

Edge cases

• If the 3DS method notification never arrives within 10 seconds, set threeDSCompInd to N and continue; the fingerprint can still complete.
• Some test cards skip fingerprinting. If your test never hits IdentifyShopper, use a card that triggers it.

Adyen's official error-code reference lists checkout error 140402 as Missing 3DS2 fingerprint, in the family with 14032 (provide either threeds2.fingerprint or threeds2.challengeResult), 14033 (the provided fingerprint is invalid) and 14034 (invalid fingerprint field). The documented 3DS2 flow is IdentifyShopper for device fingerprinting followed by a /payments/details call carrying the fingerprint data, and omitting it is rejected. Source: https://docs.adyen.com/development-resources/error-codes/