Storefront

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.

6 min read
Published November 2, 2026
Last checked November 18, 2026
mac-address
mag
checkout
products
provisioning

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

  1. Your store asks your panel to create a MAG line for that MAC address.
  2. 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.
  3. 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.
  4. 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.

Start free trial