Solutions for payment problems and Stripe errors.
Stripe Connect Not Active
"Payment account not configured"
Cause: Stripe Connect setup not completed
Solution:
-
Settings → Payments
-
Check status
-
If "Incomplete": Click "Finish Setup"
-
If "Pending": Wait for Stripe verification
Payments Fail
Guest cannot pay
Common causes:
- Credit card declined
- Insufficient funds
- Card limit reached
- 3D Secure failed
Solution for guest:
-
Use different payment method
-
Contact bank
-
Increase card limit
"Payment processing error"
Solution:
-
Check Stripe Connect status
-
Ensure support contact is filled
-
Settings → Organization → Support Email/Phone
-
Open Stripe Dashboard for details
Refunds
Refund fails
Cause: Insufficient balance on Stripe account
Solution:
- Stripe charges refund from your account
- Ensure sufficient balance available
- Alternatively: Stripe charges from bank account (takes longer)
Guest doesn't receive refund
Normal: 5-10 business days
Solution:
-
Check refund status in Bookings
-
Stripe Dashboard → Check refunds
-
If delay >10 days: Guest should contact bank
Payouts
Payout delayed
Cause: Stripe verification pending
Solution:
-
Open Stripe Dashboard
-
Check notifications
-
Submit additional documents if required
-
For questions: Contact Stripe Support
Payout to wrong account
Solution:
-
Stripe Dashboard → Settings → Payouts
-
Change bank account
-
Next payout goes to new account
Fees
Unexpected Stripe fees
Normal: ~1.4% + 0.25 CHF per transaction
Additional fees for:
- International cards: +1%
- Currency conversion: +1-2%
- Chargebacks/disputes: 15 CHF
Solution:
- Stripe Dashboard → Reports for detailed breakdown
- For questions: Stripe Support
Security Deposit
Deposit charged
Normal: Security deposit is only hold, not charge
Problem: Deposit was actually charged
Solution:
-
Check in Stripe Dashboard
-
If error: Manual refund
-
Contact support with Booking ID
Deposit release delayed
Normal: Automatically 7 days after check-out
If delayed:
- Stripe Dashboard → Check authorizations
- Manually release if needed
Disputes & Chargebacks
Guest filed chargeback
Immediately:
-
Email notification from Stripe
-
Open Stripe Dashboard
-
Upload all relevant documents:
- Booking confirmation
- Email communication
- Check-in/check-out confirmation
- Cancellation policy
Deadline: 7 days to respond
Fee: 15 CHF (regardless of outcome)
Value Added Tax (VAT)
VAT on bookings
You set a single VAT rate per property in Pricing settings, applied to the full booking subtotal (accommodation, extra guest fees, cleaning fee).
Configuration:
- Set your VAT rate under Property → Pricing
- Choose whether prices already include VAT, or VAT is added on top
- Transparency for guests important
Check with a local tax advisor for the correct rate and rules in your country.
Contact Support
For persistent problems:
-
Stripe Support:
- dashboard.stripe.com/support
- For Stripe-specific problems
-
Stayoa Support:
- support@stayoa.app
- For integration problems
Have ready:
- Booking ID
- Error message
- Time of problem
- Screenshots