> For the complete documentation index, see [llms.txt](https://docs.gameket.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gameket.io/introduction/authentication/troubleshooting.md).

# Troubleshooting

#### "Invalid merchant credentials"

* Verify your `apiKey` and `secret` are correct
* Check they haven't been rotated recently
* Confirm your account is active

#### "Too many token requests" (429)

* You've exceeded 2 tokens per hour
* Implement token caching to reuse existing tokens
* Wait before requesting another token

#### "Unauthorized" (401)

* Token has expired → request a new one
* Token was revoked (API key rotated) → get new credentials
* Bearer token in the header is malformed or missing

#### "Invalid token"

* Token signature is invalid (tampered with)
* The token is from a different merchant account
* Server was restarted (invalidates in-memory tokens)