Credits & Packages
Create prepaid credit packages, let customers redeem credits for services, and manage credit expiry.
What are Credit Packages?
Credit packages (also called Marketplace Items) let you sell prepaid service bundles to your customers. Instead of paying per appointment, clients purchase a package of credits upfront and redeem them to book services. This encourages repeat business and improves cash flow.
Common use cases:
- Sell a "5-Session Package" at a discounted rate.
- Offer membership-style credits that expire after a set period.
- Create service-specific packages (e.g., credits only redeemable for facials).
Creating a Credit Package
Credit packages are configured as marketplace items in your admin dashboard. Each package has the following properties:
| Field | Description |
|---|---|
| Name | Display name shown to customers (e.g., "5-Session Wellness Package"). |
| Price | The amount the customer pays to purchase the package (in RM). |
| Credit Amount | How many credits the customer receives upon purchase. Each service that accepts credits defines its own creditCost. |
| Expiry | Number of months before purchased credits expire. If not set, the system default (12 months) applies. |
| Applicable Services | Restrict which services these credits can be used for. Leave empty to allow redemption on all credit-enabled services. |
How Customers Purchase & Use Credits
The credit lifecycle works as follows:
- Purchase: Customers buy a credit package through your booking page, paying via your connected payment gateway.
- Credit Awarded: Upon successful payment, credits are added to the customer's balance. Each purchase creates a record tracking the credit amount, source package, and expiry date.
- Redemption: When booking a credit-enabled service, the customer can choose to pay with credits instead of cash. The service's
creditCostis deducted from their balance. - Expiry: Credits past their expiry date are no longer usable. The system tracks expiry per credit batch, so credits purchased earlier expire first.
Enabling Credits on Services
For a service to accept credit payment, two settings must be configured on the service:
- Accept Credits (
acceptsCredits): Toggle ON to allow credit-based payment for this service. - Credit Cost (
creditCost): Set how many credits this service consumes per booking. For example, a "Premium Facial" might cost 2 credits while a "Basic Facial" costs 1 credit.
Customers with sufficient credit balance will see the option to pay with credits during checkout. If their balance is insufficient, they can still pay with cash/card.
Credit Expiry & Usage Order
Credits are consumed on a first-expiring, first-out basis. When a customer redeems credits:
- Credits with the earliest expiry date are used first.
- This ensures customers don't lose older credits while newer ones sit unused.
- All credit transactions are recorded in the customer's history, showing the amount deducted, remaining balance, and source package.
Once credits expire, they are permanently unavailable. The customer must purchase a new package to continue using credit-based bookings. Expiry dates are visible to customers in their booking portal.
Still have questions?
Can't find what you need? Ask our support team directly.