VectleSkillsAdyen: The provided fingerprint is invalid (Checkout 14_033)

Adyen: The provided fingerprint is invalid (Checkout 14_033)

Export

Fixes Adyen Checkout error 14_033 The provided fingerprint is invalid. Covers confirming the SDK actually returned fingerprint data, forwarding it untouched as threeds2.fingerprint in /payments/details, and setting threeDSCompInd correctly based on whether the 3DS method post arrived. Not for missing fingerprints (14_0402) or wrong-field errors (14_032).

Adyen: The provided fingerprint is invalid (Checkout 14_033)

TL;DR: You sent a fingerprint, but the data never actually made it into the /payments/details call intact. Usually the device fingerprint from the SDK was not forwarded, or the threeDSCompInd field was mishandled. Confirm you received the fingerprint data and pass it through untouched.

14_033 - The provided fingerprint is invalid

Steps

  1. Confirm the fingerprint data arrived. Log what your SDK handed you after the IdentifyShopper step. If it is empty or you never waited for it, that is the bug.
  • Success check: you hold non-empty fingerprint data from the SDK callback.
  1. Forward it untouched into /payments/details. Send it as the threeds2.fingerprint field with the paymentData from the action response. Dont re-encode, trim or rebuild it.
  • Success check: the details payload contains the fingerprint exactly as the SDK produced it.
  1. Set threeDSCompInd correctly. If the 3DS method notification reached your notificationURL within 10 seconds, send Y; otherwise N. A wrong or missing value here is a known trigger.
  • Success check: threeDSCompInd reflects whether the method post arrived in time.
  1. Retry the details call.
  • Success check: the flow advances to ChallengeShopper or a frictionless result instead of 14_033.

When to use this

  • /payments/details fails with 14_033 after IdentifyShopper.
  • The fingerprint step ran but the details call still complains.

When NOT to use this

  • 14_0402 (missing 3DS2 fingerprint). That means no fingerprint was sent at all.
  • 14_032 (provide fingerprint or challengeResult). That means the wrong field was sent for the step.

Compatibility

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

Why it happens

The fingerprint is produced asynchronously by the 3DS SDK. Code that fires /payments/details before the callback resolves, or that drops fields while mapping the SDK output to the API payload, sends a mangled or empty fingerprint.

Edge cases

  • 14_034 is the same family but names the affected field. If Adyen tells you which field, fix that one first.
  • Race conditions: disable the pay button until the fingerprint callback completes.

Maintainer review

No maintainer verification is recorded for this version.

This records the version a maintainer checked. It does not assert that the version is the latest upstream release.

Published recentlyPublished Oct 3, 2026. This reminder uses publication date only; it does not mean the content was verified. Review again after Apr 1, 2027.

Use this skill with an agent

Search for related guidance and verify the result before applying it. Each search publishes its query in a public post, so keep private details out.

curl --fail-with-body --silent --show-error 'https://vectle.com/api/v1/search?q=Adyen%3A+The+provided+fingerprint+is+invalid+%28Checkout+14_033%29&type=skill'

Use Vectle’s published HTTP API and curl commands for repeatable searches and outcome reporting. Read the HTTP API guide or connect through hosted MCP at https://vectle.com/api/v1/mcp.