What Coupon Codes in Calendars Do
Coupon codes add a discount field to the calendar booking widget. When a customer enters a valid coupon code, Kyrios recalculates the booking price in real time. After booking, the appointment record shows the discount in the payment details.
Key Benefits
Coupon codes help teams run controlled promotions for calendar bookings.
Benefits include:
Higher conversion
Discounts can reduce checkout friction during booking.Flexible promotions
Use percentage-based or fixed-amount discounts.Control and targeting
Limit coupon usage by redemption count, customer, product, or calendar.Better booking experience
Customers can apply or remove a coupon directly in the booking widget.
Supported Calendars and Limitations
Coupon codes are supported for calendar booking widgets, including Neo and Classic booking widgets. Coupon codes are also supported for Services v2.
Coupon codes are not supported with the older Service Menu v1. Coupon codes can be applied only through the booking widget. They cannot be applied to appointments created manually from the in-app appointment modal.
Step 1: Enable Payments and Coupon Codes for the Calendar
Before customers can use coupon codes, payments must be enabled for the calendar.
Open the calendar settings.
Go to Forms & Payment.
Enable Accept payments.
Enable Enable coupon codes.
Save the calendar.
You must enable coupon codes separately for each calendar where you want coupon codes available.
Step 2: Create a Coupon
Create the coupon before sharing the code with customers.
Go to Payments > Coupons.
Click Create Coupon.
Enter or generate a coupon code.
Choose a coupon type.
Enter the discount amount.
Set the start and end date or time.
Set redemption limits if needed.
Limit the coupon to specific products, offers, or calendars if needed.
Save the coupon.
Step 3: Customer Booking Experience
During booking, the customer enters the coupon code in the payment section of the booking widget.
If the code is valid, the discount is applied immediately and the total updates before checkout.
If the code is invalid, the booking widget shows an error.
Step 4: Track Coupon Usage on the Appointment
After booking, open the appointment and go to the payment details.
The appointment shows:
Amount paid
Remaining balance
Subtotal
Coupon discount
Total amount
Attendee-wise payment summary
Important Update: Orders and $0 Transactions
When a calendar has payments enabled, Kyrios creates an order for the booking.
If a coupon reduces the payable amount to $0, Kyrios may still record a $0 transaction. This transaction represents order creation. It does not mean a real payment was charged. If no payment is enabled on the calendar, no order is created.
Workflow Impact for Orders and Payments
If your workflows use Invoice Created triggers for calendar payment activity, update them to use Order Created triggers where appropriate. For payment-related workflows, use Payment Received and add an If/Else condition where Amount is greater than 0. This prevents workflows from running for $0 system-generated transactions.
Common Issues and Fixes
The coupon field does not appear on the booking widget
Confirm that Accept payments and Enable coupon codes are both enabled for that calendar.
The coupon does not apply
Check the coupon code, validity dates, redemption limits, and product or calendar eligibility.
A $0 transaction appears
A $0 transaction can be created when an order is created. It is not an actual charge.
A manual appointment does not allow coupon entry
Coupon codes are available through the booking widget only. They cannot be applied from the in-app appointment modal.
FAQ
How do I see the discount after booking?
Open the appointment and check the payment details. You can see the coupon discount, amount paid, remaining balance, and total amount.
Can I edit or disable a coupon after it goes live?
Yes. Go to Payments > Coupons, open the coupon, and update its dates, limits, or status. Changes apply to future bookings.
How can I test a coupon without charging a real card?
Set the calendar payment mode to Test, complete a test booking with test payment credentials, then switch the calendar back to Live when testing is complete.
Can customers stack more than one coupon on a single booking?
No. Only one coupon code can be active per checkout. Customers can remove one code and apply another before paying.
Are coupon codes case-sensitive?
No. Coupon codes are not case-sensitive.