Documentation Knowledgebase

This area helps us show you how to use our features to grow your business.

Membership Manager

Troubleshoot a Membership Sync Problem

Diagnose a membership sync problem in Membership Manager by checking the portal, Test or Live mode, webhook secret, review tabs, account links, price mappings, membership status, and grace-period settings in order.

Updated

Check in this order

  1. Confirm the current portal is the correct website.
  2. Confirm Test or Live mode matches the Stripe keys and Price IDs.
  3. Check that the webhook signing secret is saved and belongs to the endpoint sending events.
  4. Check the Webhook Review tab for a Needs Review or Error result.
  5. Check the Link Attempt Review tab for an uncertain customer match.
  6. Search Member Account Links for the website user and Stripe Customer ID.
  7. Confirm the Stripe Price ID is mapped to the correct plan and active website role.
  8. Check the local membership status and current period end.
  9. Review the grace-period and cancellation settings.
  10. After fixing the cause, run a safe test and record the review note.

An unmatched customer, missing account link, wrong portal, wrong mode, or missing Price mapping can leave an event in Needs Review. Do not manually change a member’s role until the account and subscription facts are confirmed.