HotelRaxa/SETUP_INSTRUCTIONS.md

Hotel Raxa - Setup Instructions

Quick Configuration Guide for New Features

1. Configure 10% VAT in Eagle Booking

1. Access WordPress Admin

   • Go to your WordPress admin panel
   • Navigate to Eagle Booking → Taxes & Fees

2. Add VAT Tax

   • Click "Add New Tax"
   • Title: VAT or IVA
   • Rate: 10 (percentage)
   • Global: Check "Yes" (applies to all rooms)
   • Additional Services: Check "Yes" (applies to services)
   • Click "Save"

3. Configure Tax Display

   • Go to Eagle Booking → Settings → General
   • Find "Price Display" setting
   • Select "Including Taxes & Fees" to show "Including 10% VAT"
   • Or select "Excluding Taxes & Fees" to show taxes separately
   • Save settings

2. Activate Tourist Tax Plugin

1. Plugin Activation

   • Go to Plugins → Installed Plugins
   • Find "Eagle Booking Tourist Tax"
   • Click "Activate"

2. Verify Tourist Tax

   • Go to Eagle Booking → Tourist Tax
   • Confirm rate is set to €2.20 per person per day
   • Review statistics and settings

3. Configure Payment Requests System

1. Access Payment Requests

   • Go to Eagle Booking → Payment Requests

2. Configure Automatic Requests

   • Enable "Send payment requests automatically 14 days before check-in"
   • Set "Payment Percentage" to 50%
   • Set "Days Before Check-in" to 14
   • Save settings

3. Test Manual Payment Request

   • Enter a test booking ID
   • Set customer email and amount
   • Send a test payment request
   • Verify email delivery and payment link

4. Configure Preauthorization (Optional)

1. Access Redsys Settings

   • Go to Eagle Booking → Payment Methods → Redsys

2. Enable Preauthorization

   • Check "Enable Preauthorization"
   • Set "Preauthorization Amount" to desired option:
     • Full booking amount (recommended)
     • Deposit amount only
     • Fixed amount
   • Enable "Auto-capture Preauthorizations" for automatic processing
   • Set "Preauthorization Expiry" to 7 days (maximum)
   • Save settings

3. Monitor Preauthorizations

   • Go to Eagle Booking → Preauthorizations
   • Review active preauthorizations
   • Capture or cancel as needed

5. Configure Payment Scheduler

1. Access Scheduler Settings

   • Go to Eagle Booking → Payment Scheduler

2. Configure Automation

   • Set "Days Before Check-in" to 14
   • Set "Payment Percentage" to 50%
   • Set "Payment Link Expiry" to 72 hours
   • Enable "Admin Notifications" for error alerts
   • Save settings

3. Test Manual Run

   • Click "Run Manual Check"
   • Review results and activity log

Integration Summary

How the Systems Work Together

1. Booking Process:

   • Customer makes booking through Eagle Booking
   • 10% VAT automatically calculated and displayed
   • Tourist tax (€2.20/person/day) automatically added
   • Payment can be processed via:
     • Immediate payment (traditional)
     • Preauthorization (hold funds)
     • Payment request (send later)

2. Automated Payment Flow:

   • System checks daily for bookings 14 days before check-in
   • Automatically sends payment requests for 50% of booking
   • Customers receive professional email with secure payment link
   • Payment processed through Redsys gateway
   • Admin receives notifications for any issues

3. Admin Management:

   • Full visibility of all payment requests
   • Preauthorization management (capture/cancel)
   • Tourist tax statistics and reporting
   • Automated scheduler monitoring

Database Tables Created

The following new tables are automatically created:

• wp_eb_payment_requests - Payment request tracking
• wp_eb_preauthorizations - Preauthorization management
• wp_eb_payment_scheduler_log - Automated scheduler activity log

Email Templates

Professional email templates are included for:

• Payment request notifications
• Pre-arrival payment reminders
• Admin error notifications

Security Features

• Secure payment links with unique tokens
• Time-limited payment links (configurable expiry)
• CSRF protection on all admin forms
• Input validation and sanitization
• Encrypted payment processing via Redsys

Support & Troubleshooting

Common Issues

1. Cron Jobs Not Running

   • Ensure WordPress cron is enabled
   • Check with hosting provider about cron job support
   • Use WP-CLI or plugin to test cron functionality

2. Email Delivery Issues

   • Configure SMTP plugin for reliable email delivery
   • Check spam folders
   • Verify sender email address

3. Payment Gateway Issues

   • Verify Redsys credentials are correct
   • Check test/live mode settings
   • Ensure SSL certificate is valid

Log Files

Monitor these locations for troubleshooting:

• WordPress debug log (wp-content/debug.log)
• Payment scheduler activity log (admin interface)
• Eagle Booking logs (if available)

Testing Checklist

Before going live, test:

• VAT calculation on booking forms
• Tourist tax calculation and display
• Manual payment request creation and sending
• Payment link functionality and expiry
• Preauthorization capture and cancellation
• Automated scheduler (run manual check)
• Email delivery and formatting

Production Deployment

1. Backup Database: Always backup before making changes
2. Test Environment: Test all features in staging first
3. SSL Certificate: Ensure valid SSL for payment processing
4. Email Configuration: Set up reliable SMTP for email delivery
5. Monitoring: Enable admin notifications and monitor logs
6. Documentation: Keep this guide accessible for future reference

---

Generated: $(date) Version: 1.0.0 Contact: dev@hotelraxa.com