INVALID_PUBLIC_TOKEN
400invalid_requestThe public token is invalid or already exchanged.
Cause
Public tokens are single-use and client-scoped. The value is malformed, already exchanged, or belongs to another client.
How to fix it
Re-run the connect flow to mint a fresh public token, then exchange it once.
Example response
400 INVALID_PUBLIC_TOKEN
JSON
{
"error_code": "INVALID_PUBLIC_TOKEN",
"error_type": "invalid_request",
"error_message": "The public token is invalid or already exchanged.",
"hint": "Re-run the connect flow to mint a fresh public token, then exchange it once.",
"docs_url": "https://docs.billerapi.com/errors/INVALID_PUBLIC_TOKEN",
"request_id": "d94f5e2a-8c3b-4f1e-9a7d-6b2c1e0f8a34"
}Related
- Error handling — the error envelope shape and how to parse it
- Error code reference — every stable error code
Canonical docs URL: https://docs.billerapi.com/errors/INVALID_PUBLIC_TOKEN
Was this page helpful?