Ministra (Stalker) Panel Integration Guide

Ministra, formerly known as Stalker Portal, is one of the most established IPTV middleware platforms in the industry. Used by hundreds of IPTV providers worldwide, it is particularly popular for set-top box deployments where MAC address authentication is the standard. If your service runs on Ministra and you are still managing subscriptions manually, connecting it to IPTVbp gives you automated billing, instant provisioning, and a professional customer portal.

This guide covers everything from understanding how Ministra's API works to completing your first automated subscription test.

What Is Ministra (Stalker Portal)?

Ministra is IPTV middleware that acts as the management layer between your streaming content and the end-user devices (typically MAG set-top boxes, but also smart TVs and mobile apps). It provides:

User management: Create and manage subscriber accounts
MAC address authentication: Devices authenticate using their hardware MAC address rather than a username and password
Content organization: Manage channel packages, VOD content, and EPG data
Portal interface: The on-screen menu and navigation that customers see on their TV
Server management: Route streams through multiple servers for load balancing

Unlike Xtream Codes-based panels where username/password is the primary authentication method, Ministra relies heavily on MAC addresses. This has implications for how billing and provisioning work, and it is one of the reasons a Ministra-aware billing platform is essential.

Why You Need a Billing Platform for Ministra

Ministra handles content delivery and device management well, but it lacks built-in billing capabilities. Without a connected billing platform, you are stuck with a manual workflow:

Customer contacts you requesting service
You collect their MAC address via message or email
You manually add the MAC in Ministra's admin panel
You assign a tariff plan and set an expiry date
You collect payment through a separate channel
You remember to suspend or remove the MAC when the subscription expires

This workflow does not scale. At 50 customers it is manageable. At 500, it consumes your entire day. At 5,000, it is physically impossible without a team.

IPTVbp automates this entire cycle. Customer pays, MAC is activated on Ministra, subscription is tracked, renewal extends the account, expiry suspends it. Zero manual intervention.

Prerequisites

Before starting the integration, ensure you have:

Ministra admin access: Full administrator credentials for your Ministra portal
API access enabled: Ministra exposes a REST API that must be enabled and accessible
Server URL: The URL of your Ministra installation (e.g., http://your-server-ip or https://ministra.yourdomain.com)
API key or admin credentials: Depending on your Ministra version, authentication uses either an API key or admin username/password
IPTVbp vendor account: Sign up at iptvbp.com if you do not have one

Step 1: Enable and Configure the Ministra API

Ministra's API allows external systems to manage users, tariff plans, and subscriptions programmatically.

Accessing API Settings

Log into your Ministra admin panel
Navigate to Settings (or System Settings depending on your version)
Find the API or REST API section
Ensure the API is enabled
If your version uses API keys, generate a new key and store it securely
Note any IP restriction settings --- you may need to allow IPTVbp's server IP

API Authentication Methods

Ministra supports different authentication methods depending on the version:

Ministra 5.x and newer: Typically uses token-based authentication or API keys
Stalker Portal (older versions): Often uses the admin username and password for API calls
Custom builds: Some providers run modified Ministra installations with custom API setups

Identify which method your installation uses, as you will need to provide the correct credentials when configuring the connection in IPTVbp.

Verifying API Access

Before configuring IPTVbp, verify that your API is reachable. You can do this by making a simple API request from your browser or a tool like curl:

Try accessing your API endpoint (e.g., http://your-server-ip/stalker_portal/api/)
You should receive a response (even if it is an authentication error, it confirms the API is reachable)
If you get a connection timeout, check your firewall and server configuration

Step 2: Add the Ministra Panel in IPTVbp

With your API credentials ready, connect the panel in IPTVbp.

Log into your IPTVbp portal dashboard
Go to Panels in the sidebar
Click Add Panel
Select Ministra / Stalker as the panel type
Enter your connection details:

- Panel Name: A recognizable name (e.g., "Ministra Main Server") - Panel URL: Your Ministra server URL - API Key or Username/Password: Your authentication credentials

Click Test Connection

IPTVbp will verify the connection by querying your Ministra API. A successful test shows your server details, active user count, and available tariff plans.

Step 3: Sync Tariff Plans

Ministra uses tariff plans to define what content a subscriber can access and for how long. IPTVbp needs to know about these plans to assign the correct one when provisioning new subscriptions.

After a successful connection test, click Sync Packages
IPTVbp pulls all tariff plans from your Ministra installation
Review the synced plans to ensure they match what you expect
Each tariff plan becomes selectable when creating IPTVbp products

Tariff Plan Considerations

Duration mapping: Ministra tariff plans can have their own expiry logic. Make sure the duration you set in your IPTVbp product matches or complements the tariff plan duration
Package content: Verify that each tariff plan includes the correct channels, VOD content, and features
Multiple plans: If you offer different tiers (Basic, Standard, Premium), ensure each has a corresponding tariff plan on Ministra

Step 4: Create Products with MAC Address Support

Ministra subscriptions are typically MAC address-based, which requires a specific product configuration in IPTVbp.

Navigate to Products in your IPTVbp portal
Click Add Product
Configure the product:

- Product Name: Customer-facing name (e.g., "Full Package - 1 Month") - Price: Set in euros - Duration: Subscription length - Panel: Select your Ministra panel - Package: Select the corresponding tariff plan - Credential Type: Select MAC Address

Save the product

When credential type is set to MAC Address, your store checkout will prompt customers to enter their device's MAC address instead of choosing a username and password.

MAC Address Validation

IPTVbp validates MAC addresses at the point of entry to prevent common errors:

Format validation (must match the standard XX:XX:XX:XX:XX:XX pattern)
Duplicate detection (warns if the MAC is already registered on the panel)
Character validation (only valid hexadecimal characters accepted)

This catches mistakes before they reach your panel, saving you from troubleshooting support tickets caused by mistyped MAC addresses.

Step 5: Test the Complete Flow

Always test before going live.

Place a Test Order

Open your IPTVbp store
Select a Ministra product
Enter a test MAC address (use a real device MAC if possible for full end-to-end testing)
Complete the purchase

Verify on Ministra

Log into your Ministra admin panel and check:

The MAC address appears in the user list
The correct tariff plan is assigned
The expiry date matches the subscription duration
The account status is active

Test the Device

If you used a real device MAC:

Power on the device
It should connect to your Ministra portal automatically
Verify that channels load and the correct package is available
Check EPG data and VOD access if applicable

Managing MAC Addresses: Best Practices

MAC address management is central to Ministra operations. Here are best practices for keeping things running smoothly.

Customer Education

The most common support issue with MAC-based services is customers not knowing their device's MAC address. Provide clear instructions in your store:

MAG boxes: The MAC is printed on a sticker on the bottom of the device and also visible in the device's system information screen
Smart TVs: Found in network settings under "About" or "Network Information"
Formuler boxes: Available in system settings under "About" or "Device Information"
Android boxes: Settings, About Phone/Device, Status, Wi-Fi MAC address

Include these instructions directly on your product pages and in your knowledge base.

Handling Device Changes

Customers occasionally need to change the MAC address on their subscription (new device, replacement box, etc.). With IPTVbp, this can be handled through:

Customer self-service: Allow customers to update their MAC address through the customer portal (your choice whether to enable this)
Support request: Customer contacts support, and you update the MAC in IPTVbp which syncs to Ministra
Automatic re-provisioning: When the MAC changes, IPTVbp deactivates the old MAC on Ministra and activates the new one

MAC Address Security

MAC addresses can be spoofed, which is a concern for IPTV providers. Consider these security measures:

Monitor for MAC addresses that connect from multiple IPs simultaneously (potential sharing)
Set connection limits per MAC on your Ministra server
Periodically audit active MACs against your subscriber list

Troubleshooting Ministra Connection Issues

API Not Reachable

Verify the server URL and port are correct
Check firewall rules on the Ministra server
Ensure the API service is running (restart Ministra services if needed)
Test API access from another external location to rule out network-specific issues

Authentication Errors

Confirm you are using the correct authentication method (API key vs. username/password)
Regenerate the API key if you suspect it was changed or expired
Check for special characters in passwords that might need URL encoding

MAC Not Being Activated

Verify the MAC address format is correct (some panels expect uppercase, others lowercase)
Check if the MAC already exists on the panel (duplicate MACs cause conflicts)
Ensure the tariff plan mapped in IPTVbp still exists and is active on Ministra
Check Ministra logs for specific error messages

Tariff Plan Mismatch

Re-sync packages in IPTVbp after making changes to tariff plans on Ministra
Verify the tariff plan ID has not changed (some Ministra updates can reassign IDs)
Check that the tariff plan is not disabled or archived on Ministra

What Changes After Integration

Once your Ministra panel is connected to IPTVbp, your workflow transforms:

Before: Customer messages you, you collect MAC, log into Ministra, create account, assign plan, collect payment separately, track expiry manually
After: Customer visits your store, enters their MAC, pays online, and their device is activated within seconds. Renewals and expiries are handled automatically.

The connection between IPTVbp and Ministra handles the complete subscription lifecycle. You focus on growing your business instead of managing it.

Explore more guides to grow your IPTV business:

Get Started

Connecting your Ministra panel to IPTVbp takes under 10 minutes. Sign up for your free account, add your panel, and run your first automated test today. If you are already using IPTVbp with Xtream Codes panels, adding Ministra as an additional panel works the same way --- manage all your panels from one unified dashboard.

Ministra (Stalker) Panel Integration Guide: Connect in Under 10 Minutes