๐ข Docs Update โ Account Linking Failure Modes
We've expanded the Social SDK guides to cover what happens when a Discord-to-game account link is severed โ whether by a ban, an unmerge, or an OAuth2 token revocation.
What's new:
๐จ 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 530017 until the ban lifts (or indefinitely for permanent bans).
https://docs.discord.com/developers/discord-social-sdk/development-guides/using-provisional-accounts#ban-driven-unmerge
๐ Out-of-Band Revocation โ Covers the auth-side signals (APPLICATION_DEAUTHORIZED webhook + invalid_grant on refresh) when a user removes your app from Discord or gets their account banned.
https://docs.discord.com/developers/discord-social-sdk/development-guides/account-linking-with-discord#out-of-band-revocation
๐ When Refresh Fails โ Documents the /oauth2/token response when the underlying token has been deleted, and recommends treating invalid_grant as equivalent to receiving the webhook.
https://docs.discord.com/developers/discord-social-sdk/development-guides/account-linking-with-discord#when-refresh-fails
๐ Check out the updated docs in the Social SDK development guides!