Effortless integration of StretchBill into your direct booking site
Overview
Adding StretchBill to your direct booking site is easy and designed to be done in under an hour. Below are the steps required:
Integrate with Hostaway
Integrate with Track
Add the StretchBill button and upsell to your site
Include a button in your site to initiate the StretchBill (SB) payment flow.
This button should open an iframe to render the SB flow.
Send reservation data to StretchBill to pre-populate the flow
The iframe should use the following URL structure, dynamically populated with reservation details:
Link template
https://stage.stretchbill.com/?bookingId=[ReservationId]&propertyPrice=[TotalReservationAmount]&propertyManagerId=[PropertyManagerId]&reservationDates=%7B%22startDate%22%3A%22[ArrivalDate]%22%7D
Link example
https://stage.stretchbill.com/?bookingId=12345&propertyPrice=500&propertyManagerId=H7pYP8n8JkWr21kUhJyfknfCHgP2&reservationDates=%7B%22startDate%22%3A%222024-12-31%22%7D
Listen for the result events from StretchBill
Once the user completes the payment flow, the StretchBill application hosted in the iframe will send events back to the parent window of your direct booking site. These events indicate whether the transaction was successful or not.
Successful Payment Event
> If the StretchBill transaction is successful:
Use the event data to update the reservation in your PMS. You should also take the Renter to an “all done” or “booking successful” screen.
{type: "PAYMENT_STATUS", message: true}
Failed Payment Event
> If the StretchBill transaction fails:
You will receive a separate event indicating that there was a problem with the StretchBill transaction. You should direct the Renter to a credit card checkout option so the reservation is not lost. You may need to update your PMS to reflect this.
{type: "PAYMENT_STATUS", message: false}