Integrating Stripe with Haletale: A Step-by-Step Guide

Haletale integrates seamlessly with Stripe to enable secure online payments for rent collection. This guide will walk you through the process of connecting your Stripe account with Haletale, ensuring smooth transactions for tenants and property managers alike.

Step 1: Setup Webooks

1. Login to your Stripe account

2. Under developer settings, go to Webhooks section

3. Click on Add endpoint

4. In endpoint URL field, enter the below api end point after changing ur company unique name in the tenant parameter
   https://api.haletale.com/api/v1/payments/stripe_transaction_webhook?tenant=companyname

5. Replace 'companyname' with your actual company name.

6. To find your company name: Login to your whitelabelled Haletale Platform > Go to Settings > Edit White Label Product > Locate the Name field (See 'demo' in the below screenshot).

7. After adding the endpoint URL on stripe, continue to setup the webhooks. For the 'listen to' radio buttons, select 'events on your account' option.

8. Keep the Version as default one

9. Under the 'Select events to listen to', Select all Payment Intent events (see below screenshot)

10. Finally, Click on add endpoint button

Step 2: Create Your API Keys in Stripe

To integrate Stripe with Haletale, you will need two API keys: a publishable key and a secret key.

1. Log in to your Stripe account at Stripe Dashboard.

2. In the search bar, type "API Keys" and select it from the results. This will take you to the Developers section.

3. You will see a Publishable Key on this page. Copy this key for later use.

1. Navigate back to the API Keys section in Stripe.

2. Click on Create Secret Key.

3. A prompt will ask you, "How will you use this API key?"

4. Choose the second option: "You are using this key in a project you are building."

5. Name the key (e.g., "Haletale Integration") and create the key.

6. Copy the Secret Key and keep it secure. Note: You will not be able to view it again once you leave this page.

Step 3: Connecting Stripe to Haletale

Once you have your API keys, follow these steps to complete the integration:

1. Log in to your Haletale account.

2. Navigate to Settings > Integrations.

3. Locate the Stripe option and click on "Connect".

4. Paste your Publishable Key in the required field.

5. Return to Stripe and copy the Secret Key, then paste it into the respective field in Haletale.

6. Click "Save" to finalize the integration.

Step 4: Configure Payout Details

To ensure successful rent payments, you must configure both card and bank transfer options in Haletale:

1. Go to Settings > Payout Details.

2. Select Card as a payment method.

3. Choose a bank transfer method based on your region:

   • United States: ACH (Automated Clearing House)

   • Canada: EFT (Electronic Funds Transfer)

   • Europe: SEPA (Single Euro Payments Area)

4. Ensure the processing fees are accurately configured for card payments. These fees can be adjusted to pass on the transaction charges to tenants.

Step 5: Activate all payment methods on Stripe

To ensure that all the payment methods are activated by stripe go to https://dashboard.stripe.com/settings/payment_methods and open default method.

Make sure that the required payment methods are already turned on .

After saving your settings:

1. Make a small test transaction to ensure the connection is working correctly.

2. Verify that rent payments are being processed and deposited into your chosen bank account.

With Stripe successfully integrated into Haletale, your tenants can now make rent payments securely and conveniently. This automation helps property managers streamline financial transactions and improve cash flow.

For further assistance, reach out to Haletale Support or visit Stripe’s API Documentation for advanced configurations