Who This Is For / When to Use
This article is for account admins and users who want to collect payments when appointments are booked.
Use this when you need to:
Require upfront payment for appointments
Connect a payment gateway to calendars
Enable coupons or discounts during booking
Manage payment visibility in calendar settings
What Are Calendar Payments
Calendar Payments allow you to collect payment at the time an appointment is booked.
This is commonly used for:
Paid services
Consultations
Events requiring confirmation
Securing time slots in advance
Supported Payment Gateways
Kyrios supports the following payment gateways for calendar bookings:
Stripe
NMI
Authorize.net
Razorpay
Square
Gateway Limitations
Razorpay, NMI, and Square are not supported for:
Classic Widget
Service Menu
These gateways can still be used with other calendar types.
Step 1: Add a Payment Gateway
Access Payment Integrations
Go to Settings.
Open the Payments tab.
Select Integrations.
Connect a Payment Provider
Click Connect next to your preferred gateway.
Complete the authentication steps shown on screen.
Set a Default Payment Gateway
If multiple gateways are connected:
Select one as the default payment gateway from the dropdown.
Important:
Only the default gateway is used for calendar payments.
Step 2: Enable Payments on a Calendar
Open Calendar Settings
Go to Settings → Calendars.
Click the edit (pencil) icon for an existing calendar
or select Create New Calendar.
Turn On Payments
Open Advanced Settings.
Navigate to Forms & Payments.
Toggle Accept Payments on.
Payment Fields Explained
Once payments are enabled, the following fields appear:
Amount – Payment amount and currency
Description – Description shown during checkout
Payment Mode
Test (no real charges)
Live (real transactions)
Coupon Codes for Calendar Bookings
Calendar payments support coupon codes during checkout.
Coupon options include:
Fixed or percentage discounts
Usage limits
Calendar-specific restrictions
Coupons appear:
During booking
In appointment payment details
Recurring Calendar Payment Limitations
Partial payments are not supported for recurring calendars.
Recurring calendars charge according to the selected payment configuration.
Calendar Notifications and Payments
Calendar payment settings integrate directly with calendar notifications.
Benefits:
Fewer setup steps
Clear visibility of payment connections
Unified booking and payment management
Create Email Templates from Calendar Notifications
Email templates can be created directly inside Calendar Notification settings.
How to Create an Email Template
Open Calendar Settings.
Go to Notifications.
Click Create New Email Template.
Choose an editor type and save the template.
Once created, the template appears in the notification dropdown.
What to Do If Payment Options Are Not Visible
Issue
The Accept Payments toggle is unavailable or payment fields do not appear.
Cause
No payment gateway has been integrated.
Fix
Go to Payments → Integrations.
Connect a payment provider.
Return to calendar settings and enable payments.
Common Issues and Fixes
Cannot Enable Accept Payments
Cause
No default payment gateway is set.
Fix
Connect a gateway and assign it as the default.
Payments Not Charging Customers
Cause
Calendar is set to Test Mode.
Fix
Switch Payment Mode to Live before publishing.
FAQ
Can I collect payments for all calendar types?
Yes, but Razorpay, NMI, and Square are not compatible with the Classic Widget or Service Menu.
How do I change my default payment gateway?
Go to Payments → Integrations and select a new default gateway from the dropdown.
Can I collect partial payments for recurring appointments?
No. Partial payments are not supported for recurring calendars.
What happens if I don’t integrate a payment gateway?
You will not be able to enable calendar payments, and customers will not be charged during booking.
How do I ensure payments are collected in real time?
Set the payment mode to Live before publishing the calendar.
Where do discounts appear during booking?
Discounts appear during checkout and in the appointment’s payment details.
Are coupon codes available for all calendars?
Coupons work for most calendar types, but limitations may apply based on gateway or calendar configuration.