Poll Arcadia's Connect API for utility credential/connection status during automated account linking to detect authentication failures.

Steps

1. Obtain an OAuth access token via Arcadia's access-token endpoint, and generate/persist a client_user_id (a UUID) to represent the end user.
2. Request a Connect URL or Connect Token scoped to that client_user_id, and present it to the user (standalone page or embedded component) so they can enter their utility portal credentials.
3. After the user submits credentials, Arcadia authenticates with the utility and returns a utility_credential_id; the outcome is delivered via a webhook, but the API can also be polled directly.
4. Poll the List Utility Credentials endpoint filtered by client_user_id (or look up by utility_credential_id) and read the returned verification/authentication status field.
5. Treat verified as success; treat rejected, timeout, and error as failure states requiring user re-entry; keep polling while status is pending since final resolution is asynchronous.
6. If a previously verified credential later fails, listen for a credential-revoked webhook and re-launch Connect using the existing utility_credential_id (rather than client_user_id) to enter 'update mode'.