Pattern 2: Partner offering multi-day reservations for the same booking type

Multi-day reservations for the same accommodation type is a common pattern for our lodging, hospitality, and camping partners. In this case, the customer is reserving a specific item like a hotel room for multiple sequential days.

Onboarding

We will generate API keys and a Product ID that the partner can use to call the Sensible Weather API. The Product ID is a unique identifier we create and assign to each partner we work with. The Product ID will be included in the request to our APIs so that we know which partner is calling our API.

Where to offer a Weather Guarantee

Customers add Weather Guarantees to their booking at the highest rate when the Weather Guarantee is presented in a prominent position in the checkout flow. For most partners, this occurs after the customer has chosen their specific tickets/lodging/activity, but before they have paid. We strongly recommend that our partners proactively generate quotes based on the location, dates, and price of the booking so that the quote can be presented in the checkout page. This enables the partner to offer a Weather Guarantee without requiring any action by the customer.

Creating Quotes

Once the partner has the location, dates, and price of the booking, call Create Guarantee Quote with those details to retrieve a Weather Guarantee quote for the customer. The response will include information important to both the partner and the customer. The partner will need to surface the price of the quote, the payout tiers, and use the plain language to correctly explain the Weather Guarantee. We strongly recommend that partners utilize the provided plain language to explain the Weather Guarantee because we are constantly evaluating and improving copy to increase attach rates. Since the quote is for a multi-day reservation, the partner should pass in the entire duration of the trip. For example, with lodging partners, the coverage dates should include the check in day and the check out day.

Note: it is important to properly assess taxes on the price of the quote. Review the Taxes section to determine how to asses taxes on Weather Guarantees.

Accepting Quotes

If the customer adds the Weather Guarantee to their booking and proceeds to payment, then it is time for the partner to accept the quote on behalf of the customer. Payment flow will depend on the approach the partner is using as discussed in managing payments.

Declining Quotes

If a quote is generated and shown to the customer, but the customer decides to proceed without adding the Weather Guarantee quote to their booking, then the partner will call Decline Guarantee Quote. This lets us know that the customer viewed the quote but decided not to purchase it. This is important information so that we can optimize conversion and offer more compelling Weather Guarantees to customers.

Modifying Bookings and Weather Guarantees

See the Customer modifies their reservation section.

Cancelling Bookings and Weather Guarantees

See the Customer cancels their reservation section.