Overview:
By using Stripe integration, you can automate various types of payments, such as:
Authorization and payment processing using card information received from OTAs
(supports Booking.com, Agoda, Expedia, Tiket.com, Traveloka, Vrbo, Trip.com)Payments for AirHost Booking Engine reservations
Payments for upsells and additional services
Setup Instructions
We will now explain the setup steps.
⚠️ To use Stripe integration, you need to purchase the “Payment Solution Integration” option.
Details:
How to Create a Stripe Account
Please create an account at: https://stripe.com/sg
After creating your Stripe account, please confirm the following two settings on the Stripe side:
You must complete phone verification under “Business Settings > Account Settings.”
2. Under “Business Settings > Business Information”, you must complete the entry of all information required for tax reporting purposes.
How to Add Your Created Stripe Account
1) Add a Payment Account
Go to [Admin Console] → [Payment Accounts].
Click [Add Payment Account], select [Credit Card], and then choose [Stripe].
Note:
If you want to automate authorization and payment processing for card information received from OTAs such as Booking.com, set it as the “Preferred Channel Type.”
2) Linking the Payment Account to a Property
To use your Stripe account for a property, go to:
[Settings] → [Payment Methods] → [Link a Payment]
Then, link the payment account to the property.
3) Using Stripe for OTA Payments / Booking Engine Payments
If you want to use Stripe for:
Authorization and payment processing of card information received from OTAs, or
Payments for AirHost Booking Engine reservations,
go to: [Channel Manager] → [Auto Payment Collection] Then, set your Stripe account as the payment account.
For more details, please refer to:
[Reservation Management] How to Set Up Automatic Payments
4) Using Stripe for POS / Upsells / On-site Payments
If you want to use Stripe for:
POS services,
Manually added upsell items, or
On-site payment reservations,
go to: [Check-in Management] → [Common Settings] → [Payment Collection Account]
Then, set your Stripe account as the payment account.
Authorization / Credit Check
Normally, an authorization (auth) performs a credit check.
For Stripe, the credit check works by first charging the full amount to the card to confirm it’s valid, and then immediately canceling the charge.
This may display as “Uncaptured (Authorization Held)” in Stripe.
The behavior of an authorization can differ depending on the card company, so we cannot explain the exact internal authorization process.
Card Types
Some card types (currently reported: American Express and JCB) may send a notification to the guest during authorization or when the authorization is canceled.
Notifications may also appear when the auth expires. Please confirm the exact behavior with the card company.
Avoiding Guest Notifications
To prevent guests from receiving notifications:
Go to [Channel Manager] → Auto Payment Collection
Enable the setting “Only validate card number, do not authorize”.
This will only verify if the card information is correct without performing a full authorization.
⚠️ Risk: Since no authorization is performed, there is a higher chance of payment errors when capturing funds. Please understand this risk before enabling this option.
About Authorization
Authorization temporarily secures the card’s available balance.
Example: A card with a limit of 1,000,000 JPY with a 100,000 JPY authorization will have only 900,000 JPY available until the authorization expires.
Authorizations have a validity period, which varies depending on the card company (and sometimes on the amount).
When Authorization Fails or Expires
If the authorization fails or expires, it must be re-authorized.
After the first authorization, if check-in occurs within the validity period, there’s no issue.
Once the auth expires, Stripe (or the connected payment solution) notifies AirHost that the authorization has expired. Re-authorizing will extend the authorization period as needed.
How to Check Payment Status
You can check the status of the linked Stripe payment from the reservation details page.
For instructions on how to check Stripe payments (authorized), please refer to the video provided.
If the payment has been completed, it will be displayed as follows.
How to check payment processing fees
You can check the Stripe payment fees from the reservation number on the reservation details page.
The fee amount is calculated based on the " Preferred Fee Rate " you set when " Adding a Stripe Account ".
What is the Stripe payment fee?
The Stripe payment fee in AirHost is 3.6%.
This fee is applied to guest payments for accommodation charges and is automatically deducted during settlement.