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].
About “Preferred Channel Type” Setting
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.”
If you want to limit Stripe payments to specific channels (e.g., Booking.com only or Vrbo only), you can control this by configuring the “Preferred Channel Type”.
On the other hand, if the “Preferred Channel Type” is left blank (not set), all bookings that are eligible for Stripe payments will be processed via Stripe by default.
Therefore, by selecting a non-linked channel type, you can configure the setting to apply only to specific channels.
Note: You may select any channel type that is not currently connected, as all of them are acceptable.
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.
⚠️ If using the automatic payment feature
In the Booking Engine’s Auto Payment function, only credit card payments (Stripe / GMO fincode) are supported. Therefore, when linking a payment method, please select “Credit Card.”
Payment accounts set as “Bank Transfer,” “Cash Payment,” or “Other” will not appear as selectable options in the Auto Payment settings.
If you want to use automatic payment, please ensure that the payment method type of the payment account is set to “Credit Card.”
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% for properties in Japan. The fee may vary depending on the country, so we recommend checking directly with Stripe for the most accurate information.
This fee is applied to guest accommodation payments and is automatically deducted during settlement.