Stripe Payments

Connect your Stripe account to PropPilot to accept reservation fees and payments from customers through your AI agent.

Prerequisites

Before setting up Stripe:

• ✅ A Stripe account (create one at stripe.com)
• ✅ Admin or Owner role in PropPilot
• ✅ Business verification completed in Stripe (for live payments)

What You Can Do

With Stripe integration, you can:

• Accept reservation deposits and fees
• Create payment links for customers
• Track payment status in real-time
• View payment history and logs
• Issue refunds when needed

Connection Methods

PropPilot supports two ways to connect Stripe:

Option 1: OAuth Connect (Recommended)

Connect using Stripe's secure OAuth flow:

1. Go to Integrations → Stripe tab
2. Click Connect with Stripe
3. Log in to your Stripe account
4. Authorize PropPilot to access your account
5. You're redirected back to PropPilot

Benefits:

• Most secure method
• Easy one-click setup
• Automatic credential management
• Supports Stripe Connect features

Option 2: API Key

For users who prefer manual configuration:

1. Go to Integrations → Stripe tab
2. Click Use API Key
3. Enter your Stripe Secret Key
4. Click Save

To find your API key:

1. Log in to Stripe Dashboard
2. Go to Developers → API keys
3. Copy the Secret key (starts with sk_)

Live vs Test Mode

• Test keys (start with sk_test_): For testing, no real charges
• Live keys (start with sk_live_): For real payments

Use test keys during setup, then switch to live keys for production.

Connection Status

After connecting, you'll see:

Status	Meaning
Connected	Stripe is active and ready
Test Mode	Using test keys (no real payments)
Live Mode	Using live keys (real payments)
Disconnected	Not connected
Error	Configuration issue

Payment Templates

Create reusable payment templates for common scenarios:

Creating a Template

1. Go to Integrations → Stripe tab
2. Click Payment Templates section
3. Click Create Template
4. Fill in the details:

Field	Description	Example
Name	Template identifier	"Reservation Deposit"
Amount	Payment amount	1000 (in cents) or 10.00
Currency	Currency code	USD, EUR, AED
Description	Shown to customer	"Deposit for Unit 501"

Using Templates

When generating a payment link:

1. Select a template
2. Customize if needed
3. Generate the link
4. Share with customer

Generating Payment Links

From PropPilot

1. Go to a contact's detail page
2. Click Create Payment or Request Payment
3. Select a template or enter custom amount
4. Click Generate Link
5. Copy and share the link with the customer

Through AI Agent

Your AI agent can generate payment links during conversations when:

• Customer confirms interest in a property
• Reservation fee is required
• Agent triggers payment workflow

Tracking Payments

Recent Payments

View recent payment activity in the Stripe integration tab:

Column	Description
Date	When payment was made
Customer	Contact name/email
Amount	Payment amount
Status	Succeeded, Pending, Failed
Reference	Stripe payment ID

Payment Statuses

Status	Meaning
Succeeded	Payment completed
Pending	Awaiting processing
Failed	Payment declined
Refunded	Money returned
Partially Refunded	Partial refund issued

Webhooks

PropPilot automatically receives Stripe webhooks for:

• Payment success notifications
• Payment failure alerts
• Refund confirmations
• Dispute notifications

You don't need to configure webhooks manually.

Notifications

When payments are processed:

1. Email: Customer receives a confirmation email in their preferred language (English, Spanish, Arabic, or Portuguese).
2. In-App: Notification appears in PropPilot
3. Chatwoot: Message sent to customer chat (if enabled)

The language used in the email is set by the contact's preferred language in their profile. If no preference is set, English is used by default.

See Payment Notifications for configuration.

Refunds

To issue a refund:

1. Find the payment in Recent Payments
2. Click on the payment row
3. Click Refund
4. Enter refund amount (full or partial)
5. Confirm the refund

Refunds typically take 5-10 business days to appear in customer accounts.

Troubleshooting

Connection Failed

1. Verify your Stripe account is active
2. Check API key is correct (no extra spaces)
3. Ensure you're using the right key type (test vs live)
4. Try OAuth connection instead

Payments Not Processing

1. Check Stripe Dashboard for errors
2. Verify you're in the correct mode (test vs live)
3. Ensure customer payment method is valid
4. Review Stripe webhook logs

Webhooks Not Working

1. PropPilot configures webhooks automatically
2. Check Stripe Dashboard → Webhooks for delivery status
3. Disconnect and reconnect Stripe to reset webhooks

Testing Payments

Use Stripe test cards to verify your setup:

Card Number	Result
4242 4242 4242 4242	Successful payment
4000 0000 0000 0002	Declined
4000 0000 0000 9995	Insufficient funds

Use any future expiry date and any 3-digit CVC.

Going Live

Before accepting real payments:

1. ✅ Test thoroughly with test keys
2. ✅ Complete Stripe business verification
3. ✅ Switch to live API keys
4. ✅ Verify webhook endpoints
5. ✅ Process a small real payment as final test

Security

• All API keys are encrypted in PropPilot
• Stripe handles all sensitive card data
• PropPilot never sees full card numbers
• PCI compliance handled by Stripe

What's Next?

• Managing Contacts - View customer payments
• Billing - PropPilot subscription