Stripe Integration
Stripe lets your guests pay invoices by credit or debit card. Payments are processed securely through Stripe and recorded automatically in LodgeKit. You can also enable Stripe for the guest self-service portal.
Setting Up Stripe
Go to [Dashboard > Settings > Integrations](/dashboard/settings/integrations) and find the Stripe card. You'll need your API keys from the Stripe Dashboard.
API Keys
LodgeKit needs your Stripe publishable key and secret key. Log in to your Stripe Dashboard and go to Developers > API Keys. Copy both keys into your LodgeKit hosting configuration. Use test keys during setup and switch to live keys when you're ready.
Testing the Connection
Once your API keys are configured, click Test Connection on the [integrations page](/dashboard/settings/integrations) to verify everything is working. LodgeKit will call the Stripe API to confirm your keys are valid. A green "Connection verified" message confirms success.
Configuring Webhooks
Webhooks let Stripe notify LodgeKit about payment events in real time. In your Stripe Dashboard, go to Developers > Webhooks and add the endpoint URL shown in LodgeKit's Stripe settings. Select the events: payment_intent.succeeded, payment_intent.payment_failed, and charge.refunded.
Guest Portal Payments
With Stripe connected, guests can pay their invoices directly from the self-service portal. They'll see a Pay Now button on each unpaid invoice. Payments are processed securely via Stripe Checkout and recorded automatically.
Testing Payments
Before going live, test with Stripe's test card numbers. Use 4242 4242 4242 4242 with any future expiry date and any 3-digit CVC. Verify that test payments appear correctly in both Stripe and LodgeKit.
Troubleshooting
Common issues and how to resolve them.
Test Connection Fails
If the test connection fails with "Invalid API Key", double-check that you've entered the correct secret key (starts with sk_test_ or sk_live_). Make sure you haven't accidentally used the publishable key. If the key is correct, check that your Stripe account is active and not restricted.
Payments Not Syncing
If payments complete in Stripe but don't appear in LodgeKit, check your webhook configuration. Go to Developers > Webhooks in Stripe and verify the endpoint URL is correct and the webhook secret matches. Check for failed webhook deliveries in the Stripe Dashboard.
Was this article helpful?