Public Confirm Paid Booking
Book 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.
Request
Response
Errors
An error keeps the envelope: a negative code and a message in data.
Related methods
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.
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.
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.
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.
18 of 24 in Calendar