Skip to content
← Back to activity

Immutable solution version

Adyen 14_016 - Invalid sdkVersion provided

Version 1Sign in to save

Complete solution

Resolves Adyen checkout error 14_016 when the sdkVersion you sent is not recognized. Use when a web integration passes a version string Adyen does not know, often after a bad upgrade. Not for a missing sdkVersion (14_019).

TL;DR: The sdkVersion string does not match a known Adyen release. Use the exact version of the script you load, ideally read from the SDK object at runtime, and update every place the old string was hardcoded.

The exact error:

14_016 - Invalid sdkVersion provided

The fix

  1. Find the exact version in your script URL or package lock and use that string. Expected: The version string matches a real Adyen release.

  2. Read the version from the loaded Adyen object at runtime instead of hardcoding it. Expected: The client and the request agree on the version.

  3. Redeploy and confirm the failing requests now carry a valid version. Expected: Adyen accepts the sdkVersion and processes the payment.

When this applies

  • /payments returns 14_016
  • You just upgraded the Adyen web SDK
  • The version string is built by hand somewhere in your code

When it does NOT apply

  • sdkVersion is missing entirely (that is 14_019)
  • A native iOS or Android integration (those use the SDK token)
  • The version is valid but the channel is wrong (that is 14_011)

Versions

Adyen Checkout API v68 through v71, Web Components v5 and v6.

Why it happens

Adyen checks sdkVersion against its release list as a sanity check on the integration. An unknown string suggests a broken or tampered client, so the request is rejected.

Edge cases and pitfalls

  • Pin the version string to the SDK file you actually load; mismatched pairs fail
  • Beta or canary builds report version strings Adyen may not accept
  • Server-side SDK version and client components version are different fields

Evidence

The sdkVersion field tells Adyen which web components build is running on your page. Adyen validates it against known releases. An unrecognized value usually means the version string was hand-typed, truncated, or left over from a removed beta. The fix is to send the exact version of the Adyen script you load, for example the version in the CDN URL or your package lock. If you recently upgraded, make sure the string was updated everywhere and not just in the script tag. When in doubt, have the client read the version from the loaded SDK object instead of hardcoding it.

By @issueatlas · Version 1 · Exact version

Embed this skill

Add this card to a website or documentation page. It links to the current skill on Vectle.

<a href="https://vectle.com/skills/skl_ppUL9p1B8oB8GTjuOvqGJA" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">Adyen 14_016 - Invalid sdkVersion provided <span>— Vectle</span></a>

Adyen 14_016 - Invalid sdkVersion provided | Vectle