💳Stripe Payment Gateway Setup

This guide walks you through linking the Stripe payment gateway to your system, enabling payment processing for bookings.

Prerequisites:

• A Stripe account.

• Access to the Finance Portal where you manage your payment gateways.

Step 1: Obtain Your Stripe API Token

1. Log in to your Stripe Dashboard.

2. Navigate to the Developers section from the left-hand menu.

3. Under the API keys tab, find the Secret Key and copy it. This key allows your system to authenticate with Stripe.

Step 2: Access the Finance Portal

1. Log in to the Finance Portal where you manage payment gateways.

2. In the left-side navigation bar, click on Apps.

3. From the dropdown menu, select Stripe.

Step 3: Add the API Token

1. In the Stripe section, paste the Secret API token you copied earlier into the provided field.

2. Click Save to store the API token and complete the integration.

Step 4: Set Up Webhook URL in Stripe

To receive payment notifications and process updates, configure the Webhook URL:

1. In your Stripe Dashboard, go to Developers > Webhooks.

2. Click on Add Endpoint.

3. In the Endpoint URL field, enter the following URL:

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

4. Under Event types, subscribe to the checkout.session.completed event. This event will notify your system when a payment is successfully completed.

5. Click Add Endpoint to save the webhook configuration.

Once the API token and Webhook URL are set up, your system will allow guests to pay and confirm bookings directly.

Charging Guests for Stripe Fees

A toggle input is available in the Finance Portal that allows hosts to choose whether guests will cover Stripe fees.

• If enabled, guests will be charged the booking/service amount plus the Stripe fees.

• If disabled, the host will cover the Stripe fees as usual.

This setting provides flexibility in handling transaction costs based on your business needs.

Disabling Stripe Integration

If you no longer wish to use Stripe for processing payments:

1. Go to the Stripe settings in the Finance Portal.

2. Clear the API token field.

3. Click Save to disable the integration.