Automating Access by Membership Status
When a member joins, renews, upgrades, downgrades, cancels, or loses access, PayBru updates the mapped Discord role so the server reflects the membership state.
Once a tier is linked to a Discord role, PayBru handles the role changes for you.
Lifecycle Events
| Event | Membership status | What PayBru does in Discord |
|---|---|---|
| New subscription | Active | Assigns the mapped Discord role. |
| Tier upgrade | Active | Swaps the member to the mapped role for the new tier. |
| Tier downgrade | Active | Swaps the member to the mapped role for the new tier. |
| Renewal succeeds | Active | Keeps the mapped role in place. |
| Payment failure | Past Due | Keeps the role during the 6-day grace period. If payment is not recovered, removes the role when membership moves to Ended. |
| Voluntary cancellation | Canceled, then Ended | Keeps the role until the paid period finishes, then removes it when access ends. |
| Refund | Ended | Removes the mapped role at the next role check. |
How the Sync Works
A member joins, renews, changes tier, cancels, or loses access after the grace period.
PayBru looks for the mapped role connected to that tier and Discord server.
If the member linked Discord and joined the server, the bot adds or removes the mapped role.
Channels controlled by that role become visible or hidden according to your Discord permissions.
The first update usually happens quickly. Larger servers can take longer when Discord slows down role changes.
If the member is not in your server yet, or has not linked Discord to their PayBru profile, PayBru keeps the expected role state and applies it when those gaps are closed.
When Access Ends
When a membership ends:
- Roles connected to that membership tier are removed.
- The member loses access to any Discord channels restricted to those roles.
- The member is not kicked from the server. They stay as a regular server member unless you remove or ban them in Discord.
A canceled paid membership can still have access until the paid period finishes. The Discord role is removed when the membership becomes Ended, not at the moment the member schedules cancellation.
Automatic Checks
PayBru checks Discord regularly so roles stay aligned even if one update was delayed.
| Check | Roughly how often | Purpose |
|---|---|---|
| Role sync | Every few minutes | Checks active members against their expected mapped roles and corrects mismatches. |
| Member presence | Every few minutes | Detects when a linked member joins the server and grants pending roles. |
| Ban sync | Every few minutes | Keeps Discord bans aligned when your community uses Discord ban syncing. |
| Permission health check | Every half hour | Confirms the PayBru bot still has the permissions and role position it needs. |
| Membership expiry check | Hourly | Removes roles after the 6-day grace period ends, or when a canceled paid period ends. |
Manual Refresh
If a role still looks wrong after the next sync:
- Open Settings > Integrations and refresh or reconnect Discord.
- Open Members and confirm the member's current membership status and tier.
- Open Tiers and re-check the Discord step on that tier.
- Ask the member to confirm Discord is still linked in Resources > My Profile > Security > Connected Accounts.
- Ask the member to confirm they are still in the creator's Discord server.
If PayBru detects a bot permission problem, the community owner is notified after a short delay so brief Discord role housekeeping does not create unnecessary noise.
Status Examples
PayBru assigns the mapped role and keeps it in sync.
PayBru cannot match the PayBru member to a Discord account yet.
PayBru waits until the linked Discord account joins the creator's server.
The bot cannot manage the mapped role until permissions or role hierarchy are fixed.