Stripe

Stripe Connect Checkout Sessions for one-time guest payments. Creates a hosted payment page the guest opens to pay; supports authorize-now/capture-later or immediate charge per booking type. Stripe official site ↗

What it covers

Checkout Sessions and their payment lifecycle. The concierge can create a hosted Stripe payment page for an amount, share the link with the guest, and read back whether it was paid. The guest enters their card on Stripe's own page — card details never pass through Maison. For "rooms" bookings, the capture mode is set separately from "experiences", so a hotel can authorize a room charge and capture on check-out while charging experiences immediately. Staff-facing tools cover PaymentIntent capture, cancel, and refunds.

Stripe Connect — no key for the operator. Maison holds one platform secret key shared across all hotels. Each hotel is a Stripe connected account (Account ID beginning with acct_). The hotel operator pastes their Account ID — never a secret key — on the integration's settings page.

What you need

The hotel's Stripe connected account ID (begins with acct_). Find it in the Stripe Dashboard under Connect > Accounts.
A capture mode for rooms and for experiences: "Authorize" holds the card now and lets the hotel capture on check-out; "Charge immediately" debits the guest when they complete checkout.
A default currency code (ISO 4217, e.g. USD, EUR, GBP).
Success and cancel URLs where Stripe redirects the guest after payment.
A checkout session expiry in minutes (30–1440). After this window the link expires and the guest must request a new one.

Setup steps

Find the connected account in the Stripe Dashboard
Go to Connect > Accounts in the Stripe Dashboard and find the account for this property. Copy the Account ID — it begins with acct_.
Enter the Account ID in the admin console
Paste the Account ID on the integration's settings page. No secret key is needed from the operator — Maison's platform key handles authentication.
Choose capture modes
Set capture mode separately for rooms and for experiences. Authorize holds the card and lets the hotel capture on check-out; Charge immediately debits the guest at checkout.
Configure currency, URLs, and expiry
Set the default currency, the success and cancel redirect URLs, and how many minutes a checkout session stays open before expiring.

Available tools

8 tools are available for Stripe. The concierge calls them on a guest's behalf during a conversation; which are enabled is set per property, so you only turn on what you want it to be able to do.

Enabled by default (6)

On as soon as the integration is connected, with nothing else to configure.

Tool	What it does
`stripe_get_checkout_session`	Retrieve the current state and payment URL of a Stripe Checkout Session.
`stripe_get_customer`	Retrieve a Stripe Customer record by ID. Returns only non-sensitive fields — no payment methods or bank details.
`stripe_get_payment_intent`	Retrieve a PaymentIntent, including its capture status and amount available for capture.
`stripe_get_refund`	Retrieve the status and details of a specific refund.
`stripe_list_checkout_sessions`	List Checkout Sessions, optionally filtered by reservation reference or payment intent.
`stripe_list_payment_intents`	List PaymentIntents, optionally filtered by customer or limit.

Available on request (2)

Off by default. Ask Maison to enable any of these for your property — several change data in your Stripe account, so they are opt-in rather than assumed.

Tool	What it does
`stripe_create_checkout_session`	Create a Stripe Checkout Session to collect payment from a guest. Returns a hosted payment URL (`url`) the guest opens to pay. The session expires in 30 minutes. Use reservationReference to correlate with the hotel's booking system.
`stripe_get_charge`	Retrieve a Stripe Charge by ID — the settled record behind a captured payment intent (`latest_charge`). Carries the guest receipt link (`receipt_url`). Read-only; no card data.

Not yet certified (8)

Built and working against the Stripe API, but Maison is not yet certified with Stripe to use them in production, so they cannot be enabled today. Listed so you can see what is coming rather than discover the gap when you ask for it.

Tool	What it does
`stripe_cancel_payment_intent`	OPERATOR-GRADE: Cancel an authorized PaymentIntent, releasing the hold on the guest's card.
`stripe_capture_payment_intent`	OPERATOR-GRADE: Capture a previously authorized PaymentIntent. Optionally provide an amount to capture less than the authorized amount (partial capture).
`stripe_create_payment_method_domain`	OPERATOR-GRADE: Register a domain for Apple Pay / Google Pay support. The domain must already host the /.well-known/apple-developer-merchantid-domain-association file.
`stripe_create_refund`	OPERATOR-GRADE: Refund a captured payment. Omit amount for a full refund; provide it for a partial refund (in major currency units).
`stripe_expire_checkout_session`	OPERATOR-GRADE: Expire an open Checkout Session immediately so it can no longer be paid. Cannot be undone.
`stripe_list_payment_method_domains`	OPERATOR-GRADE: List payment method domains registered for Apple Pay / Google Pay support on this connected account.
`stripe_list_refunds`	List the refunds issued against one PaymentIntent, newest first: each refund's id, status, amount (minor units) and currency.
`stripe_validate_payment_method_domain`	OPERATOR-GRADE: Validate that a registered payment method domain still serves the required Apple Pay verification file.