How to sell MAC address IPTV lines for MAG boxes automatically
Let customers order with their device's MAC address instead of a username. How to switch it on per product, what checkout asks, and which panels support it.
Some customers don't use an app with a username and password. They use a set-top box, such as a MAG box, or an STB emulator app, which signs in with the device's MAC address instead. Your store can sell these lines automatically: the customer enters their MAC address at checkout, and your panel creates a line for that device.
This guide shows how to switch MAC address ordering on or off per product, what the customer sees, and which panel types can create MAG lines through your store.
What a MAC address line is
A MAC address is a fixed ID of a network device, written as six pairs of letters and digits, for example 00:1A:79:12:34:56. Many MAG boxes start with 00:1A:79. On a MAC address line, the panel knows the device by that ID, so the customer doesn't type a username or password on the box. They only enter your portal address once.
1Step 1 of 4Choose which login types a product offers
Go to Products → All products. On the product card, open the menu (⋮) and click Edit details. Under Allowed Authentication Types:
- Username & Password (M3U): for apps that sign in with a login.
- MAC Address (MAG): for MAG boxes and STB emulator apps.
Both are ticked by default. At least one must stay ticked. Click Update Product to save.
Untick MAC Address (MAG) on products whose panel can't create MAG lines (see the table below), so customers never order something the panel will refuse. Untick Username & Password (M3U) on a product that is only for MAG boxes.
2Step 2 of 4Watch for MAG-only packages
Some panels say which packages only work for MAG boxes. In Quick setup from panel and in the product editor, those packages carry a MAC only badge, with this warning: This package only works for MAG boxes (MAC address). Customers ordering a normal line will be refused by the panel. Pick another package, or make the product MAG-only as in step 1.
3Step 3 of 4What the customer sees at checkout
When a product allows both types, the product page offers two choices: Username & Password or MAC Address (for MAG boxes and STB emulator apps). When the customer picks the MAC option, a MAC Address field appears.
- The field formats the address as they type: only letters A to F and digits are kept, in pairs, in capitals.
- The order can't go on until all 12 characters are entered.
- A hint reminds them to find the MAC address in their device's settings.
4Step 4 of 4What happens after payment
- Your store asks your panel to create a MAG line for that MAC address.
- The customer gets their confirmation email. Your login email template can show the MAC address with the
{{mac_address}}placeholder; see How to change the login email. - In their customer area, the customer sees their MAC Address and the MAC Portal URL to enter on their box. The portal address is built from your panel's stream URL.
- When they renew, the same line is extended. The MAC address stays the same, and the renewal page shows it.
If the panel refuses the MAC address (for example, because it's already used on the panel), the order is listed under Subscriptions → Delivery → Failed delivery with the panel's reason.
Which panel types create MAG lines through your store
| Panel type | MAG lines through your store |
|---|---|
| NXT | Yes |
| XUI (XUI.ONE) | Yes |
| Activation Panel, TV Plus Panel, Strong 8K | Yes |
| Ultra 8K | Yes |
| TiviOne | Yes, after checking the MAC isn't already on your panel |
| TV Pro (NETTV), Dream 4K | Yes |
| MegaOTT | Yes, with the line's own portal address |
| Cryonix | Yes, MAG and Enigma lines, on packages that allow them |
| Xtream UI, RedTeam | No: make MAG lines on the panel itself |
| Xtream Masters, Argon, GoldenOTT, V12 / MaxOTT | No: username-and-password lines only |
| BestPanel / Prismaro | No: MAG lines are made on the panel itself |
| OneStream | Not confirmed yet: sell username-and-password lines |
For a panel marked "No", untick MAC Address (MAG) on its products. Each panel's own guide has the details, for example Ultra 8K or TiviOne.
Changing a customer's MAC address
When a customer replaces their box, change the MAC address on your panel itself. Your store doesn't change MAC addresses on the panel, and the line actions in your portal don't cover MAG lines. Customers can't change it themselves from their customer area either, so they'll ask you.
Frequently asked questions
What is a MAG box?
A MAG box is a set-top box that connects to a portal with its MAC address instead of a username and password. STB emulator apps on phones and TVs work the same way, with a MAC address the app shows.
Where does a customer find their MAC address?
In the device's settings, usually under system or network information, or on a sticker on the box. In an STB emulator app, look in the app's own settings.
Can one product offer both login types?
Yes. With both Username & Password (M3U) and MAC Address (MAG) ticked, the customer picks at checkout. Your panel then creates the matching kind of line.
Can a customer change their MAC address themselves?
No. Change it on your panel when they ask. Your store keeps renewing the same line.
Why was a MAC order refused?
Usually the panel can't create MAG lines (see the table above), the package is for normal lines only, or the MAC address is already used on the panel. The panel's reason is shown under Subscriptions → Delivery → Failed delivery.
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 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 change the login email your customers get
Customers get their username, password and setup steps by email right after they buy. Here's how to write that email your way.
What happens automatically after a customer pays (and how to check delivery)
How a paid order becomes a working line or account, how renewals and end dates are handled, and where to fix an order that did not go through.