How to connect a Cryonix panel and automate your billing
Connect your Cryonix panel (Cryonix Paid) with its API URL and a Reseller API Key, so paid orders create, renew and change lines on their own.
Once your Cryonix panel is connected, a paid order creates the customer's line on it, a renewal extends that same line, and a plan change moves it to the new package. Your store talks to Cryonix's Reseller API, so there is no browser login and no captcha.
Before you start: the Reseller API is part of Cryonix Paid (version 1.1.18 or newer). On your panel, open API in the menu and create a key on the Keys tab with the
readandlinesscopes. The key starts withcxk_and is shown only once, so copy it straight away. Copy the API address from the same tab too, and have the address your customers' apps connect to (your own DNS, or the panel's client address).
1Step 1 of 5Open the panel picker
Go to Panels → All panels and click Add panel. The page scrolls down to Add New Panel. Type "cryonix" in the search box and click the Cryonix tile. A window opens with the connection form. If your plan's panel limit is reached, you're asked to upgrade first.
2Step 2 of 5Fill in the form
- Display Name: any name you'll recognise.
- Stream URL: your own DNS, or the panel's client address. Customers' playlist, portal and EPG links are built from it.
- API URL: the API address from the Keys tab, for example
https://panel.example.com/YOUR_ACCESS_CODE/api/v1. It is one field with your panel's access code in it. It must start withhttps://and end with/api/v1. Never put your key in it. - Reseller API Key: the
cxk_…key with thereadandlinesscopes.
3Step 3 of 5Add the panel
Click Add Panel. Your store checks the key with the panel and reads your credit balance. If it fails, you see Panel not saved with what went wrong, and nothing is saved.
If your key has an IP allow list, open the panel's settings and press Show the address to allow, add that address to the key's allowed addresses on the Keys tab, then try again.
4Step 4 of 5Check the connection and packages
On the panel's page, Connection Status should show Connected. Click Test Connection at any time. Your credit balance shows on the panel's card under Panels → All panels. After you change packages on the panel, open the ⋯ menu on the card and click Re-sync packages.
5Step 5 of 5Create a product
The panel's page shows Create a product. Click it to open Quick setup from panel and click Fetch packages. Each Cryonix package comes with its length, connections and your price in credits. A package that offers a trial also appears as its own trial row: pick that row for a free trial product, and the package itself for paid products.
For MAG or Enigma boxes, tick MAC Address (MAG) under Allowed Authentication Types, and use a package that allows that line type on the panel.
What works with Cryonix
- New lines: M3U, MAG and Enigma lines and trials are created after payment. If your Cryonix account may choose usernames, your store sends the customer's; otherwise Cryonix makes the login and your store delivers it.
- Charged once: every order and every renewal payment carries its own key, and each new line is also marked with its order in the panel's notes. A retried order finds its line instead of making a second one, and a retried renewal is not charged twice.
- Renewals: a paid renewal extends the line by the package the customer pays for. A trial line that is renewed becomes a paid line. No package means no renewal: the order waits for you instead.
- Plan changes: when a customer's plan change is applied, the line is renewed on the new plan's package. Cryonix adds that package's period and charges its price, as for a renewal.
- Safe stops: if a renewal gets no clear answer, or the line already runs past the paid period, nothing is sent again and the order goes to Subscriptions → Delivery → Needs manual set-up for you to check.
- Credits: a paid order waits when your balance runs out, instead of failing.
- Customers: when you allow it on the product, customers can change their line's password with Change Password in their account.
- Line end: your store doesn't switch lines off or remove them. A line that isn't renewed runs out on the panel at its end date. When you delete a customer in your store, their Cryonix line keeps working until it runs out. Remove it in Cryonix yourself if needed.
Common problems
This Cryonix panel needs the Paid edition. The panel runs the Free edition. Ask the panel owner to upgrade to Cryonix Paid.
Cryonix rejected the API key. Create a new key on the Keys tab. Your panel login password is not a key. A revoked key ends here too.
The key lacks a scope. Create a key with the read and lines scopes.
The certificate is not trusted. Cryonix keys only work on a panel with a trusted HTTPS certificate. Put a certificate on the panel's address (for example a free Let's Encrypt certificate, or Cloudflare in front of the panel), then test again.
Our address is not allowed. The key has an IP allow list. Press Show the address to allow in the panel's settings and add it to the key.
More messages are in Fix a panel that won't connect.
Frequently asked questions
Where do I find the API URL?
On your Cryonix panel, open API in the menu and look at the Keys tab. Copy the API address shown there: it already holds your access code and ends with /api/v1.
Which scopes does the key need?
read and lines for orders and renewals. Your store never deletes lines, so it doesn't need the delete scope.
Can customers choose their own username?
Only if your Cryonix account may choose usernames. Otherwise Cryonix makes the login, the checkout stops asking for one, and the customer receives the login Cryonix made.
Does a retried payment charge my panel twice?
No. Each order and each renewal payment carries its own key, so a retry gets the first answer back instead of a second charge. A renewal with an unclear answer is never sent again by itself.
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.