Who This Is For / When to Use
This article is for account owners and administrators who want to require payment or collect booking fees when customers schedule appointments through a calendar.
What the Stripe Calendar Integration Does
When Stripe is connected and enabled:
Customers can pay during booking
Payments are processed securely through Stripe
Charges appear in Stripe and Kyrios transaction records
Each appointment is paid individually
Stripe must be connected before enabling payments on a calendar.
What You Need Before You Start
To use Stripe with calendars, you must have:
An active Stripe integration
At least one calendar configured
Step 1: Connect Stripe to Your Account
Go to Payments in the left menu
Click Integrations
Select Stripe
Click Connect with Stripe
Complete the Stripe authorization flow
After connecting, Stripe appears as an available payment gateway.
Step 2: Manage Stripe Payment Methods
Stripe payment methods are managed directly inside Kyrios.
You can:
Enable or disable payment methods
Configure methods separately for Live and Test modes
Apply payment methods to specific product areas
Once connected, payment methods can no longer be edited inside the Stripe dashboard.
Step 3: Enable Stripe on a Calendar
Stripe must be enabled on each calendar individually.
Go to Settings
Select Calendars
Click the pencil icon to edit a calendar
Step 4: Configure Calendar Payment Settings
Open Forms & Payment inside the calendar
Enable Payment
Enter:
Charge amount
Currency
Charge description
Select Stripe as the payment gateway if multiple gateways are connected
Choose Test or Live mode
Click Save
The calendar is now ready to accept payments during booking.
Important Payment Behavior Notes
Charge description appears on customer payment records and should clearly explain the charge
If multiple gateways are connected, only the default gateway processes payments
Partial payments are not supported for recurring calendars
Payments apply per appointment, not as subscriptions
Supported Payment Gateways for Calendars
Kyrios supports the following gateways for calendar payments:
Stripe
NMI
Authorize.net
Razorpay
Square
Limitations:
Razorpay, NMI, and Square are not supported in the Classic Widget or Service menu
Refund Handling
Cancellations do not trigger automatic refunds
Refunds must be processed directly in the Stripe dashboard
This ensures full control over payment reversals.
FAQ
Can Stripe be the default gateway if multiple gateways are connected?
Yes. Only the selected default gateway processes calendar payments.
How do I manage Stripe payment methods?
Go to Payments > Integrations > Stripe > Manage Payment Methods.
Are partial payments supported?
No. Partial payments are not supported for recurring calendars.
Which gateways work with calendars?
Stripe, NMI, Authorize.net, Razorpay, and Square. Some widgets have limitations.
What happens if I leave the charge description blank?
Customers may not understand why they are being charged. Always add a description.
Can I connect more than one payment gateway?
Yes, but only the default gateway is used for processing payments.
Are recurring payments supported?
No. Each calendar booking must be paid individually.
Do cancelled appointments refund automatically?
No. Refunds must be issued manually through Stripe.