How to Integrate Xtream UI Panel

Integrating Xtream UI / XUI Panel

Xtream UI (also known as XUI) is one of the most popular IPTV panel systems. This guide will show you how to integrate it with IPTVbp for automated subscription management.

Prerequisites

Before you begin, make sure you have:

• Xtream UI panel installed and running
• Admin access to your Xtream UI panel
• Panel URL (e.g., http://yourpanel.com:25500 or https://yourpanel.com)
• API access enabled in Xtream UI settings
• At least one package/bouquet created in Xtream UI

Step 1: Enable API Access in Xtream UI

First, ensure API access is enabled in your Xtream UI panel:

1. Log into your Xtream UI admin panel
2. Go to Settings → API Settings
3. Enable Allow API Access
4. Note down your API username and password (usually same as admin credentials)
5. Save settings

Step 2: Add Panel in IPTVbp

Now, add your Xtream UI panel to IPTVbp:

1. Log into your IPTVbp dashboard
2. Navigate to Services → IPTV Panels
3. Click Add New Panel
4. Fill in the panel details:
   • Panel Type: Select "Xtream UI"
   • Display Name: My Main Panel (or any name)
   • Panel URL: http://yourpanel.com:25500 (include port)
   • API Username: Your Xtream admin username
   • API Password: Your Xtream admin password
5. Click Test Connection to verify

Connection Test Results

If successful, you'll see:

• ✅ Connection successful
• ✅ API authenticated
• ✅ Packages loaded (shows number of available packages)

If it fails, check:

• ❌ URL is correct (include http:// or https:// and port)
• ❌ Panel is accessible from external IPs
• ❌ Credentials are correct
• ❌ API access is enabled

Step 3: Configure Package Mapping

Map your Xtream UI packages to IPTVbp products:

1. After adding the panel, click Configure Packages
2. You'll see a list of all packages from your Xtream UI panel
3. For each package, configure:
   • Package Name: As shown in Xtream UI
   • Package ID: Automatically retrieved
   • Description: Add details about this package
   • Max Connections: How many concurrent streams
   • Is Reseller: Toggle if this is for resellers
4. Save package configuration

Step 4: Create Products Linked to Packages

Now create products that customers can purchase:

1. Go to Products → Create New
2. Fill in product details:
   • Product Name: Premium IPTV - 1 Month
   • Price: $15.00
   • Billing Cycle: Monthly
3. In Panel Configuration:
   • Select your Xtream UI panel
   • Choose the package
   • Set number of connections (1-4 typically)
4. Configure trial period (optional):
   • Trial Duration: 24 hours / 3 days / 7 days
   • Trial Price: $0.00 or $1.00
5. Save and publish

Step 5: Test Automated Provisioning

Test that subscriptions are created automatically:

1. Place a test order in Stripe test mode
2. Complete checkout process
3. Check Subscriptions dashboard
4. You should see:
   • ✅ Subscription created with status "Active"
   • ✅ Credentials generated (username/password)
   • ✅ Panel user created (check in Xtream UI admin)
   • ✅ Email sent to customer with credentials

Step 6: Configure Automation Settings

Fine-tune how IPTVbp manages subscriptions:

Renewal Behavior

• Auto-Renew: Extend subscription in Xtream UI automatically
• Grace Period: 3 days after payment fails (customizable)
• Suspension: Disable account in panel after grace period

Credential Format

• Username: customer-{id} or custom format
• Password: Auto-generated secure password
• Display Format: How credentials appear in emails

Package Changes

• Upgrades: Immediately change package in Xtream UI
• Downgrades: Apply at next billing cycle or immediately
• Credits: Prorate remaining time

Advanced Configuration

Multiple Panels

You can add multiple Xtream UI panels:

1. Repeat steps 1-2 for each panel
2. Give each panel a unique display name
3. Create products specific to each panel
4. Use panel selection in product configuration

Load Balancing

Distribute customers across multiple panels:

• Mark panels as "Active" for new subscriptions
• System automatically rotates between active panels
• Monitor panel capacity in dashboard
• Disable panels that are at capacity

Reseller Accounts

Create reseller subscriptions in Xtream UI:

1. Create a separate package in Xtream UI for resellers
2. Mark package as "Is Reseller" in IPTVbp
3. Create reseller products with higher pricing
4. System creates reseller account with credits

Troubleshooting Common Issues

Connection Timeout

Problem: Panel connection times out

Solutions:

• Check if panel is accessible from external IP
• Verify firewall allows incoming connections on panel port
• Try using IP address instead of domain name
• Check panel server is running (systemctl status xtream)

Authentication Failed

Problem: API authentication fails

Solutions:

• Verify username and password are correct
• Check if API access is enabled in Xtream UI
• Try logging into Xtream UI panel directly
• Reset admin password if needed

Subscriptions Not Creating

Problem: Orders complete but no subscription in Xtream UI

Solutions:

• Check panel connection status (green = ok, red = issue)
• Review error logs in Logs section
• Verify package mapping is correct
• Check panel has available credits/capacity
• Test panel API manually using API documentation

Wrong Package Assigned

Problem: Customer gets wrong package in Xtream UI

Solutions:

• Verify product → package mapping
• Check package ID in Xtream UI matches configuration
• Update package mapping if Xtream UI changed
• Refresh packages from panel

Best Practices

Security

• Use HTTPS for panel URL when possible
• Use strong admin passwords
• Limit API access to IPTVbp server IP
• Regularly update Xtream UI software
• Monitor access logs for suspicious activity

Performance

• Keep Xtream UI database optimized
• Monitor panel server resources (CPU, RAM)
• Use multiple panels for large customer bases (1000+ users)
• Enable caching in Xtream UI
• Regular database backups

Reliability

• Set up monitoring for panel uptime
• Configure webhook notifications for issues
• Have backup panel ready
• Test provisioning regularly
• Keep emergency contact info for panel host

Next Steps

Now that your Xtream UI panel is integrated:

• Set up Payment Gateways
• Configure Email Templates
• Create Discount Codes
• Set up Discord Integration

Additional Resources

• Xtream UI API Reference
• Panel Troubleshooting Guide
• Migrating Between Panels