PayPal Integration
PayPal provides an alternative payment method for guests who prefer it. LodgeKit integrates with PayPal Checkout so guests can pay directly from their invoices using PayPal balance, linked bank accounts, or cards.
Setting Up PayPal
Go to [Dashboard > Settings > Integrations](/dashboard/settings/integrations) and find the PayPal card. You'll need your Client ID and Client Secret from the PayPal Developer Dashboard.
Getting Your Credentials
Log in to [developer.paypal.com](https://developer.paypal.com) and go to Apps & Credentials. Create a new app or select an existing one. Copy the Client ID and Client Secret.
Entering Credentials
In the PayPal card on the integrations page, enter your Client ID, Client Secret, and select the Environment (Sandbox for testing, Live for production). Click Connect to save. Your credentials are encrypted at rest.
Testing the Connection
After connecting, click Test Connection to verify your credentials. LodgeKit will generate a PayPal OAuth token to confirm the credentials are valid. A green "Connection verified" message confirms everything is working.
Sandbox Testing
PayPal provides a sandbox environment for testing. Create sandbox accounts at developer.paypal.com and use sandbox credentials during setup. Test the full payment flow before switching to live credentials by disconnecting and reconnecting with production keys.
How Guest Payments Work
When a guest clicks Pay with PayPal on an invoice (via the portal or a payment link), they're redirected to PayPal to authorize the payment. Once completed, they're returned to LodgeKit and the payment is recorded automatically.
Troubleshooting
Common issues and how to resolve them.
Test Connection Fails
If the test connection fails, check that your Client ID and Client Secret are correct and belong to the same app. Ensure you've selected the right environment — sandbox credentials won't work with the live environment and vice versa. Try disconnecting and re-entering your credentials.
Payment Not Completing
If guest payments aren't completing, verify the PayPal connection is still active by clicking Test Connection on the [integrations page](/dashboard/settings/integrations). Check that your PayPal account is in good standing and not restricted.
Was this article helpful?