REDIRECT_URI_NOT_REGISTERED

Cause

A hosted link token was minted with a redirect_uri that is not in the authenticated client’s registered redirect_uris. The hosted connect page top-navigates to redirect_uri, so an unregistered value is refused at mint (open-redirect guard).

How to fix it

Register the URI via PUT /iam/clients/:id { redirect_uris }, then retry.

Example response

{
  "error_code": "REDIRECT_URI_NOT_REGISTERED",
  "error_type": "invalid_request",
  "error_message": "The redirect_uri is not in your registered allowlist.",
  "hint": "Register the URI via PUT /iam/clients/:id { redirect_uris }, then retry.",
  "docs_url": "https://docs.billerapi.com/errors/REDIRECT_URI_NOT_REGISTERED",
  "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