How to connect a OneStream panel and automate your billing
Connect your OneStream (1 Stream) reseller panel with its two API tokens and the right permissions, so paid orders create and renew lines by themselves.
Once your OneStream panel (also written 1 Stream) is connected, a paid order creates the customer's line on it and a renewal extends that same line. Your store reads your packages and credit balance straight from the panel.
OneStream's reseller API needs two tokens, and both must allow the same actions:
- an API Access Token, made by the panel admin, which goes in API Key (X-Api-Key);
- your personal user token, which goes in Bearer Token (X-Auth-User).
Before you start: Have the panel address, both tokens and the address your customers' apps connect to (your stream URL). If you're a reseller and not the panel admin, ask the admin for the API Access Token.
1Step 1 of 6Create the two tokens on OneStream
- As the panel admin, create an API Access Token. It has a name, an expiry, a status, a scope and an optional IP whitelist. Open the token's Key (Credentials) button to see its value.
- As the user (your reseller or admin account), open Profile → Edit and allow the app, which generates your personal user token.
- Both the token and the user need these permissions:
showUserProfile,indexPackages,createLinesWithPackage,destroyLines,statusLineToggleandindexLines.
If you set an IP whitelist on the API Access Token, it must include our server addresses, or every request is refused. The form in step 3 also shows these steps under How to generate your 1 Stream API tokens.
2Step 2 of 6Open the panel picker
Go to Panels → All panels and click Add panel. The page scrolls down to Add New Panel. Type "onestream" or "1 stream" in the search box and click the OneStream 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.
3Step 3 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 panel's main address, for example
https://panel.example.com. Don't add/extor any API path: your store adds it. - API Key (X-Api-Key): the API Access Token.
- Bearer Token (X-Auth-User): your personal user token.
4Step 4 of 6Add the panel
Click Add Panel. Your store reads your profile and credit balance with both tokens before anything is saved. If it fails, you see Panel not saved. OneStream gives one general message when the profile can't be read, so check the address, both tokens, their permissions and the IP whitelist.
5Step 5 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 and kept up to date. After you change packages on OneStream, open the ⋯ menu on the panel's card under Panels → All panels and click Re-sync packages.
6Step 6 of 6Create a product
The panel's page shows Create a product. Click it to open Quick setup from panel and click Fetch packages. Packages come with their length, connections and credit cost.
- Under Your combined product, tick each Duration tier you sell and enter its Base price.
- Packages that cost 0 credits are trials and appear under Free trials. Tick one to offer a trial.
- Click Create product.
Sell username-and-password lines on OneStream. MAG lines through your store aren't confirmed for OneStream yet, so untick MAC Address (MAG) under Allowed Authentication Types on your OneStream products. A package the panel marks as MAG-only gets a MAC only badge, with a warning that normal orders would be refused.
To cap trials, open the panel's page, click Edit, and under Trial quota (optional) set Max trials per Period (hours). Click Save Changes.
What works with OneStream
- New lines and renewals: created and extended automatically after payment. A renewal extends the same line with the package the customer bought, and the credits it cost are recorded.
- Logins: your store sends the customer's username and password when the order has them; otherwise the panel makes them.
- Content: what each package includes. OneStream has no bouquet list to pick from per product.
- Credits: your balance is read from the panel and kept up to date, with a warning when it runs low.
- Free trials: your 0-credit packages.
- Line end: your store doesn't switch OneStream lines off. A line that isn't renewed runs out on the panel at its end date.
Common problems
"OneStream connection failed." The profile couldn't be read. Check, in this order: the Panel URL (no /ext), the two tokens in the right fields, the six permissions on both the token and the user, and the token's IP whitelist.
"OneStream API error" with a status code. The profile was read but the next request was refused. Usually a permission is missing on the token or the user.
Orders fail for one package only. The package may be MAG-only. Look for the MAC only badge and pick another package.
More messages are in Fix a panel that won't connect.
Frequently asked questions
Why does OneStream need two tokens?
OneStream checks both the app and the user on every request. The API Access Token identifies the app, and your personal user token identifies you. Together they give your store the reseller access it needs, so keep both secret.
Which permissions does OneStream need?
showUserProfile, indexPackages, createLinesWithPackage, destroyLines, statusLineToggle and indexLines, on both the API Access Token and the user.
Can I use an IP whitelist on the token?
Yes, and it's a good idea, together with an expiry date. Add our server addresses to the whitelist, or the panel refuses your store's requests. Ask under Help → Contact platform support if you don't have them.
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, OneStream makes them. The customer gets the login by email.
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.