Start Booking Payment
Sends a held appointment slot to Stripe so the visitor can pay for it before the booking exists. The charge lands directly on the owner's own connected Stripe account, so the calendar is never the merchant. The hold is extended while the card form is open, because ten minutes is the right answer for an abandoned browser tab and the wrong one for somebody who is paying, and Stripe will not hold a payment page open for less than thirty minutes anyway. Refused for a free service, which should simply be confirmed.
Request
Response
Related methods
public_start_paid_bookingpublicHold a time for a visitor with no account and start paying for it on the booking page itself, for a service that takes payment when booking. Every check of a free booking runs first. The price and the currency are the service's own, decided on the server and never sent by the page; the charge is a direct charge on the owner's own connected Stripe account. The hold is extended while the card is typed, and the visitor's details wait on it until the payment is confirmed. Answers the client secret the page's card field needs and which hold to confirm, nothing more.
cancel_calendar_bookinguserCancel a booking and give the time back. Safe to call twice, and the slot returns to the public grid.
confirm_calendar_bookinguserTurn a held slot into a real booking. A hold token that is no longer present has lost the slot and is refused rather than re-added, because re-adding it is how one time gets sold twice.
confirm_paid_bookingpublicConfirms an appointment once its payment has cleared. Everything is checked against Stripe on the server: the visitor arrives from a redirect and controls every value in it, so three things must agree before a slot is given away. Stripe says the payment completed; the payment names THIS appointment and THIS hold, which is what stops a receipt for a cheap slot being presented against an expensive one; and the amount collected still matches what the service costs. If the payment cleared but the slot could not be booked, that is reported rather than swallowed, because the money is real and the appointment is not.
create_booking_roomuserMake the Xuda Meet room of a video booking that was confirmed without one, and send each guest of that appointment the link. The room belongs to the appointment, so every confirmed booking of it holds the same room. Safe to call twice: a second press answers the room that exists and sends nothing again. Refused for a booking that is cancelled, already over, not a video appointment, or not the caller's.
get_booking_bootstrappublicEverything a public booking page needs to render: its title, its services and a freshly minted anti-bot token. Public, and it carries no account data beyond what the page itself shows.
24 of 24 in Calendar