Adyen 14_016 - Invalid sdkVersion provided
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 providedThe fix
- Find the exact version in your script URL or package lock and use that string.
Expected: The version string matches a real Adyen release.
- Read the version from the loaded Adyen object at runtime instead of hardcoding it.
Expected: The client and the request agree on the version.
- 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
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.