Getting Started
Payment Setup
Stripe
Stripe is the recommended payment gateway for FreshStay.
1
Create Stripe Account
Sign up at [stripe.com](https://stripe.com) and complete your business verification.
2
Get API Keys
Navigate to Developers → API Keys in your Stripe dashboard.
3
Configure Environment
Add your Stripe credentials to the `.env` file:
ENV
STRIPE_KEY=pk_live_your_publishable_key STRIPE_SECRET=sk_live_your_secret_key STRIPE_WEBHOOK_SECRET=whsec_your_webhook_secret
4
Set Up Webhooks
In Stripe Dashboard → Webhooks, add your endpoint URL: `https://yourdomain.com/stripe/webhook`
**Note:** Use test keys (`pk_test_` / `sk_test_`) during development. Switch to live keys for production.
PayPal
FreshStay supports PayPal for markets where Stripe is not available.
ENV
PAYPAL_MODE=live PAYPAL_CLIENT_ID=your_client_id PAYPAL_CLIENT_SECRET=your_client_secret
**Tip:** Use `PAYPAL_MODE=sandbox` for testing with PayPal sandbox credentials.
Razorpay
For the Indian market, FreshStay integrates with Razorpay:
ENV
RAZORPAY_KEY=rzp_live_your_key_id RAZORPAY_SECRET=your_key_secret
Enable/Disable Gateways
You can enable or disable payment gateways from the admin panel:
- Navigate to Admin → Settings → Payment Gateways
- Toggle each gateway on or off
- Set the default gateway for new bookings
- Configure currency and minimum payout amounts per gateway
Was this page helpful?