Membership Rulebook
Overview
This page lists, for each member status, whether the person can get in, when it ends, and what happens to their money and quota. Use it when you answer questions from members.
This page is the authoritative source for membership rules. The PDF edition of the rulebook is generated from this page.
For setup steps, see Membership Plans and Usage Quotas and Membership Setup Guide. For operations on the member list and the membership contract card, see Member Management.
1. The three groups at a glance
| Group | Statuses | Entry | Member price / quota | Note |
|---|---|---|---|---|
| Members | Active / Past due / Scheduled to cancel | ✓ | ✓ (△ when Past due) | Members-only ticket books and plans can be used too |
| Applying | Awaiting payment / Pending approval / Approved, awaiting payment | ✗ | ✗ | The person can withdraw before paying |
| Ended | Cancelled / Expired / Force-cancelled / Rejected | ✗ (the key is removed from people who were members) | ✗ | They can join again, except after a force cancel or blacklisting |
A member who is scheduled to cancel is a normal member until the end date. Even after they apply to cancel, entry and the member price on bookings work as usual until the end date.
2. Status list
| Status | Admin screen / member app label | When | Entry | Member price / quota | What happens next |
|---|---|---|---|---|---|
| Active | Active / Active | Paid, or using a free plan | ✓ | ✓ | The member cancels → Scheduled to cancel |
| Past due | Past Due / Payment overdue | The renewal payment is not confirmed (in the grace period) | ✓ | △ (below) | If paid → Active / If not paid → ends |
| Scheduled to cancel | Cancellation Scheduled / Cancelled (not renewing) | The member applied to cancel and is waiting for the end date | ✓ | ✓ | Cancelled on the end date / until then, the member can undo it |
| Awaiting payment | Pending Payment | Applied, before the card payment | ✗ | ✗ | Payment makes it Active (Pending approval if review is on) / the member can withdraw |
| Pending approval | Pending Approval | Waiting for the facility's approval | ✗ | ✗ | Approved / Rejected / the member can withdraw |
| Approved, awaiting payment | Approved (Pending Payment) | Approved, or with no review for on-site payment, but not yet paid | ✗ (except an existing member mid plan change) | ✗ | Payment makes it Active / the member can withdraw. There is no deadline |
| Cancelled | Cancelled | The member cancelled or withdrew, or card billing was stopped | ✗ | ✗ | The person can join again |
| Expired | Expired | No on-site renewal, and the grace period ran out | ✗ | ✗ | Recording a receipt at the front desk makes it Active again |
| Force-cancelled | Revoked / Suspended | The facility ended the membership (including blacklisting and retiring a plan) | ✗ | ✗ | — |
| Rejected | Rejected | Declined at review. Also when the facility ends an application (force cancel, blacklist, retiring a plan) | ✗ | ✗ | — |
- Past due (△): entry works. The free quota can be used only for bookings up to the end of the current period (in the on-site grace period that period has already ended, so new bookings get no free quota)
- One person can have only one "membership that has not ended" at the same facility
- If an application is left as "Approved, awaiting payment", the person cannot apply for another plan. Ask them to withdraw it, or guide them to pay
- An application stopped in the middle of the card payment (Awaiting payment) is withdrawn automatically when the person applies again at the same facility (an approved application is not; as above, they cannot apply)
- A plan's maximum number of members counts memberships that have not ended. People who are still applying take a seat too
- When you approve a plan change to a paid plan, the member becomes "Approved, awaiting payment" until they pay. In the meantime, their entry permission moves over to the new plan, but the member price and quota cannot be used
3. How joining works
The flow for each choice of "Review on joining" on the plan in the admin screen. On a plan whose payment method is "Applicant chooses", the flow follows the payment method the applicant chose.
- Applying in the member app has two steps: customer details → payment. The first payment (proration, enrollment fee, total) is shown in the customer-details step
- Monthly periods start on the 1st of each month at 00:00 (facility time)
- Monthly online payment charges the first month prorated by the day (yearly plans are not prorated)
- For on-site payment, the facility decides the amount and the period. UnlockOS only records the amount received ("Record payment" on the Membership contract card)
- To the end of this month: press "Record first payment" once and enter the amount received (prorated or full)
- To the end of next month (e.g. a full fee received from a member who joined at month end): then press "Record prepayment (1st to end of next month)" once more. If nothing more was received, enter 0
- A plan with an enrollment fee adds it to the first charge, once. Joining again after cancelling charges it again. A free plan cannot have one
- The quota is the full amount even in the first month
- A blacklisted person cannot apply (the reason is not shown)
- Bank transfer is not supported
4. When a payment is late
On-site payment (example: the October period ends 10/31, grace 7 days)
Grace is 0–31 days per plan (7 days by default). With 0 days, the member expires as soon as the month changes.
Online payment
- The length of the grace period is set in Stripe (about 2–3 weeks by default). Set Stripe's "If a payment fails" to "Cancel the subscription" or "Mark the subscription as unpaid". If you choose to leave it as is, the membership does not end
- A free plan set to monthly or yearly billing does not renew automatically. At the end of the period it goes Past due → Expired. On a plan whose payment method is online payment, you also cannot renew this free plan at the front desk. For a free plan that should last indefinitely, set it to "No expiry"
- Payment-failure notifications are off by default (see 12. Notifications on this page)
5. Cancelling (by the member in the member app)
This example is a monthly plan with a cancellation deadline day of the 20th of each month (the default). An application made on the deadline day itself counts as "by the deadline day".
The green bars are the period in which the person is still a member.
| Day the member applied to cancel | Online payment | On-site payment |
|---|---|---|
| 10/15 (before the deadline day) | Usable until 10/31. The November fee is not charged | Usable until 10/31 |
| 10/20 (on the deadline day) | Usable until 10/31 | Usable until 10/31 |
| 10/25 (after the deadline day) | Usable until 11/30. The November fee will be charged | Usable until 10/31 (the deadline day does not matter) |
| Current status / plan | When it ends after cancelling |
|---|---|
| Active, online payment (monthly) | By the deadline day → the end of this month. After the deadline day → the end of next month (next month's fee is charged) |
| Active, online payment (yearly) | The only check is whether the day of the month is on or before the monthly deadline day (default the 20th). Applying from the 21st charges the next year even when the current year has months left, and the membership continues until its end |
| Active, on-site payment | The end of the current period, regardless of the deadline day |
| Active, free plan with no expiry | Ends immediately |
| Past due | Ends immediately (Stripe billing is also stopped) |
- "The end of this month" means until 00:00 on the 1st of the next month, so the member can use the last day in full
- Reservations dated after the end date that are free because of the member benefit are cancelled when the membership ends (within 15 minutes; the member is told on the cancellation confirmation screen). While a membership is being paid for, or is approved and awaiting payment (such as a plan change), they are kept for 7 days. Stays that have already started, and reservations where money moved (such as paid options), stay as they are. Handle them at the facility if needed
6. Withdrawing an application and undoing a scheduled cancellation
| What the member wants | The member can do it | The member cannot do it (the screen says "Please contact the facility") |
|---|---|---|
| Withdraw an application (awaiting payment / pending approval / approved, awaiting payment) | Applications before payment. After withdrawing, they can apply for another plan right away | Already paid (including being processed) / waiting for a plan change of an existing member / when the payment status cannot be confirmed |
| Undo a scheduled cancellation (only before the end date) | A cancellation the member applied for. The scheduled end in Stripe is also removed | An end decided by the facility / a retired plan / a blacklisted person |
No "membership ended" notice is sent when an application is withdrawn. Any permissions the person holds in another role, such as staff, do not change.
7. Quota
A booking uses the quota of the month of the date of use. It does not use the month when the booking was made.
| Action | What happens to the quota |
|---|---|
| On 10/10, book for 11/15 | Uses 1 from the November quota (the October quota does not go down) |
| Cancel that booking inside the refund window | 1 returns to the November quota |
| Cancel that booking outside the refund window, or after it starts | Does not return |
| Change the date from 11/15 to 10/28 | Uses 1 from the October quota, and 1 returns to the November quota |
| Quota | Period it is counted in |
|---|---|
| Monthly visits | The month of the visit |
| Daily hours | Recorded on the day of check-out |
| Monthly bookings / booking hours | The month of the booking's date of use |
| Concurrent bookings | The number of future bookings the member holds now |
Quota returns on cancellation only inside the refund window
Whether the quota returns on cancellation follows the same rule as ticket books.
- It returns only when the member cancels during the period in which the reservation plan's cancellation policy gives a full refund (a reservation plan with no cancellation policy returns it any time before the start)
- It does not return when they cancel during a period with a cancellation fee (whether 50% or 100%), or after the start time
- The same applies to a change that shortens the usage time on a plan counted by hours. If they shorten it outside the refund window, the original hours are still counted
- The cancellation confirmation on the booking screen shows "Member quota: returns / does not return"
- The "Cancel" button on the admin reservation details follows the same rule (the same treatment as cancellation fees and ticket books). If you change the status to "Cancelled", or if the facility declined the application, it expired unpaid, or the payment was cancelled, the quota returns
Other
- 0 or not set means "no limit". Months are calendar months in facility time (yearly plans are also counted by month)
- When the quota is exceeded, the plan chooses "Block" or "Charge the normal plan price" (there is no separate per-overage fee). "Charge the normal plan price" only affects bookings. Check-ins beyond the visit or daily-hours limit go through with no extra charge; choose "Block" to limit them
- If the month of the new date is full, the date cannot be changed, and the original booking and quota stay as they are
- A member who is scheduled to cancel cannot use the free quota for bookings on days after the end date. A past-due member can use it up to the end of the current period, and an active member for the current period and one period ahead
- A stay that began as a member is settled as a member even if it crosses the end date
8. Refunds
| Case | Automatic refund | Note |
|---|---|---|
| Rejecting an application paid before review | ✓ Full | Stripe billing is stopped and the fee is refunded in full. The rejection notice includes a sentence about the refund |
| The member cancels | ✗ | The member can use it until the end of the period they paid for |
| Force cancel | ✗ | Billing stops. To refund, follow "Refunding an active member" below |
| Withdrawing an application that has been paid | ✗ | The member cannot do this. The facility decides how to handle it |
| On-site payment | ✗ | The facility refunds the member directly |
- If the automatic refund on rejection fails on the Stripe side, the rejection still stands and the operations team is alerted. Refund it with step 2 below
Refunding an active member
Use this when someone who is already a member needs a refund — for example, they signed up before the facility opened, or could not use it for reasons on the facility's side. UnlockOS cannot refund this on its own screens. Always do step 1, then step 2.
- Stop billing (UnlockOS) — In the admin screen, open "Members" → the person → Force cancel on the Membership contract card
- Stripe's recurring billing stops, the membership ends, and the key is removed
- Force cancel does not refund anything
- Refund (Stripe) — Open the dashboard of the Stripe account registered in Payment settings (the test environment if they paid with a test key, live if with a live key)
- Search "Transactions" for the member's email address and open the membership payment
- Click "Refund" at the top right → choose the amount (full or partial) and a reason → refund
- It usually takes 5–10 business days to reach the customer's card
Do not reverse the order. Doing only step 2 leaves the membership and Stripe's recurring billing in place, and the fee is charged again on the next billing date.
- A membership fee refunded in the Stripe Dashboard is not reflected in UnlockOS's transaction history (the fee row stays "Paid"). Check your books against Stripe's records
- A member who joined mid-month paid a prorated first fee. Finish step 1 before the next billing date (usually the 1st of next month)
9. Review, force cancel, rejection and retiring a plan
Review (approve / reject)
- Review applications from Awaiting review on the Members page. Facilities that use the Approvals page can also review them there
- Facility owners, organization owners and platform administrators can approve and reject
- A blacklisted applicant cannot be approved
- Rejecting sends the reason to the person. If the application was paid before review (Pending approval), Stripe billing is stopped and the fee is refunded in full
- An application left "Approved, awaiting payment" without being paid can be rejected from the Membership contract card on the member detail page (not an existing member's plan change). An application paid after approval (including a payment being processed) cannot be rejected. Check the payment in Stripe
Force cancel (from the Membership contract card on the member detail page)
- Stop Stripe billing (online-payment members only. Always done first)
- If it stopped → Force-cancelled. The key is removed
- If it did not stop → nothing is changed, and the reason is shown (run it again / check the payment settings / check the Stripe account)
- Facility owners, organization owners and platform administrators can do this from any status, as long as the membership has not ended
- Ending an application that never became a membership (awaiting payment, pending approval, approved awaiting payment) is recorded as "Rejected" (no ending notice is sent)
- The state "already cancelled in UnlockOS but Stripe keeps billing" does not happen
- A plan-change request that is still pending is also withdrawn
- You cannot change a member's plan directly from the admin screen. Ask the member to request a plan change
Retiring a plan
A plan that has members cannot be retired. Only if someone joined just before, that member is force-cancelled (rejected if still an application). Anyone whose Stripe billing could not be stopped is left as they are.
10. Blacklist
| What the blacklisted person tries to do | Stopped |
|---|---|
| A new membership application | ✓ |
| Approving their application (even when the facility tries to) | ✓ |
| Changing plans / undoing a scheduled cancellation | ✓ |
| Check-in (from any entrance, checked before a key is issued or a payment is taken) | ✓ |
| A new booking on the booking site | ✓ |
| Unlocking or showing the key again for a person who is already staying when they are registered | ✗ (stops from the next entry) |
| How they were registered | Current membership |
|---|---|
| From any screen (the Membership contract card on the member detail page, Blacklist screen) | Registered first, then all of the person's memberships in the ban's scope (whole organization / this facility) are ended. Members become Force-cancelled, applications Rejected. Stripe billing is stopped first, and a membership whose billing cannot be stopped is not ended (the screen says so; force cancel it from the contract card to retry). The person is not notified |
| Only "Add to Blacklist" from the Membership contract card on the member detail page | All of the person's roles at this facility (including staff roles) are also removed |
When the check cannot be made (it cannot be read temporarily), the person is not let through. Front desk and staff cannot let them through as an exception either.
11. When the key (entry permission) is removed
The key is given when the person becomes a member (when payment or approval is done). People who are still applying do not have one.
| Trigger | The key is removed |
|---|---|
| Force cancel / blacklist | Immediately |
| Cancelling while Past due / cancelling a no-expiry plan | Immediately |
| The member's own cancellation (scheduled to cancel) | On the end date (on-site and free: within 15 minutes of the end date; card: when Stripe's notice that it has ended arrives) |
| No on-site renewal | When the grace period runs out (after 7 days by default) |
| Stripe stops retrying | When Stripe's notice that it has ended arrives |
| Plan change approved | Not removed (moved over to the new plan's permissions) |
| Application withdrawn / rejected | There was no key to begin with (staff permissions and similar do not change) |
"Immediately" refers to the entry permission. A key already issued for a stay in progress stays valid until checkout.
12. Notifications
| Event | Member | Default (member) | Owner | Default (owner) |
|---|---|---|---|---|
| A membership application was received | ✓ | On | ✓ | Off |
| A member joins | ✓ | On | ✓ | On |
| Approval that leaves the application awaiting payment (with guidance for the chosen payment method) | ✓ | Always sent | — | — |
| Rejection (with the reason) | ✓ | On | — | — |
| A cancellation was received | ✓ | Off | ✓ | Off |
| A membership ended (the end date of a scheduled cancellation / force cancel / Stripe stopped billing / plan retired) | ✓ | Off | ✓ | Off |
| A membership fee payment failed | ✓ | Off | ✓ | Off |
| Application withdrawn / ended through the blacklist / the monthly on-site expiry | — | Not sent | — | Not sent |
- An approval that activates straight away sends only "A member joins"
- The facility can edit the wording of the rejection and the application-received messages in Notification Workflow Help
- For notifications that are off by default, check the wording in Notification Workflow before you turn them on
- Emails to members are sent with the facility name as the sender
13. When changes on the facility side reach members
| What the facility did | Effect on members |
|---|---|
| Turned on pre-opening | New sign-ups and check-ins stop (members cannot get in either; only staff accounts can). Members can still cancel and view the member app. Monthly billing of existing members does not stop (Base Settings) |
| Switched Payment settings from test to live (or to another test account) | Memberships that joined during testing end once an organization owner (or a platform administrator) confirms (the person is not notified). They are recorded as Force-cancelled or Rejected |
| Tried to switch from live to test, to another account, or to remove the settings | Not allowed while members are being billed |
| Deleted the facility | Neither cancelling from the member app nor force cancel from the admin screen works any more. Stop the billing in Stripe |
- When a member tries to delete their UnlockPass account, it is refused while a membership has not ended. Ask them to cancel the membership first
- Lesson tuition and member tiers are separate from memberships. The rules on this page do not apply to them
14. Frequently asked questions
Q: The member cancelled but was charged for next month
This happens when a member on online payment cancels after the deadline day. They can use the membership as a member until the end of next month.
Q: The member applied to cancel and can no longer get in
A member who is scheduled to cancel is a member until the end date. Check that the end date has not passed.
Q: The member wants to keep the membership after all
Before the end date, the member can undo the scheduled cancellation in the member app.
Q: The card is stopped and they cannot pay. They want to quit
Even when the status is Past due, the member can cancel right away in the member app.
Q: The member wants to cancel an application
Before payment, they can withdraw it in the member app. If they have already paid, handle it at the facility.
Q: Next month's booking reduced this month's quota
It does not. A booking uses the quota of the month of the date of use.
Q: The member cancelled but the quota did not return
The cancellation was outside the refund window, or after the start time. As with ticket books, the quota returns only when the cancellation is made during the period in which the reservation plan's cancellation policy gives a full refund.
Q: Next month's booking disappeared after the member cancelled
A booking that was free because of the member benefit is cancelled when the membership ends. If the person keeps using the facility, they need to book again (at the regular price).
Q: A member joined at month end and should be able to use it until the end of next month
For on-site payment, after recording the receipt press "Record prepayment" once more (enter 0 if nothing more was received). Online payment prorates the first month, so the regular charge starts on the 1st of next month.
Q: The member forgot the on-site renewal
They can get in during the grace period. Even after the membership expires, recording a receipt at the front desk brings it back.
Q: Billing continues after a force cancel
It does not happen with force cancel, blacklisting or retiring a plan (a membership whose Stripe billing cannot be stopped is not ended). If blacklisting says the Stripe cancellation failed, force cancel the member from the Membership contract card on the member detail page to retry.
Q: During pre-opening, a member says they cannot get in
During pre-opening only staff accounts can get in. Turn pre-opening off, or invite the person as staff. Monthly billing continues, so if they should not be charged until opening, follow 8. Refunds on this page.
Q: The facility wants to refund a member who joined before opening
Follow "Refunding an active member" in 8. Refunds on this page (force cancel → refund in Stripe).
Q: Members disappeared after switching from test to live
Memberships that joined during testing end when you switch to live (test payments cannot carry over). Ask them to apply again on live.
Related Pages
- Membership Plans and Usage Quotas
- Membership Setup Guide
- Member Management
- Blacklist Management
- Notification Workflow Help
Last updated: 2026-11-17 - Merged the PDF edition of the rulebook into this page (#6120). Drew joining, late payment, cancellation and quota as figures, and added the notification defaults (the application-received message reaches the member, on by default), that a blacklisted applicant cannot be approved, that an application paid after approval cannot be rejected, enrollment fees and the maximum number of members, and how facility-side changes reach members (pre-opening, switching payment settings, deleting the facility)
Previously updated: 2026-11-05 - Renamed the sign-up path table rows to match the "Review on joining" choices in the admin screen (#5818)
Previously updated: 2026-10-30 - The refund table now matches the product (rejecting an application paid before review refunds it in full automatically, #4859). Added how to refund an active member (force cancel → Stripe Dashboard) (#5656)
Previously updated: 2026-10-08 - On-site sign-ups at month end are the facility's call (record once for a prorated month, or press "Record prepayment" once more to run to next month's end) (#4683)
Previous update: 2026-10-05 - Force cancel, blacklisting and rejection now point to the Membership contract card on the member detail page and Awaiting review on the Members page (the old Members / Pending Approvals / Awaiting Payment tabs are gone, #4876 stage 4)
Previous update: 2026-10-04 — New page (#4844). Reflects cancelling free reservations after the membership ends (#4873) and returning quota on cancellation only inside the refund window (#4871). Unified endings (#4853: ending an application records Rejected, a ban from any screen ends memberships, an unpaid approved application can be rejected)