XUI.ONE setup for automatic billing (API URL, access code and API key)
Set up your XUI.ONE reseller panel for automatic billing. What the API URL with access code looks like, where the API key goes, and API versus browser login.
XUI.ONE is a reseller panel that can be reached two ways: through its Admin API (an address that contains your access code, plus your reseller API key), or through its normal login page with your reseller username and password. Your store can use either one, or both with the API first. Once it's connected, a paid order creates the customer's line on XUI.ONE and a renewal extends that same line.
This guide is about connecting an existing XUI.ONE panel to your store for billing. Installing or running the panel itself is done by your panel provider.
Before you start: Collect these from your XUI.ONE panel, or ask your panel provider:
- the panel's domain and API port (usually 8000 for http or 9000 for https);
- the access code that opens the Reseller API;
- your reseller API key, found in your XUI reseller panel under its API settings;
- for the browser login: the page where you sign in, plus your reseller username and password;
- the address your customers' apps connect to (your stream URL).
1Step 1 of 7Choose how your store connects
| Method | What you enter | Use it when |
|---|---|---|
| API Authentication only | API URL + Reseller API Key | You have an access code and API key. Fastest and most reliable. |
| Browser Automation only | Panel URL + Username + Password | Your provider gives you no API access. |
| Both | All of the above + Browser Login URL | You have API access and want your login saved with it. |
With both ticked, orders go through the API. If the API doesn't answer an order, your store doesn't switch to the login page and try again, so a line is never made twice.
2Step 2 of 7Build your API URL
The API URL is not the page you log in at. It is your domain, the API port and your access code, ending with a slash:
https://panel.example.com:9000/ACCESSCODE/
Use http:// with port 8000 or https:// with port 9000, whichever your panel runs. Don't add anything after the access code: your store adds the API parameters by itself.
3Step 3 of 7Open the XUI form
Go to Panels → All panels and click Add panel. Under Add New Panel, type "xui" in the search box and click the XUI tile. A window opens with the connection form. If your plan's panel limit is reached, you're asked to upgrade first.
Not sure you have XUI.ONE and not Xtream UI? Click Detect my panel, paste your login address and click Detect panel, then Use this next to the best guess. XUI.ONE vs Xtream UI explains the difference.
4Step 4 of 7Fill in the form
- Display Name: any name you'll recognise.
- Stream URL: the address your customers' apps connect to, for example
http://line.example.com:8080. Customers' playlist, portal and EPG links are built from it. - Under Authentication Methods, tick API Authentication, Browser Automation or both (step 1).
For the API, enter the API URL from step 2 and paste your Reseller API Key.
For the browser login, enter the Panel URL (or, with both methods ticked, the Browser Login URL), then your reseller Username and Password.
If the login page shows a captcha, a CAPTCHA solving (2Captcha key — optional) field appears when Browser Automation is ticked. With your own key, solving is free to you; leave it blank and each solve is paid from your platform credit. You can also save your key once under Panels → Captcha for panel login.
If a browser pop-up asks for a username and password before the panel even loads, tick This panel is behind an nginx / login gate and enter that gate's username and password.
5Step 5 of 7Add and test the panel
Click Add Panel. The connection is tested before anything is saved. With the API, your store reads your reseller account and credit balance; with the browser login, it signs in and reads your credits.
If it fails, you see Panel not saved with what went wrong and nothing is saved. The common XUI.ONE causes:
- The API URL returned a web page: you entered the login address as the API URL. Use the address with the port and access code from step 2.
- The request was refused: the API key is wrong, or API access isn't enabled for your reseller account. Copy the key again, or ask your provider to enable it.
- The panel is blocking our servers: the panel's firewall or allowlist needs our server addresses. Message us under Help → Contact platform support and we'll give you the addresses to allow.
Each message and its fix is in Fix a panel that won't connect.
6Step 6 of 7Check the connection and packages
On the panel's page, Connection Status should show Connected. Click Test Connection at any time. The Packages card shows how many packages your store read. When you add or change packages on XUI.ONE, open the ⋯ menu on the panel's card under Panels → All panels and click Re-sync packages.
7Step 7 of 7Create your products
The panel's page shows Create a product. Click it to open Quick setup from panel, then click Fetch packages. Under Your combined product, tick each Duration tier you sell, enter its Base price and click Create product. Paid orders now create lines on XUI.ONE and the customer gets their login by email.
To sell lines for MAG boxes, keep MAC Address (MAG) ticked under Allowed Authentication Types on the product. XUI.ONE creates a MAG line from the customer's MAC address. See Selling MAC address lines.
Frequently asked questions
Where do I find my XUI.ONE access code?
The access code is created on the XUI.ONE panel for the Reseller API. If you're a reseller and not the panel owner, ask your panel provider for it, together with the API port. It is part of the API URL, not a separate field.
Can I connect XUI.ONE without the API?
Yes. Untick API Authentication and tick Browser Automation, then enter your login page address, username and password. Your store signs in the way you do. The API is faster and more reliable, so use it when your provider offers it.
Why does the API URL work in my browser but not in the form?
Your browser shows the login page, which is not the API. The form needs the API address: domain, API port and access code, for example https://panel.example.com:9000/ACCESSCODE/.
Do renewals create a new line on XUI.ONE?
No. A renewal extends the customer's existing line, so their username and password stay the same. With the API, your store then reads the new end date back from the panel.
Does my store track my XUI.ONE credits?
Yes. The credit balance is read from your reseller account and shown on the panel's card, with a warning when it runs low. The Panel Credit Tracking module adds what each sale costs you.
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 connect an Xtream UI or XUI panel
Connect your Xtream UI or XUI (XUI.ONE) reseller panel so paid orders create and renew lines on it by themselves. Which type to pick and what to enter.
XUI.ONE vs Xtream UI: which panel type to choose for automatic billing
XUI.ONE and Xtream UI look alike but connect differently. How to tell which one you have, what each needs, and what your store can do with each.
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.