New documentation covering what happens when a Discord account is banned, when OAuth2 tokens are revoked, and how to design account linking for resilience.
We've expanded documentation across the Social SDK guides to cover what happens when the Discord-to-game account link is severed — whether by a Discord account ban, an explicit unmerge, or an OAuth2 token revocation. Highlights:
- Ban-Driven Unmerge documents the full lifecycle when a user's Discord account is banned: tokens are deleted immediately, a new cross-platform-restricted provisional account is created carrying the original external identity, and merge attempts return error
530017until the ban lifts (or, for permanent bans, indefinitely). - Out-of-Band Revocation describes the auth-side observable signals (
APPLICATION_DEAUTHORIZEDwebhook +invalid_granton refresh) when a user removes your app from Discord or has their account banned. - When Refresh Fails documents the
/oauth2/tokenresponse when the underlying token has been deleted, and recommends treatinginvalid_grantas equivalent to receiving the webhook.