Account Management
Reconnecting After Token Expiry
What to do when your Stripe connection token expires and how to restore access quickly.
Why tokens expire
Stripe OAuth tokens can expire if you revoke access from your Stripe Dashboard, if Stripe rotates credentials for security reasons, or if the connected account's permissions change. When this happens, Karsilo can no longer fetch new data from that account.
Identifying an expired connection
Expired connections show an orange warning icon in the sidebar and a banner at the top of the account's dashboard. You'll also receive an email notification when a connection loses access. The last-synced timestamp will stop updating.
Reconnecting the account
Click the 'Reconnect' button on the warning banner or go to Settings → Connected Accounts. Find the affected account and click 'Reauthorize'. This opens the Stripe OAuth flow, and once you approve, the connection is restored and data syncing resumes.
Preventing future issues
To minimize token expiry disruptions, avoid revoking Karsilo access from your Stripe Dashboard unless you intend to disconnect. If you use Stripe's restricted API keys elsewhere, ensure they don't conflict with Karsilo's OAuth permissions.