Automating Access by Membership Status
Once a tier is linked to a Discord role, PayBru handles the role changes for you.
Lifecycle Events
PayBru updates roles when membership status changes.
| Event | What PayBru Does |
|---|---|
| New subscription | Assigns the mapped Discord role within seconds. |
| Tier upgrade | Updates the member's Discord role to match the new tier. |
| Tier downgrade | Swaps roles to match the new tier. |
| Renewal (successful payment) | Role stays in place - no action needed. |
| Payment failure | Membership moves to PastDue status. Roles stay in place for 3 days. If payment is not recovered, roles are removed. |
| Voluntary cancellation | Role access is removed according to the membership access rules. |
| Refund / chargeback | Role is revoked immediately. |
How the Sync Works
- A membership event fires on PayBru (e.g., new subscription).
- PayBru checks the Discord role mapped to that tier.
- PayBru asks Discord to add or remove the role.
- The member's Discord permissions update instantly.
The first update usually happens within seconds. Larger servers can take longer when Discord rate limits role changes.
When Access Ends
When a membership expires or is cancelled:
- Roles connected to the lost membership tier are removed.
- The member loses access to any channels restricted to removed roles.
- The member remains in the server - they are not kicked automatically.
Automatic Checks
PayBru runs background checks to keep roles accurate:
| Service | Interval | Purpose |
|---|---|---|
| Role sync | Every 5 minutes | Checks active members against their expected roles and corrects mismatches. |
| Member count sync | Every 30 minutes | Updates community member counts displayed on dashboards. |
| Ban sync | Every 5 minutes | Synchronizes ban lists across connected communities. |
| Health check | Every 30 minutes | Verifies bot permissions are intact. |
| Membership expiry check | Every 1 hour | Removes roles after the 3-day grace period ends. |
Manual Checks
If a role still looks wrong after the next sync, open Settings > Integrations > Connection and refresh the bot status. Then check the member's tier in Members and the tier's Discord step in Tiers.
Notifications
Enable Discord Sync Notifications in your integration settings if you want role change summaries in a channel.
See also: