How to connect an Xtream Masters panel and automate your billing
Connect your Xtream Masters reseller panel with its access-code API address and reseller API key, so paid orders create and renew lines by themselves.
Once your Xtream Masters panel is connected, a paid order creates the customer's line on it and a renewal extends that same line. Your store reads your packages, their trial settings and your credit balance through the panel's reseller API.
Xtream Masters connects with two things: the panel's reseller API address, which contains your access code, and your reseller API key. There is no browser login and no captcha.
Before you start: In your Xtream Masters reseller panel, open API Settings and copy your API key. Make sure Allow Reseller Use API is switched on for your account (ask your panel provider if you can't see it). You also need your reseller API address with the access code, and the address your customers' apps connect to (your stream URL).
1Step 1 of 6Open the panel picker
Go to Panels → All panels and click Add panel. The page scrolls down to Add New Panel. Type "masters" in the search box and click the Xtream Masters tile. A window opens with the connection form. If your plan's panel limit is reached, you're asked to upgrade first.
You can also click Detect my panel, paste your address, click Detect panel and then Use this next to the best guess.
2Step 2 of 6Fill in the form
- Display Name: any name you'll recognise.
- Stream URL: the address your customers' apps connect to. Customers' playlist, portal and EPG links are built from it.
- Panel URL: the full reseller API address, ending in your access code and
/reseller/index.php, for examplehttps://panel.example.com:8080/ACCESSCODE/reseller/index.php. It is used exactly as you enter it, so keep the scheme and port. - Reseller API Key: the key from API Settings.
If a browser pop-up asks for a username and password before your panel loads, tick This panel is behind an nginx / login gate and enter that gate's username and password.
3Step 3 of 6Add the panel
Click Add Panel. Your store reads your reseller account and credit balance. This check spends nothing. If it fails, you see Panel not saved with what went wrong, and nothing is saved.
4Step 4 of 6Check the connection and packages
On the panel's page, Connection Status should show Connected. Click Test Connection at any time. Your balance is read when the panels page opens. After you change packages on Xtream Masters, open the ⋯ menu on the panel's card under Panels → All panels and click Re-sync packages.
5Step 5 of 6Create a product
The panel's page shows Create a product. Click it to open Quick setup from panel and click Fetch packages. Paid packages come with their official length and credit cost; trial-capable packages come with their trial length and cost.
- Under Your combined product, tick each Duration tier you sell and enter its Base price. Each package carries its own bouquets.
- To offer a trial, tick a package under Free trials. The panel applies that package's own trial length and trial cost.
- Click Create product.
Xtream Masters lines are username-and-password lines. On your Xtream Masters products, untick MAC Address (MAG) under Allowed Authentication Types.
6Step 6 of 6Limit free trials (optional)
The panel can have its own trial limit. To cap trials in your store as well, open the panel's page, click Edit, and under Trial quota (optional) set Max trials per Period (hours). Click Save Changes.
What works with Xtream Masters
- New lines and renewals: created and extended automatically after payment. A renewal extends the same line with the package the customer bought.
- Logins: your store sends the customer's username and password when the order has them; otherwise the panel makes them.
- Content: the bouquets that come with each package.
- Credits: your balance is read from the panel and checked before each paid order. With too few credits, the order waits until you top up.
- Free trials: with the panel's own trial length and cost, without a credit check in your store.
- Line end: your store doesn't switch Xtream Masters lines off. A line that isn't renewed runs out on the panel at its end date.
Common problems
The panel returned a web page, not data. The Panel URL isn't the reseller API address. It must end in /<access code>/reseller/index.php. Check the API key too.
The API key lacks permission. Switch on Allow Reseller Use API on the panel, or ask your provider to.
"That username already exists on the panel." Another line uses that username. The order is listed under Subscriptions → Delivery → Failed delivery: change the username on the order and click Retry.
"The panel trial limit has been reached for this reseller." Your panel's own trial limit is used up. Wait, or ask your provider to raise it.
More messages are in Fix a panel that won't connect.
Frequently asked questions
Where do I find the Xtream Masters API address?
It is your panel's address plus your access code and /reseller/index.php. Your panel provider gives you the access code. The page where you log in is not the API address.
Why is my one-day product created as a trial?
On Xtream Masters, an order for a one-day product is sent with the panel's trial option, so the panel uses its trial length and trial cost. Sell trials through Free trials, and keep paid products longer than one day.
Can customers choose their own username?
Yes, where your product lets them. Your store sends the username and password from the order; if there are none, the panel makes them. Either way, the customer gets the login by email.
Can I sell to MAG boxes on Xtream Masters?
Not through your store. It creates username-and-password lines only on Xtream Masters. Untick MAC Address (MAG) on your Xtream Masters products.
Is Xtream Masters the same as Xtream UI?
No. Xtream Masters has its own reseller API with an access code and API key, and its own tile. For Xtream UI or XUI.ONE panels, see How to connect an Xtream UI or XUI panel.
Ready to try it yourself?
Spin up your own IPTVbp store and connect a panel. It's free until you have 25 paying customers, no card needed.
Related Articles
How to fix a panel that won't connect
Your panel won't save, or shows as failing? Find the message you see and the fix for it, from blocked servers and wrong addresses to logins and captchas.
How to create and edit products from your panel's packages
Add a product straight from your panel's packages, set your prices per length, add a free trial, then choose how the product shows on your store.
How to track your panel credits, costs and profit
Use the Credit Tracking module to see your credit balance, what each sale really costs you and which products earn the most.