Skip to content
Tollgate Docs

← Back to catalog

MODE_MISMATCH

Message. Client/server Tollgate mode mismatch (production vs testnet)

Hint. Check TOLLGATE_MODE on both sides of the call. Test-mode clients must target a test-mode facilitator; production keys only work against production.

Wire shape

{
  "error": {
    "code": "MODE_MISMATCH",
    "message": "Client/server Tollgate mode mismatch (production vs testnet)",
    "hint": "Check TOLLGATE_MODE on both sides of the call. Test-mode clients must target a test-mode facilitator; production keys only work against production.",
    "docsUrl": "https://docs.tollgatepay.com/errors/mode-mismatch"
  }
}

Canonical URL

https://docs.tollgatepay.com/errors/mode-mismatch — this URL is hard-coded into the 402/403/451 docsUrl field. It is stable; renaming the slug requires a migration plan.

Related codes