Media Servers

Jellyfin billing: connect your Jellyfin server and sell access

Make an API key on your Jellyfin server, add it to your portal and sell plans. Customer accounts are created and disabled for you.

3 min read
Published November 10, 2026
Last checked November 10, 2026
jellyfin
media-server
integration
billing

Jellyfin servers connect with an API key. Once connected, a customer who pays gets their own account on your Jellyfin server with the limits of their plan, and their login by email. When they stop paying, the account is disabled. You don't run any script of your own.

1Step 1 of 3Make an API key on your Jellyfin server

Sign in to your Jellyfin dashboard as an administrator. Go to Dashboard → API Keys, click + Add and name the key, for example Billing Platform.

Copy the key. These menus are part of Jellyfin, not of your portal.

2Step 2 of 3Add the server

Go to Panels → Media servers → All media servers. Under Add New Service, click the Jellyfin card and fill in:

  • Display Name: a name for the server. The first product you sell from it is named after it; you can rename the product later.
  • Server URL: the address of your Jellyfin server, usually on port 8096.
  • API Key: the key from step 1.

Click Add Server. Your server's page opens.

Do you run Silo? It works with Jellyfin apps but has its own card: click Silo under Add New Service, not Jellyfin.

3Step 3 of 3Create and sell plans

Open the Plans tab, click Create plan, set the streams and prices and click Save Template. Then click Sell as product on the plan and Create product. The full walkthrough is in the guide on media server plans, linked below.

What happens automatically

  • Purchase: the customer picks a username on your product page and can choose their own password there; if they leave it blank, we make one. (To always make the password yourself, untick Customers choose their own password at checkout in the Customer login card on the product's edit page.) We create their account on your server, apply the plan's limits and email them their login and your server's address.
  • Libraries: a new account gets the libraries ticked on its plan. With nothing ticked, the plan gets every library on your server. If the plan has Optional libraries, a customer who leaves one out gets the plan's libraries without it. Existing customer accounts keep the libraries they already have: changing the ticks later only affects accounts created after the change.
  • Streams: the plan's stream limit is saved on the customer's Jellyfin account as that user's limit on simultaneous sessions, so your server itself enforces it.
  • Plan changed later: on the Plans tab, click Re-sync limits to apply the new limits to customers with an active subscription. Accounts you made yourself are not touched.
  • Renewal: the account stays on. If it had been switched off, renewing switches it on again.
  • Not paid: after your store's grace period (normally 7 days after the end date), the account is disabled, not deleted.
  • Cancelled: the customer keeps access until the end date, then the account is disabled.
  • Free trial ended: the trial account is removed straight away. Trials get no grace period.

Good to know

  • How your store signs in: the API key is sent to your server in a request header, never in the address. Newer and older Jellyfin versions read different headers; your store sends both, so there is nothing to choose.
  • Emby is a separate service. It has its own card and its own guide: Emby billing.

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