Connect Your Account with Stripe

Set up Stripe in just a few steps to receive payments securely and seamlessly.

API Key Setup

  1. Go to  Settings > Hostaway API

  2. Under the Hostaway Public API, you will find:

  3. Click on the Create button

  4. Enter a name

  5. You will see the API key. We will show it only one time! Make sure to save it

    You can find more information about the API key in this article.

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}