Memberships

A membership that renews, one that runs for a fixed time and stops, and what the app can and cannot know about renewals.

A product becomes a membership when you give it a Membership name, from the Repose card on its product page or by choosing Membership in New offer. While someone’s membership is running they book without spending a credit, up to one booking per location per day, or up to the bookings a week you set.

Repose runs the weekly payment itself. It writes the payment plan on the membership product and asks Shopify to take each payment. Shopify still holds the card, runs checkout and takes the money, and Repose never sees card details. You do not need a separate subscriptions app.

Two fields do the work:

Field on the product What it means
Membership name The name of the membership. Anything non-blank makes the product a membership. Customers and staff see it.
Days of access per payment How many days of access one payment buys. 7 for weekly. Blank means 7.

Memberships need the Pro plan

Selling a membership is part of the Pro plan. Free and Standard sell single visits and packs of visits. It does not matter who takes the payments or whether the membership renews: any product with a Membership name counts.

On Free or Standard:

  • In the app, you cannot set a membership up. New offer shows the Membership choice switched off, and the Repose settings on a product will not make it a membership. Both say memberships need Pro and send you to Plan.
  • At checkout, a customer cannot buy one. Where the checkout check runs, checkout stops the order before any money is taken and tells the customer memberships are not available to buy right now. The Membership plan block and the booking block show the membership as not for sale.
  • If a membership order is paid anyway, the customer gets their membership. The checkout check does not run on every store. Repose never takes money and gives nothing, so the membership is granted as normal and a warning appears in the app saying a membership was sold and your plan does not include them. The one exception is an order that breaks an offer limit, such as a second membership for the same customer. Repose refunds that order in full whatever your plan. See Offers.

If you have members and then leave Pro, nothing happens to them. They keep their access and their renewals keep coming through, because a renewal does not go through checkout. Only new sales stop. Move back to Pro and it is on sale again within a few minutes, with nothing to set up again. Development stores are treated as Pro.

A membership that renews

There are two ways, and you can use either, or both on different products. Once an order is paid, Repose treats them alike: the paid order is what grants access, whoever took the payment.

Repose takes the payments

  1. Create the product in Shopify.
  2. Open the product, then More actions, then Repose settings.
  3. Choose Membership and give it a Membership name, for example Unlimited.
  4. Set Days of access per payment to 7, 14, 21 or 28. That is also how often the member is charged, so the payment and the access cannot disagree.
  5. Under Membership payment, turn on Take payments through Repose and set the Price each payment. Optionally set an Intro price and how many payments are at the intro price, counting the one at checkout, and a number of Minimum payments. The Purchase options card on the product page opens the same section.

Repose writes the payment plan itself and says “Billed every week” (or “every 2 weeks”) on the product page, in the cart and at checkout. A change to the price applies to new members. Members who have already joined keep the price they joined on.

Saving the membership payment also makes the product sold only with its payments. Shopify then takes it off every sales channel except your online store, so it cannot be rung up on its own at the till. If you turn the membership payment off, Repose puts the product back on the channels it was on. A membership order that arrives without its payments anyway, for example from an old cart, is refunded in full and gives no membership.

The Membership plan block

Add Membership plan to your theme’s membership product page, next to the price and the buy button. It states the price, the intro price, the minimum term, when the membership starts and how to cancel, in plain words, and adds the plan to the cart. It has its own Join button. If the block sits beside your theme’s own Add to cart button, turn off Show a Join button in the block settings, and Add to cart then carries the plan.

When a customer cannot join, the block says why and turns off its Join button and the theme’s Add to cart for that product. For example, a signed-in member sees “You already have a membership on this account”.

The member’s page

In their own customer account the member opens Manage your membership from the order and sees Your membership: the next payment, the price now and later, the minimum term, Update card and Cancel membership. There is no pause and no skip.

The member’s page needs Shopify’s new customer accounts. To add it, open Checkout and accounts in your Shopify settings, choose Customize, then Customer accounts. Add Repose membership page, and add Repose membership link to the order page. The Where customers see Repose card on the Today page in Repose links to the Membership plan block and to the member’s page. Repose cannot see whether you have added them, so check each one.

If a payment fails. Repose asks Shopify again, 3 more times and 2 days apart unless you change it in Settings, under Membership payments. Access follows the paid orders, so it ends after the usual 3 days of grace even while the tries continue. After the last try the member’s payments and access stop and the membership is kept. When they save a working card it starts again without buying again. You can choose to cancel the membership at that point instead.

If a member cancels early. In Settings, under Membership payments, you choose what a cancel inside the minimum term does: it takes effect when the minimum is reached (the default), the member cannot cancel until then, or it ends straight away and they keep the time they have paid for. The member’s page says which, in plain words, before they confirm. A member whose payments have already stopped, because every try failed, is the one exception: their cancel ends the membership at once.

You are told when a member cancels. You get an email when a member cancels, and a second one when a cancel that waited for the minimum term takes effect. The email names no member: open Memberships to see who. The member gets an email with the date their membership ends.

Selling before you open. Set Opening day in Settings. A member pays the first payment at checkout as on any day, their access starts on the opening day and their next payment is one payment period after it. Memberships, passes and visit packs bought before the day also start on it. A member who is already running is never moved to the opening day. See Running the desk.

One membership per customer, and one in an order. A customer whose membership payments are running cannot start a second membership, and an order cannot hold more than one: not a quantity of 2, and not two different memberships. Repose refuses it before anything is paid wherever it can:

  • On the product page. The Membership plan block tells a signed-in member “You already have a membership on this account”. A cart that already holds a membership says so, with a link to the cart.
  • In the cart. Switch on Membership cart under App embeds in your theme. If a customer raises a membership to a quantity of 2 in the cart, it goes back to 1 and the page says why. The Where customers see Repose card on the Today page opens the right place.
  • At the till. Membership sign-up will not email a member the link to another membership.
  • At checkout. Where the checkout check runs, checkout refuses an order with more than one membership.

If an order gets through anyway, Repose refunds it in full, stops the payments that came with it, and emails the customer and you with the reason. The membership the customer already had does not change. Someone whose membership was cancelled or stopped can join again. To move a member to a different membership, cancel the one they have first.

This rule is only for memberships with a membership payment. A membership paid up front, packs and passes are not limited by it. The Memberships page still warns if someone has two running, and says to cancel one in Shopify.

Uninstalling. If you uninstall the app, Shopify deletes the plans and cancels the members 48 hours later.

Another subscriptions app

A product with a plan from another subscriptions app on it also works. Set the Membership name, and make Days of access per payment the same number of days as the plan’s billing interval (weekly: 7, monthly: 30). Repose cannot see that app’s subscriptions, so it learns that the membership renews from the order: an order placed on a plan carries the plan it was bought on. Repose will not write a plan beside a plan from another app, so a product can have one or the other, not both.

Repose does not import or take over another app’s plans or members.

The rule for another app’s plan

The plan’s billing interval and the days of access per payment must be the same number of days.

For a plan from another app, Repose does not read the billing schedule to decide who can book. It reads the days of access and extends the member’s access by that many days every time a payment arrives. So:

  • Bills every 30 days, 7 days of access: members lose access after a week and get it back when they pay again.
  • Bills every 7 days, 30 days of access: members keep access for three weeks after they stop paying.

There is a third effect that looks like a bug. Once someone is past the time their last payment covered, the Memberships page says “renewal not seen”. On a mismatched offer, every member reads that way, all the time, even though every payment went through. The list is right; the offer is wrong.

The Offers page checks the two numbers on every load and warns on the offer’s row when they disagree by more than three days. A few days of slack is deliberate: a monthly plan is 30 or 31 days. A plan Repose writes cannot disagree, because the days of access set how often the member is charged.

A membership product with two payment options from another app, weekly and monthly on the same product, cannot match both. Whichever a customer picks, they get the same number of days. The Offers page will not print a price for such a product and says why. Sell each option as its own product.

A membership that runs for a fixed time and stops

An ordinary one-time product, with no payment plan.

  1. Create the product with its full price.
  2. Set Membership name, for example 6 month pass.
  3. Set Days of access per payment to the days it covers. Six months: 182. A year: 365.

The customer sees “Your membership runs until Sat 18 Sep 2027. It does not renew on its own.” In the last two weeks it also says how many days are left, followed by your own sentence about what to do next, which is a setting on the booking block.

These customers are never told a renewal is coming. Someone can buy one more than once; the days add on to the end of what they have. A fixed-term membership needs Pro like any other.

A membership with a limited number of bookings a week

Set Bookings a week on the product. The week runs Monday to Sunday in the location’s time. A membership grants no credits of its own, and unused weeks do not bank.

Past the cap, what happens depends on what else the member holds. A member who also has a spare credit for that resource books with it, and the confirmation says so: “Your membership’s 2 bookings for this week were already used, so this one used a credit.” A member with no credit is refused, with a message that says why and how to free a place by cancelling one.

Step pricing

A membership that costs one price for the first stretch of payments and another after that: set an intro price and how many payments it lasts under Membership payment, and optionally a minimum number of payments before the member can stop. As an example only, 39 a week for 26 payments, then 59 a week, with a minimum of 52 payments.

The Offers page reads the plan and prints it, for example “USD 39.00 a week for the first 26 weeks, then USD 59.00 a week. Minimum 52 weeks.” If it cannot read the shape exactly, it says so rather than showing half. The Membership plan block on the product page shows the same story to shoppers.

Repose changes the price after the intro payments and before the next one is due, and does not charge a payment before its date. The price and terms a member agreed to are fixed when they buy, so editing a plan later never changes what an existing member agreed to.

What the app can know about renewals

For a membership whose payments Repose takes, Repose sees the subscription and tells the member and your staff its real state: renewing, payment failing, stopped because the card failed, cancelled with the date it ends, or finished. If you cancel one in Shopify, Repose sees that, and Mark as not renewing is hidden for these members because Repose knows.

For a plan from another app, Repose cannot see whether a subscription has been cancelled, because a subscription can only be read by the app that created it. Orders are the only signal, so the app records what each paid order said and works out the rest from the calendar:

  • An order on a plan means the membership repeats.
  • An order with no plan means it was bought once.
  • An order the app could not read fully means “not known yet”, and that is never spoken as a promise either way.

When someone’s paid time runs out and no new order has arrived, the app stops saying it renews and starts saying “we have not seen your renewal yet”. That is true of a card being retried and of a subscription cancelled last week alike.

For one billing cycle after the last payment, someone who has cancelled with another app is still told their membership renews. The Mark as not renewing button on the Memberships page is for that. It stops the promise. It does not take away access they have paid for, and the confirmation says so. It can be undone, which hands the row back to whatever the orders say.

The Memberships page

Everyone who holds a membership, which one, whether it renews and the date they are covered to, soonest first, with tabs for those running out. Use it to ring members before they are turned away at the door.

The same standing is written onto each customer in Shopify as a membership status (active, ending soon, renewal overdue or lapsed), the date they are covered to and the membership name, so you can build a Shopify customer segment of lapsed members without exporting anything. Credit balances are written the same way, one per credit type.

What Repose never does

  • Grant, extend, shorten or end access from billing. A paid order is the only thing that grants access, and a failed or late payment removes nothing by itself.
  • Pause or skip anybody’s payments.
  • See or hold card details, or take a payment outside Shopify. Shopify holds the card and takes the money.
  • Sell a membership at the point of sale. Staff use Membership sign-up on the till to email the customer a link, and the customer joins and pays on their own phone. See Shopify POS.
  • Refuse, shorten or end a membership because of your Repose plan. A paid order is granted and a renewal extends, on every plan. An order that breaks an offer limit is refunded and gives nothing, on every plan. That is the limit, not the plan.
  • Tell a member something it does not know.