Xtream UI Integration Guide

Xtream UI Integration Guide

Xtream UI (also known as XUI) is one of the most widely used IPTV panel systems. This guide covers connecting it to IPTVbp so that customer accounts are created and managed automatically.

Prerequisites

Before you begin, ensure you have:

• An Xtream UI panel that is installed, running, and accessible from the internet.
• Admin credentials for the panel.
• The panel URL including the port (e.g. http://203.0.113.10:25500).
• At least one bouquet/package configured in Xtream UI.

Step 1: Enable API Access

1. Log into your Xtream UI admin panel.
2. Navigate to Settings > General Settings.
3. Ensure API is enabled.
4. Note down your admin username and password -- these are used for API authentication.

Step 2: Add the Panel in IPTVbp

1. In the vendor dashboard go to Services > IPTV Panels.
2. Click Add New Panel.
3. Fill in the form:

Field	Value
Panel Type	Xtream UI
Display Name	My Xtream Panel (your choice)
Panel URL	http://203.0.113.10:25500
API Username	Your Xtream admin username
API Password	Your Xtream admin password

1. Click Test Connection.

A successful test shows:

• Connection OK
• Authentication OK
• Packages found: N

If the test fails, see the Troubleshooting section below.

1. Click Save.

Step 3: Map Packages

After adding the panel, click Configure Packages. IPTVbp retrieves all bouquets/packages from your Xtream panel. For each package you plan to sell:

• Verify the Package Name and Package ID match what you see in Xtream UI.
• Set Max Connections (the number of simultaneous streams).
• Toggle Is Reseller if this package creates reseller accounts.
• Add a description for internal reference.

Click Save when done.

Step 4: Create Products

Go to Products > Create New:

1. Enter a product name (e.g. "Premium IPTV -- 1 Month").
2. Set the price and billing cycle.
3. Under Panel Configuration, select your Xtream UI panel and the desired package.
4. Set the connection count.
5. Optionally enable a trial period.
6. Save and publish.

How Provisioning Works

When a customer completes a purchase:

1. IPTVbp receives the payment confirmation (via webhook or redirect).
2. The provisioning engine calls the Xtream UI API to create a new user line.
3. The line is assigned to the selected bouquet with the configured connection limit and expiry.
4. IPTVbp stores the generated username and password.
5. A credentials email is sent to the customer with their username, password, server URL, and port.

For renewals the same process extends the existing line rather than creating a new one.

Credential Format

By default IPTVbp generates credentials in this format:

• Username: First part of the customer's email plus a random suffix (e.g. john_a8k2).
• Password: A random 10-character alphanumeric string.

You can customise the format in Settings > Provisioning.

Advanced: Multiple Panels

You can connect as many Xtream UI panels as you need. Common reasons:

• Geographic load balancing -- route European customers to a panel in Amsterdam and US customers to one in New York.
• Capacity management -- when one panel reaches its user limit, new orders go to the next panel.
• Content segregation -- different panels for different channel packages.

To enable automatic distribution, mark multiple panels as Active for new subscriptions and IPTVbp will round-robin between them.

Advanced: Reseller Accounts

To sell reseller packages:

1. Create a reseller bouquet in Xtream UI with the desired credit allocation.
2. In IPTVbp, map the package and toggle Is Reseller.
3. Create a product linked to that package.
4. When a customer purchases, IPTVbp creates a reseller account with the allocated credits.

Troubleshooting

Connection timeout:

• Verify the panel URL is correct, including http:// and the port.
• Try the IP address instead of a hostname.
• Check that the panel server firewall allows incoming connections on the panel port.
• SSH into the panel server and confirm the service is running: systemctl status xtreamcodes.

Authentication failed:

• Double-check the username and password.
• Try logging into the Xtream UI web interface directly with those credentials.
• Ensure API access is not restricted to specific IPs (or whitelist the IPTVbp server IP).

Packages not loading:

• Confirm at least one bouquet exists in Xtream UI.
• Click Refresh Packages in IPTVbp.
• Check the Xtream UI database is healthy (mysql -e "SELECT COUNT(*) FROM bouquets").

Lines not being created:

• Check the IPTVbp Logs section for provisioning errors.
• Verify the selected package ID still exists in Xtream UI (packages may get deleted or renumbered after a panel update).
• Ensure the panel has capacity (some hosting providers limit the number of lines).