What this module does
Upendo Membership Manager is the staff administration area for paid memberships on one website. It connects the website to Stripe, defines membership plans and prices, maps paid plans to website roles, links website users to Stripe Customers, and helps staff review webhook and account-link problems.
Members do not use this screen. Separate member-facing pages handle joining, renewal, billing, and membership status.
Who can use it
The module is intended for Site Admins. Access still depends on the website permissions assigned to the module. Superusers can use it when they have access to the module, but this screen is not a cross-portal host manager. It works with the current website.
General content editors, ordinary members, and public visitors should not use this module. Upendo Clients and other elevated staff need the same module access and Site Admin-level responsibility before changing billing or role settings.
Main areas
- Dashboard: Counts plans, prices, member accounts, webhook events needing review, and link attempts needing review.
- Stripe Settings: Stores portal-level Stripe keys, mode, currency, cancellation behavior, grace period, and email-sync choices.
- Plans & Stripe Prices: Creates membership plans and maps Stripe Price IDs to paid website roles.
- Status Role Mappings: Assigns roles for Past Due Grace, Expired, and Canceled states.
- Member Account Links: Finds local users and their Stripe Customer links.
- Webhook Review: Reviews Stripe events and processing results.
- Link Attempt Review: Reviews uncertain matches between Stripe Customers and local member accounts.
How membership status works
Stripe events update local membership records. The module can map a subscription to states such as Active, Past Due Grace, Cancel At Period End, Canceled, and Expired. The role mappings decide which website role is applied for selected states.
The grace-period setting gives staff time to resolve a failed payment. A value of zero means no grace period. The period can count calendar days or business days, depending on the setting.
Test and live mode
Use Test mode while setting up and checking checkout, webhooks, prices, and role assignments. Use Live mode only after the live Stripe keys, webhook endpoint, and live prices are ready. Never mix test Price IDs with live mode or live Price IDs with test mode.
Important safety rules
- Treat secret keys and webhook signing secrets as private.
- Leave an existing secret field blank when you want to keep the saved encrypted value.
- Confirm the correct portal before changing settings.
- Do not delete a price mapping that has subscription history; deactivate it instead.
- Confirm the website role before connecting an active paid price.
- Review email mismatch warnings before linking a Stripe Customer.
- Review webhook and link-attempt notes because they are shared with other administrators.