Subscription Usage Guide
If you have applied for ECPay or NewebPay and entered your merchant information in the OB system, you can find the "Subscription" setting page in the customized feature "Payment Methods" and create various subscription options for customers to choose from.
When setting up, please note:
1. Static subscriptions are available for merchants who have set up either ECPay or NewebPay. You do not need both, and ECPay is not required — a studio configured with NewebPay only can also open the subscription plans page and manage recurring plans. * TWD only
2. One subscription option can be linked to multiple passes, and one pass can also be linked to multiple subscription options.
3. On pass editing page, each pass has three "Payment type options": "One-time, Subscription, Both". Set the payment method to "Subscription" or "Both", and link the subscription options. After saving, customers will see the linked subscription options when purchasing passes.
4. Before setting subscription options as non-cancelable, please be aware of current regulations, such as the requirement that merchants must allow buyers to cancel their subscriptions.
Static subscriptions keep the existing ECPay recurring-payment checkout (定期定額), with a fixed amount each period. Dynamic subscriptions automatically use ECPay credit card binding so OB can calculate and charge the amount for the scheduled classes. There is no separate card-binding or OB-managed subscriptions switch in OB.
To offer Dynamic subscriptions, enable ECPay in Payment options and ask ECPay to activate credit card binding for your merchant account; additional fees may apply. Enabling ECPay in OB does not activate this service with ECPay. Static subscriptions can also use NewebPay. One-off ECPay purchases continue using the normal payment checkout. Existing customer subscriptions keep their saved billing arrangement.
Static and Dynamic subscriptions: setup and ECPay payments
PAYUNi and SunPay support one-off TWD credit card payments in OB. Recurring subscription passes use ECPay or NewebPay. PAYUNi and SunPay do not provide subscription billing, ATM/CVS, wallets, automatic refunds or electronic invoices through this OB integration.
See Online Payment for the full provider list and setup details.
Where to Add Subscription Options?
After entering the Merchant ID, Hash Key, and Hash IV obtained from ECPay or NewebPay in the payment method settings and saving them, you can start setting up the subscription plan. Saving either provider unlocks the subscription plans page — you do not have to configure ECPay.


- Important Information: Set the subscription billing method and cycle. Under the Cancellation allowed heading, two fields sit side by side: Can your customer cancel the subscription? on the left and Stop after on the right.
- Description: Provide a subscription description that customers can view in their shopping cart.
- Passes: Specify which class passes are linked to this subscription plan. (Tip: After linking, go to the class pass edit page and set the payment method to "Subscription" or "Both" to make the subscription plan available for customers to purchase.)
- Pass duration: Choose how long each pass issued by this subscription stays valid. Use the subscription period is the default: each pass lasts one billing period, so a subscription charged every 30 days issues a 30-day pass. Use the pass duration keeps the validity set on the pass itself. Custom duration shows a Duration (days) box, which is required and only accepts whole numbers of 1 or more. Subscriptions saved without this setting use the subscription period.
- Tags: Create or assign easily recognizable tags to your subscription plans. These tags are visible only in the admin page.
How to set up passes for subscription-based purchase?
On the course card editing page, open the Payment tab (it replaces the former Advanced → Online Payment tab), set the payment method to "Subscription" or "Both", and link the subscription options under Subscription. After saving, customers will see the linked subscription options when purchasing course cards.
The subscription settings only appear on a pass once online purchase is turned on for that pass and at least one of ECPay or NewebPay is configured for your studio. If you cannot see them, check those two things first.
There are three payment type options for course cards: One-time, Subscription, Both.
【One-time】Purchase the course card once and pay in full, using the payment methods currently available at the store.
【Subscription】Purchase the course card on a regular basis, receiving the first course card immediately upon purchase. Thereafter, you will receive the same course card with each periodic payment.
Note: If a customer chooses a giveaway and a subscription pass in the same transaction, they will receive both subscription pass and giveaway only with the first payment. Subsequent payments will only provide the subscription pass without any additional giveaway.
【Both】Offer both one-time purchase and subscription options simultaneously.

How can customers purchase subscription-based passes?
When studios offer subscription options for passes, customers will see (Subscription) or (+ More) next to the pass price when making a purchase.
Subscription: Displays the subscription price, and the corresponding pass is obtained with each payment cycle.
+ More: Displays single or multiple subscription payment options, with the shown price being the lowest among all options. Customers can choose the payment option that best suits them.


When purchasing subscription items, customers can only choose to pay with a credit card.
Note: Due to ECPay restrictions, subscription items must be checked out separately and cannot be combined with other one-time payment items.
Tip: Free gifts can be checked out together with subscription items. Upon the first payment, customers will receive both the subscription item and the free gift. For subsequent payments, customers will only receive the subscription item without the free gift.
After completing the payment through ECPay, please return to the booking system and wait for about 3 to 5 seconds. Once the system receives the payment confirmation from ECPay, it will display "Payment Successful," indicating that your transaction is complete and the pass has been sent to your inbox.
How can customers check their pass subscription status?
In the "Account" page located at the bottom right, under the "passes / Store / Subscriptions" section, you can view the status of each order.
For subscription orders, you can see the current subscription status and payment period information in the "Subscription" column on the right of table.

The first part of the reference number for the same subscription order will be the same. For example, the first order number for a subscription might be #RN-6655ddd2df25f, and the next payment's order number is SUB-6655ddd2df25f-1717033622. Both have the same first part of the order number: 6655ddd2df25f.

How can customers cancel their subscription?
Users can check the status of their subscription orders in the "Account" page under "Passes / Shop / Subscriptions" at the bottom.
To cancel a subscription, go to the order details page and click "Cancel Subscription." This stops future charges only. It does not refund, reverse, or change any payment already collected.
- If the subscription period is complete, already canceled, or the merchant has not enabled subscription cancellations, the button will be disabled.
- If the merchant does not allow customers to cancel subscriptions on their own, the admin will need to cancel it from the backend.
After successfully canceling your subscription, you will receive a confirmation SMS from ECPay within 1 to 3 minutes. (The ECPay SMS will be sent to the phone number provided at the time of payment)

How can admin check customers' subscription status?

Orders paid through ECPay will have an reference number starting with RN.
For subscription order, each payment will generate a new reference number: the first payment will have an reference number starting with RN, and subsequent payments will have reference numbers starting with SUB.
How can admin assist customers in canceling their subscription?
An admin can stop a customer's future charges from the back office:
- Open Dashboard and select the Payments tab.
- Select Verified payment and find the subscription order (search by its reference number, which starts with RN or SUB, or by customer).
- Open the order and select Subscription in its menu.
- Select Cancel subscription below the payment list.
The subscription status then shows Cancelled, on the order and in the Payments list. Cancelling only stops future charges; it does not refund or change payments already made.

How to Add an Unpaid Subscription Pass to a Customer's Account
Please note that:
- You can't edit payment method / payment status if it's an unpaid subscription pass.
- You can't edit activation / expiration date if adding an unpaid subscription (will only be activated on purchase).
- You still can use it if it's unpaid IF the setting is enabled (allow customer to use unpaid pass).
- When you add a subscription pass to a user, you won't get ability to add unpaid classes to the pass.

How Customers Can Pay for an Unpaid Subscription Pass

FAQ: What are the "total days available for use" for each subscription pass?
When customer purchases a subscription plan, each pass issued after payment will have its activation date as the payment date and its expiration date as the next payment date.
For example, if a subscription class card is billed once a month, the validity period for each class card is 30 days. The class card will be activated and the time will start counting immediately upon billing and issuance.
Example: If a customer purchases a pass on 4/5 and selects a monthly auto-renew subscription plan, the activation date of the first pass will be 4/5 and the expiration date will be next payment date 5/5. The customer will receive the second pass on the next billing date, with the activation date of the second pass being 5/5 and the expiration date being 6/5.
This describes the default Use the subscription period setting. You can change it in the subscription's Pass duration tab: Use the pass duration keeps the validity set on the pass itself, and Custom duration makes each pass valid for the number of days you enter.
FAQ: How to check customers' subscription status in the ECPay website?
To search for an order in the ECPay system, copy the first part of numbers+characters of "reference number" from the order in OB system, remove the "-" symbol, and enter it as the Merchant Order Number (廠商訂單編號) in ECPay.
For example, to search for reference number RN-6662fbe092357, enter RN6662fbe092357 in the ECPay Merchant Order Number(廠商訂單編號) field.
If the order is a subsequent subscription payment, and the "reference number" is SUB-66570e50023fb-1717379037, prepend RN to the first part of the code and enter RN66570e50023fb in ECPay to search.

FAQ: Can I change an existing subscription's price, billing cycle, or charge count?
For an existing Static subscription, editing the plan does not change the customer's agreed recurring amount, billing cycle or charge count. To change those terms, cancel the subscription in OB and ask the customer to subscribe to the corrected plan. Only the customer can complete checkout and card authorization. Cancellation stops future charges and does not refund previous payments.
For an active Dynamic subscription, you can reduce one customer's future monthly charge without cancelling: open Online Payment → Subscriptions → Upcoming payments, open the customer's row, then Individual discount. Add a fixed amount for one month or ongoing from a chosen month. This does not change the shared plan, billing cycle or charge count. Already prepared payments keep their saved amount.
FAQ:Can admin subscribe to pass on behalf of customer?
You can prepare a subscription for a customer from their shopping cart in the admin, but the customer still completes checkout and payment themselves.
When you add a pass whose payment type is Subscription or Both to a customer's cart, a Payment options list opens. Choose one of the pass's active subscription plans (regular or calendar), or One off payment if the pass also allows it. Plans with no places left show Sold out.
A subscription must be the only item in the cart. If the cart already has items, you can choose Clear cart to empty it and add the subscription. See How can I manage users shopping carts from the admin page? for the full steps.
How can customers on a Dynamic subscription book make-up classes?
Customers who bought a pass through a Dynamic subscription can book make-up classes with that pass in the app. Make-up classes use the remaining credit on the pass. Choose which classes can be used for make-up classes in the subscription's Make-up classes setting on its Edit page.
- Open the paid subscription pass to see its details, then tap Make-up classes.
- Choose a class from the list. The list only shows classes at the location currently selected in the app.
- Choose an upcoming session. Each session shows its date and time and how many spots are left.
- The class booking page opens. Booking takes the customer to the confirmation step, with this pass already chosen and the pass holder, or the family member the pass belongs to, set as the attendee.
- Make-up classes only appears for paid Dynamic subscription passes that belong to the signed-in customer. Static subscription passes and ordinary purchases of the same pass do not show it.
- If there are no linked classes, the page shows No make-up classes. If a class has no sessions that can be booked, it shows No available make-up sessions.
- If the option cannot load, the pass details show Make-up classes — Try Again. Tap it to load it again.
On the pass details, the VISITS value shows Unlimited for unlimited passes.
What do the Type and Dynamic columns in the Subscriptions list show?
The Subscriptions list under Online Payment → Subscriptions → Types shows two columns between the plan label and Price, so you can check each plan without opening it.
- Type: shows whether the plan is Dynamic or Static. Older plans that were saved without a type show as Static.
- Dynamic: for Dynamic plans, shows the linked repeating class name with its day of the week and class time underneath, the Price per session, and the day of the month customers are charged (Charge on day of month). Static plans show -. This column cannot be sorted.
- Price: Dynamic plans show -, because their monthly price depends on the scheduled sessions. Static plans show their price, or - if no price is set.
If the list shows Repeating class: #<number> instead of a class name, the plan's linked repeating class could not be found. Open the plan and check its repeating class setting.
How do I set a price for one class session in a Dynamic subscription?
Open Online Payment → Subscriptions → Types, select a saved Dynamic plan, then open its Classes tab. Choose a month with the month buttons (short labels such as Jan 2026) or Choose month. Below the month buttons, a Monthly total box shows the total for that month (or a prompt to set a price per session first), the number of classes and the charge day.
The classes table shows a row number, an actions (...) button, the class name, the session price, the date and time, Attendance, Instructors (the main instructor, up to two more instructors and any substitute) and Status. Clicking a class row does not open the class. To open it, click the ... button on its row and choose View calendar class.
- Click the price of the session you want to change. A small Edit price pop-up opens next to that price.
- Enter the price. You can also add an optional note of up to 800 characters.
- Click Save at the bottom of the pop-up.
If a custom price has already been saved for that session (a saved price of 0 also counts), the pop-up also shows a Clear override button. Click it to remove the custom price and return the session to the plan's price per session. Sessions without a saved custom price do not show this button.
The price applies to every student on this subscription for that session. While saving, the pop-up cannot be closed. If saving fails, it stays open with an error message so you can try again. After a successful save, the table refreshes and the session shows a Custom price badge with any note underneath.
The plan's base Price per session and Charge on day of month are set on the plan's Edit page. The charge day must be between 1 and 28.
How do I choose between Static and Dynamic subscription types?
Open Online Payment → Subscriptions → Types → New, then choose the type in Important Information → Subscription type. The type is chosen when the subscription is created and cannot be changed after it has been saved. When you edit a saved subscription, Subscription type is greyed out and shows Subscription type cannot be changed after creation. To use the other type, create a new subscription with the type you want instead of editing the existing one.
- Static: the same amount every subscription period, using the original ECPay recurring-payment flow or NewebPay.
- Dynamic: monthly pricing based on scheduled classes, using ECPay card binding.
Dynamic is disabled when ECPay is not enabled. Open Online Payment → Payment Options → ECPay, enable ECPay, enter your merchant credentials and save. Then reopen the plan. The page reads the payment settings when it opens, so Dynamic may be briefly unavailable while they load.
Before offering Dynamic purchases, ask ECPay to activate credit card binding for your merchant account and confirm any additional fees. This is a service activation with ECPay, not a separate OB toggle. The Dynamic option includes this requirement in its description.
Static and Dynamic subscriptions: setup and ECPay payments
FAQ: Do coupons apply to every renewal, and is each renewal a new pass?
Coupons and discounts: a price coupon or discount used at the first checkout applies to every renewal, not just the first payment. Static subscriptions charge the same discounted amount each period; Dynamic subscriptions apply the same discount to each month's total. For a Dynamic subscription, staff can also give one customer an individual discount from Online Payment → Subscriptions → Upcoming payments; it replaces the promotion discount for the months it applies to. See Static and Dynamic Subscriptions.
Renewals: each paid renewal adds a new purchased pass to the same customer account, with that period's activation and expiration dates. The customer's account does not change, and earlier passes stay in their history. A Dynamic subscription month with no classes issues no pass.
For Dynamic renewals, an applicable individual discount replaces the promotion for that month; they do not stack. A One-off individual discount takes priority over an Ongoing one. If no individual discount applies, the original promotion is used again. A zero-value individual discount explicitly replaces the promotion with no reduction.
Add an individual monthly discount
Open Online Payment → Subscriptions → Upcoming payments, select the customer's active Dynamic subscription, then Individual discount → New. Choose a month, One-off or Ongoing, the fixed amount off and an optional staff note. Save after checking the customer and month. Individual discounts do not require the Discounts custom feature and are not available for Static subscriptions.
The month is the month of classes being paid for, not the collection month. For example, a December period may be collected on November 22. The picker offers the next six eligible months whose scheduled payment date is still in the future. Today's or past payment dates cannot be selected. One-off applies only to the selected month; Ongoing starts that month and continues until disabled or superseded. The charge cannot fall below zero.
You cannot edit a discount after adding it. Disable an incorrect discount and add a new one instead. Only one enabled discount can have the same month and frequency. Prepared payments keep their frozen price; changes do not rewrite past payments.
Discount status, usage and payment history
The Individual discount table shows Active, Disabled or Expired, the starting month/frequency and Total discounted. Open the row's ellipsis for Enable or Disable. An unavailable action is disabled with an explanation. One-off discounts expire on their scheduled payment date, including today, and cannot then be enabled or disabled. Ongoing discounts do not expire when their first month passes and remain switchable for future payments.
Total discounted adds the reductions actually used by successful payments. A dash means the discount has not been used; a recorded zero means it was used without reducing the charge. Estimates and failed attempts are not counted.
Both Upcoming payments and Past payments have a clickable Discounts amount with the saved or estimated breakdown. Past payments preserve the applied discount even after it is disabled. Older payments without a saved breakdown show a dash rather than an invented amount. Use the payment action to view the payment itself. Classes included shows the monthly sessions used for Dynamic pricing; a Static subscription instead forecasts up to six future payment dates.
