Create an instant reservation based on a quote, with an immediate charge using a Stripe confirmation token or the initialPaymentMethodId when GuestyPay is used. This endpoint allows you to charge a reservation before confirming the reservation. If the charge fails, the reservation is not created. Stripe's confirmation token is generated using Stripe frontend embedded component. See Stripe docs for more information.

The initialPaymentMethodId is created using our dedicated SDK v2. Documentation can be found here. Before requesting this endpoint, when GuestyPay is used, the SDK submit function must be called to get the initialPaymentMethodId. The payload option 1 should be used and the email must also be sent in the guest data. After this request, if the status of the payment is PENDING_AUTH, the /verify-payment endpoint must be called.

❗ Important

Before using the Booking Engine (BE) API reservation endpoints, ensure your Guesty account is properly activated by following these steps:

1. Activate Manual Source (skip this step if you already have direct reservations in Guesty account):
   • Create a manual reservation directly in the Guesty UI. This step is required to activate the "Manual" booking source in your account.
2. Activate BE API Source:
   • Create your first reservation using the Booking Engine API endpoints.
   • This step is essential to initialize the BE API source, which allows you to set up additional fees, taxes, auto payments and automated messages.