NXT Panel Integration Guide

NXT Panel Integration Guide

NXT Dashboard is a modern IPTV management panel with a clean API and native multi-device support. This guide covers connecting NXT to IPTVbp for fully automated provisioning.

Prerequisites

• NXT Dashboard installed and accessible over HTTPS.
• Admin access to generate an API token.
• At least one package/plan created in NXT.

Step 1: Generate an API Token

1. Log into NXT Dashboard as an administrator.
2. Go to Settings > API Access.
3. Click Generate New Token.
4. Name it "IPTVbp Integration".
5. Grant these permissions:
   • Create Users
   • Manage Subscriptions
   • View Packages
   • Extend/Modify Accounts
6. Click Create. Copy the token immediately -- it is shown only once.

Step 2: Add the Panel in IPTVbp

1. Go to Services > IPTV Panels > Add New Panel.
2. Select NXT Dashboard as the panel type.
3. Enter:

Field	Value
Display Name	NXT Main Panel
Panel URL	https://nxt.example.com
API Token	Paste the token from Step 1

1. Click Test Connection. You should see the panel version, status, and available packages.
2. Click Save.

Step 3: Configure Packages

Click Configure Packages on the panel card. For each NXT package:

• Package Type: Regular, Trial, or Reseller.
• Max Devices: Number of devices the customer can register (NXT manages devices natively).
• Features: Tag which features are included (Live TV, VOD, Series, Catch-Up).

Step 4: Create Products

Create products the same way as any other panel -- select the NXT panel and package during product creation. NXT-specific fields:

• Device Limit: Overrides the package default if needed.
• MAC Binding: Enable if you sell to STB/MAG device users. Customers will enter their MAC address at checkout.

NXT Provisioning Flow

1. Customer pays.
2. IPTVbp calls the NXT API POST /api/lines with the package ID, username, password, and device limit.
3. NXT creates the line and returns a confirmation with the line ID.
4. IPTVbp stores the external line ID for future renewals and modifications.
5. The customer receives an email with their credentials plus the NXT portal URL.

For renewals, IPTVbp calls PUT /api/lines/{id}/extend with the new expiry date.

Multi-Device Support

NXT tracks devices per account. When a customer connects a new device (phone, TV, STB), NXT registers it automatically up to the device limit. Customers can manage their devices from the NXT customer portal or from the IPTVbp customer dashboard.

If a customer exceeds their device limit they will see an error on the new device. They can remove an old device to free a slot or upgrade to a plan with more devices.

MAC Address Binding

For STB customers (MAG, Formuler, etc.) who connect via MAC address:

1. Enable Collect MAC Address on the product.
2. During checkout the customer enters their MAC address (format: 00:1A:79:xx:xx:xx).
3. IPTVbp passes the MAC to NXT during provisioning.
4. The STB device is automatically authorised in NXT.

Differences from Xtream UI

Feature	Xtream UI	NXT Dashboard
Authentication	Username/password	API token
Device management	Connection count only	Per-device tracking
MAC binding	Manual	Native
API style	Custom REST	RESTful JSON
Reseller system	Credit-based	Plan-based

Troubleshooting

API token rejected:

• Regenerate the token in NXT and update it in IPTVbp.
• Verify the token has the required permissions.
• Check the token has not expired (some NXT configurations set token TTLs).

Line creation fails:

• Ensure the package exists and is active in NXT.
• Check NXT server logs for detailed error messages.
• Verify the NXT server has sufficient disk space and memory.
• If using MAC binding, confirm the MAC format is valid.

Devices not registering:

• The device limit on the product may be set to zero. Check product configuration.
• NXT may have a global device cap. Check NXT admin settings.
• Ask the customer to restart their app/device after provisioning.