Stripe is a Pro online gateway. It uses a secure Stripe Payment step after the booking has been created and before the final confirmation result is shown. The site must never store raw card details.
Configure
- Open Hotel Booking → Settings → Payments.
- Find Stripe, select Enable this payment method and choose Test mode for a sandbox rehearsal or Live mode only for an approved launch.
- Enter the Stripe Publishable Key, Secret Key and Webhook Signing Secret. Saved secrets are encrypted and are not shown again.
- Register the displayed Stripe webhook URL in Stripe for the required PaymentIntent events, then save the matching
whsec_signing secret. - Save settings and confirm the gateway reports configured.
Verify the journey
Use a dedicated test guest and Stripe test card in Test mode. Submit Book Now once. The expected sequence is Book Now → Payment → Booking Confirmation. Confirm the Payment step shows the server amount and currency, the browser returns after a verified result and the confirmation shows the ledger-derived status. A pending or failed payment leaves a recoverable booking without silently marking it paid.
Stripe callbacks must be signature-verified, idempotent and matched to the transaction amount and currency. Do not copy a client secret, secret key, card number or webhook signing secret into a screenshot or support case. The confirmation must not contain Payment Element credentials.
If the webhook is delayed, compare the redacted Stripe event ID with the booking’s payment timeline before retrying. Never create a second booking to work around a pending payment.