Troubleshooting

Possible Causes

• Stripe account is restricted or requires verification
• OAuth authorization was cancelled or failed
• Network connectivity issues during connection
• Stripe account not properly configured for Connect

Solutions

1. Check your Stripe dashboard for account restrictions or verification requirements
2. Try the connection process again, ensuring you complete the full OAuth flow
3. Verify your Stripe account is in a supported country/region
4. Contact Stripe support if your account is restricted

Possible Causes

• Webhook endpoint issues
• Network connectivity problems
• Stripe API key configuration issues
• Account permissions insufficient

Solutions

1. Wait 2-3 minutes and try "🔍 Verify Connection" again
2. Check your internet connection and try again
3. Ensure your Stripe account has proper permissions enabled
4. Contact support if verification consistently fails

Possible Causes

• Bot not properly added to server
• Missing Administrator permissions
• Bot offline or experiencing issues

Solutions

1. Ensure PayBot is added to your server with proper permissions
2. Verify you have Administrator permissions in the server
3. Check if PayBot appears online in the member list
4. Try reinviting the bot if issues persist

Possible Causes

• Incomplete OAuth flow
• Webhook delivery failures
• Account configuration issues

Solutions

1. Reconnect your Stripe account through /setup
2. Check Stripe webhook settings in your dashboard
3. Ensure your account is properly configured for Connect
4. Contact Stripe support for account-specific issues

Possible Causes

• Membership tier is archived or inactive
• Stripe account issues or restrictions
• Payment method problems

Solutions

1. Use /setup and click "🔍 Verify Connection"
2. Ensure the membership tier is not archived
3. Check Stripe dashboard for account issues or restrictions
4. Have the member try a different payment method

Possible Causes

• Stripe account not fully connected or verified
• You opened "Add Recurring" instead of "Add One-Time"

Solutions

1. One-time payments work on every server, free to install
2. Run /setup and click "🔍 Verify Connection"
3. Use /setup → "Add One-Time" to create the payment
4. Contact support if the option still doesn't appear

Possible Causes

• Member's payment method expired
• Insufficient funds
• Card declined by bank
• Stripe account issues

Solutions

1. Check Stripe Dashboard for failed payment details
2. Contact the member to update their payment method
3. Members can update payment method through Stripe customer portal
4. Monitor Stripe for retry attempts and outcomes

Possible Causes

• Complex subscription changes
• Timing of subscription modifications
• Currency conversion issues

Solutions

1. Check Stripe Dashboard for detailed billing information
2. Contact Stripe support for complex proration issues
3. Ensure subscription changes happen at appropriate times
4. Verify currency settings are correct

Most Common Cause

PayBot's role is below membership roles in Discord's role hierarchy

Solution

1. Go to Server Settings > Roles
2. Find PayBot's role in the hierarchy list
3. Drag PayBot's role above all membership roles
4. Test with a new subscription

Symptoms

• Error messages about insufficient permissions
• Roles not being assigned or removed
• Bot cannot modify member roles

Solutions

1. Go to Server Settings > Roles
2. Ensure PayBot has "Manage Roles" permission enabled
3. Check that the permission is enabled for the channels where commands are used
4. Reinvite PayBot with correct permissions if needed

Symptoms

• Subscribers not receiving roles
• Error messages about missing roles
• Role assignment failures

Solutions

1. Recreate the missing Discord role with the same name
2. In /setup → Manage Pricing → Edit, click "Change Role"
3. Select the recreated role from the dropdown
4. Test role assignment with a new subscription

Possible Causes

• Role hierarchy issues
• Bot temporarily offline during cancellation
• Discord API delays

Solutions

1. Check that role hierarchy is still correct
2. Manually remove roles from affected members if needed
3. Wait a few minutes for Discord API synchronization
4. Contact support if issue affects many members

Possible Causes

• Temporary Discord API issues
• Bot server maintenance
• Network connectivity problems
• Bot token issues

Solutions

1. Wait 5-10 minutes and check again
2. Check Discord's status page for API issues
3. Verify bot token is still valid
4. Contact support if bot remains offline for extended period

Possible Causes

• Bot lacks required permissions
• Channel permission restrictions
• Command cooldowns or rate limits
• Bot server overload

Solutions

1. Ensure bot has all required permissions
2. Check channel-specific permissions
3. Try the command in a different channel
4. Wait a minute and try again

Required Permissions

• Manage Roles - For automatic role assignment
• Send Messages - To respond to commands
• Use Slash Commands - For /setup and /subscription
• Embed Links - For rich embeds in responses
• Read Message History - For context in threads

Solutions

1. Go to Server Settings > Roles
2. Find PayBot's role and enable missing permissions
3. Ensure permissions are enabled for the specific channels
4. Reinvite the bot if permissions cannot be corrected

Possible Causes

• Bot was kicked or banned
• Server ownership changed
• Bot token invalidated

Solutions

1. Check if PayBot appears in the server member list
2. Use the invitation link to re-add the bot
3. Ensure you're the server owner or have Administrator permissions
4. Contact support if re-invitation fails

Possible Causes

• Bot lacks proper permissions
• Subscription not found in Stripe
• Database synchronization issues

Solutions

1. Verify bot has "Manage Roles" permission
2. Check Stripe Dashboard for subscription status
3. Contact support for database sync issues
4. Have member cancel directly in Stripe if bot method fails

Possible Causes

• Webhook delivery failures
• Network connectivity issues
• Stripe API problems
• Database connection issues

Solutions

1. Check Stripe webhooks in your dashboard
2. Verify webhook endpoint is accessible
3. Contact support for webhook configuration help
4. Monitor Stripe events for delivery failures

Possible Causes

• Multiple subscription records
• Failed cancellation attempts
• Webhook processing duplicates

Solutions

1. Check Stripe Dashboard for duplicate subscriptions
2. Contact support to identify and resolve duplicates
3. Review payment history for any anomalies
4. Request refunds for any erroneous charges

Possible Causes

• Server is on an earlier monthly plan that caps subscribers
• A plan change has not finished processing yet

Solutions

1. New communities install free with no subscriber caps
2. On a legacy plan, check your current limit in /setup
3. Contact support to talk through your options