API v2: Correct workflow to Convert Quote to Booking using Stripe Token (System of Truth)?

Dan - RCL
yesterday
Joined Aug, 2025 5 posts

Hi everyone,

I am developing a custom direct booking website using the OwnerRez API v2. I need guidance on the correct workflow to convert a "Quote" into a confirmed "Booking" while ensuring OwnerRez handles the payment processing and card storage.

My Goal: I want OwnerRez to remain the "System of Truth" for all financials. I do not want to charge the card on my own backend and simply record a manual payment. Instead, I want to collect the card details on my site and pass them to OwnerRez to execute the charge and save the card for future scheduled payments (second payment, security deposit, etc.).

My Current Setup:

  • Stack: Custom React/Node frontend.

  • Processor: Stripe (integrated via OwnerRez).

  • Flow: I am using Stripe Elements on my frontend to generate a Payment Method ID (pm_...).

The Question: Once I have the pm_... token from Stripe and a valid Quote ID from OwnerRez, which specific API endpoint sequence should I use?

I am looking for the equivalent of a "Process & Book" endpoint where I can send:

  1. The Quote ID

  2. The Stripe Payment Method Token

  3. The Authorization to charge the deposit amount

Is the correct path to use POST /v2/quotes/{id}/book? If so, how do I format the payload to include the Stripe token so that OwnerRez:

  1. Charges the deposit immediately.

  2. Tokens/Saves the card to the guest record for the future balance due.

Any documentation references or JSON payload examples for this specific "Handoff" workflow would be greatly appreciated.

Thanks!