Stripe

This guide walks you through configuring the Stripe webhook first (required before adding the API key), followed by adding your Secret key in the Finance Portal.

---

Step 1: Set Up the Webhook in Stripe

1. Log in to your Stripe Dashboard.

2. Go to Developers → Webhooks.

3. Click Add endpoint and enter the following Endpoint URL:

https://api.hostelmate.co/api/v1/online/stripe/process-request

1. Click Select events and subscribe to:

• checkout.session.completed

• checkout.session.async_payment_succeeded

• checkout.session.async_payment_failed

1. Click Add endpoint to save the webhook.

💡 Why this order? Hostel Mate checks for valid and active webhook events when you connect Stripe. Creating the webhook first ensures a smooth validation when adding the Secret key.

---

Step 2: Add Your Stripe Secret Key

1. Go to your Finance Portal → Apps → Stripe.

2. In the API Key field, paste your Secret key from the Stripe Dashboard:

• Use sk_test_... for testing

• Use sk_live_... for production

1. Click Save to finalize the integration.

2. Optional: in Stripe, switch to Live mode and collect a small live payment to confirm everything is connected.

Use Test mode while testing. When ready to go live, switch both the Stripe Dashboard and the Finance Portal to Live mode.

---

Once both fields are saved, your system will automatically verify:

• The Secret key’s validity.

• That the webhook is active and listening for the required events.

After verification, Stripe payments will be fully enabled for bookings.

Troubleshooting

• Webhook not firing: verify you selected the three required events and copied the exact endpoint URL

• Signature errors: re-copy the webhook signing secret in Stripe and update it in Hostel Mate if prompted

• Test vs Live mix-up: ensure both Stripe and Hostel Mate are set to the same mode