Integrations

Overview

The Integrations page connects LeaseLlama with third-party services. Currently, the primary integration is Stripe for payment processing.

To get here: Go to Administration → Integrations.

Connecting Stripe

Stripe lets you accept credit and debit card payments, process automatic charges, and handle refunds.

What you’ll need

Get your API keys from the Stripe Dashboard:

1. Log into dashboard.stripe.com
2. Click Developers (top right)
3. Select API keys
4. Copy your Publishable key and Secret key

Entering your credentials

Field	Starts with	Required
Publishable Key	pk_live_ or pk_test_	Yes
Secret Key	sk_live_ or sk_test_	Yes
Account ID	acct_ (for Stripe Connect)	No
Webhook Secret	whsec_	Yes

Your secret key and webhook secret are stored encrypted. Once saved, they display as dots for security.

Steps

1. Enter your Publishable Key and Secret Key
2. Optionally enter your Account ID (Stripe Connect only)
3. Click Save Credentials
4. LeaseLlama verifies your credentials
5. A green “Connected” badge confirms the connection
6. Continue to set up the webhook (below)

Setting up the Stripe webhook

Webhooks let Stripe notify LeaseLlama when payments succeed, fail, or get refunded. Without a webhook, payments will show as “Pending” even after successful charges.

Step 1: Create the endpoint in Stripe

1. In Stripe Dashboard → Developers → Webhooks
2. Click Add destination
3. Enter the endpoint URL: https://leasellama.app/api/stripe/webhook
4. Click Select events and add the following:

Event	Purpose
charge.refunded	Confirms a charge was refunded
charge.refund.updated	Tracks refund status changes
invoice.payment_succeeded	Confirms an invoice was paid
invoice.payment_failed	Alerts when an invoice payment fails
payment_intent.succeeded	Confirms a payment intent completed
payment_intent.payment_failed	Alerts when a payment intent fails
payment_intent.requires_action	Handles 3D Secure or other card authentication
refund.created	Tracks new refund creation
refund.updated	Tracks refund status updates
setup_intent.succeeded	Confirms a saved payment method was set up

5. Click Add destination

Important: All 10 events are required. Missing events can cause payment statuses to get stuck or refunds to not update correctly.

Step 2: Copy the signing secret

1. Click on the new endpoint in the webhooks list
2. Click Reveal on the Signing secret
3. Copy the secret (starts with whsec_)

Step 3: Enter in LeaseLlama

1. Paste the webhook secret in the Webhook Secret field
2. Click Save Credentials

Verify it’s working

Process a test payment — the invoice status should update to “Paid” automatically. If it stays “Pending,” check the webhook URL, secret, and selected events.

Test mode vs. live mode

Mode	Key prefix	Use for
Test	pk_test_, sk_test_	Testing without real charges
Live	pk_live_, sk_live_	Accepting real payments

Recommended: Connect with test keys first. Verify the full payment flow works. Then switch to live keys.

Managing the connection

• Test Connection — verify credentials without making changes
• Disconnect — removes the Stripe connection (stops all card payment processing)

Troubleshooting

Problem	Solution
”Unable to verify credentials”	Check you copied the full key; ensure both keys are test or both are live
Payments stuck in “Pending”	Webhook isn’t set up, or the secret doesn’t match
”Connection test failed”	Check your internet; verify your Stripe account is active

What to read next

I want to…	Read this
Configure billing rules and taxes	System Settings
Set up the rental agreement	Contracts
Start billing renters	Checking Out a Space