Public Start Paid Booking
Hold 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.
Request
Response
Errors
An error keeps the envelope: a negative code and a message in data.
Related methods
public_confirm_paid_bookingpublicBook a held time once its payment has gone through. Nothing the page sends is trusted but which hold to look at: the payment is read back from Stripe on the owner's account and must have succeeded, for the service's price, in its currency, for this very hold, before the time is given. The Stripe webhook runs the same confirm, so whichever arrives second gets the same booking back. A payment that went through for a time that could no longer be kept is reported, never silent.
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.
get_public_bookingpublicWhat a visitor's private link opens: one booking and what they may do with it. No account and no address: the signature in the link is the whole of the check. Reading it never changes anything, because mail scanners open every link in a message.
get_public_booking_slotspublicThe bookable times a visitor may choose from. Returns a start, an end and a seat count, and never says who holds the other seats.
public_cancel_bookingpublicA visitor cancels their own booking from their private link, by the page's rules: whether visitors may change a booking, and up to how many hours before it starts. A paid booking is refunded first, by the page's refund percent, and stays booked if the refund fails. A paid booking on a page with no refund cannot be cancelled here.
public_reschedule_bookingpublicA visitor moves their own booking from their private link, by the page's rules and every selling rule of the public page. The new time is taken before the old one is let go, the booking keeps its details, its length and its payment, and the invite updates the event already in the visitor's calendar. A move never charges.
20 of 24 in Calendar