BACKGROUND_NOT_ELIGIBLE
409invalid_requestThe link token cannot be backgrounded now.
Cause
The token is in a non-backgroundable state (still recording a login script, already completed, or a lost conditional write).
How to fix it
Complete or restart the connect flow before backgrounding.
Example response
409 BACKGROUND_NOT_ELIGIBLE
JSON
{
"error_code": "BACKGROUND_NOT_ELIGIBLE",
"error_type": "invalid_request",
"error_message": "The link token cannot be backgrounded now.",
"hint": "Complete or restart the connect flow before backgrounding.",
"docs_url": "https://docs.billerapi.com/errors/BACKGROUND_NOT_ELIGIBLE",
"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/BACKGROUND_NOT_ELIGIBLE
Was this page helpful?