How To Create A Package

What Are Packages?

Packages put together the digital content you want to sell on your Tebex Store. At their most basic level, they include a name, description, price & deliverables (the things customers get after their purchase).

🎓 Academy Guide - Package Creation Overview

We'll go into how to create a package below, but we also have this handy video guide on the subject too; feel free to give it a watch!

Creating A Package

1. Click Packages on the left-sidebar on the Tebex Control Panel.

2. Click Add New in the top-right, then click Package.

3. We'll start by filling out the basic details of our package:

• The Package Name - this is the name of the product which will appear on your Tebex Store.

• The Description - this is the description that should tell customers exactly what they are purchasing. We can't be unclear here, and if you're offering something like rank that has a list of benefits, all these benefits should all be listed individually here.

• The Category - this is the category that your newly created package will be placed in; by default it'll say 'Packages' as we create this first category for you, don't worry though, you can change the name of this later. If you've already created a category though, you can pick the relevant one.

• The Package Image - this is the image or icon shown to customers alongside the package name; whether or not this displays is based on your template and its settings. We recommend using clear PNG files with a maximum height of 165 pixels.

• The Price - this is the amount your customer will be charged to purchase the package you're creating.

1. That's the basic information out of the way, now it's time to get into the fun stuff; we've listed each of the sections below based on the order they appear on the package editor (from left to right), but all options might not appear on all store types.

Next up, you'll need to check and fill out each of the relevant sections to setup your package properly, here's a rundown of each section and the options we provide.

Pricing

Recurring Payment You can choose to charge the customer once, charge a recurring subscription or allow both options at the same time; if you choose the latter, note that you can't define separate prices for both options. Remove From Customer After / Charge Customer Every If you choose to charge the customer only once, you get to choose if the package is ever removed from the customer (this is when package removal commands are ran, we'll talk about these later). If you choose to charge through a recurring subscription or allow both recurring and one-off options, you get to choose how often the subscription renews / define when the package should be removed from the customer.

Limits

Global Limit You can choose to limit how many times the package can be purchased and, optionally, set the limits to reset after a specified period of time (for example, you could reset the limits every month), this means you can setup a package that can be purchased in limited amounts, like a package that can only be purchased 50 times a month for example. User Limit You can choose to limit how many times an individual customer can purchase the package, as above, you can set a time based period for the limit to reset, if you'd like to. Do Not Include Packages That Have Been Removed From Customers When Calculating Limits You can also choose whether or not to include packages that have already been removed from customers when calculating these limits.

Restrictions

Required Packages This allows you to set a specific package, or multiple packages, to be required for the customer to own before they're able to purchase the package you're creating. Only Require The Customer To Have Purchased One Package From The Selected List By default, we'll require the customer to have purchased all the packages you check in the dropdown menu before they're able to proceed with their purchase. If you only want the customer to require one of the packages you've selected, we offer this as an option. Do Not Allow The Customer To Increase The Quantity Of This Package When Purchasing You can also disallow the customer from modifying the quantity of this package here - this is useful if you're selling something like a rank, or something you only want customers to purchase one of.

Visibility

Publish On Store From & Remove From Store After This allows you to define dates for when the package should appear on your Tebex Store and when it should be disabled (not visible to customers). Do Not Show This Package To Customers Who Haven't Logged Into The Webstore You can stop the package from being shown to customers who haven't logged into your Tebex Store yet with this option. Do Not Display This Package On The Webstore And Disable It Entirely By enabling this, you can disable the package from showing to customers.

Gifting

Do Not Allow This Package To Be Purchased Using Gift Cards This option disallows gift cards from being used towards the value of this package. Do Not Allow This Package To be Gifted To Another Customer This option disallows the package from being gifted to another customer.

Variables

Variables allows you to ask customers for additional information relating to their purchase to allow the customisation of their package; for example you could ask for the colour of the item they're receiving.

Any variables you select within the dropdown menu will be requested from the customer when they add the package to their basket.

For more information on how variables work, please see our article here.

Goal

Here you can assign the package to a Community Goal, if you have one setup; this means any purchases of this package will count towards the selected goal. You can also do this from the Community Goals page itself, when you create or edit any goal.

To find out more about Community Goals, please see our article here.

Upselling

You can setup package-specific upselling rules, these allow you to upsell different packages depending on what the customer has in their basket, or prompt the customer to increase the quantity of the package they're purchasing.

To find out more about upselling, please see our article here.

Advanced

Package Slug We support the ability to provide a custom package slug, this means you can customise the end of your package URLs to provide greater readability and clarity for customers and search engines.

Configuring Deliverables

Deliverables are the actions that are run automatically upon the customer making their successful purchase. Every package you create must have some form of deliverable. Here we'll explain triggers, applicable to some deliverables, along with the types of deliverables we support:

Triggers

Game Server Commands & Discord Actions (explained below) can be set to run when certain events happen surrounding the customer's purchase or subscription on your Tebex Store; we call these triggers. Here are the triggers we offer:

• When the package is purchased - fires when the package is initially purchased by the customer.

• When the package is removed - fires when a customer's subscription to the package expires.

• When the package is refunded - fires when a Creator or Tebex refunds a payment for the package.

• When the package is chargebacked - fires when a customer files a chargeback against a payment for the package.

• When the subscription renews - fires when a customer's subscription renewal payment is successfully processed.

Game Server Commands

Tebex integrates with a wide range of supported games and one of the most popular way of giving in-game content to customers is with Game Server Commands. You can use software like the Tebex Plugin and the Tebex RCON Adapter to send commands to various game servers.

Not all games will have a Tebex Plugin built for them, but you can see any supported plugins for your store type here.

You'll find the Game Server Commands deliverable option at the bottom of the package creation page - here you can provide:

• Game Servers - the game servers your package commands will execute on; you can select add multiple game servers to your Tebex Store and select multiple for the commands to execute on, if you wish.

• Commands - the actual commands that will be executed on your game server.

When it comes to providing your commands to us, you'll likely find you need to use a command variable like the player's name or ID for example, you can find popular variables for your store type by clicking 'Variables' right there on the Control Panel, in the Game Server Commands section - right above where you're typing your commands. To see all the command variables we offer, click here.

FiveM Assets

You can sell FiveM Assets you've created and added to your CFX Account via the CFX Portal (previously KeyMaster).

To get started, choose the FiveM deliverable option at the bottom of the package creation page and click 'Link your CFX Account To Begin' and from there, follow the steps to sign-into your CFX Account. If you're already signed-in and a dropdown menu is displayed, skip to below.

When you're done, you'll be able to select the asset(s) you'd like to assign to the package from the 'FiveM Assets' dropdown menu - this will take the place of the sign-in button from the step above.

Discord Actions

Discord Actions, like giving a customer server roles or generating and sending a server invite to a customer, can be sold as well.

Adding Discord Actions to any package will cause Tebex to ask the customer to sign-in with Discord when they make their purchase.

To add Discord Actions to a package, choose 'Add Deliverable' and then click 'Discord Actions' from the bottom of the package editor. From there, you can choose to perform the following actions in line with a trigger:

• Assign a role to a customer on a Discord server.

• Remove a role from a customer on a Discord server.

• Send a message on a Discord server.

• Ban the customer on a Discord server.

• Unban the customer on a Discord server.

• Generate an invite link for a Discord server and send this to the customer's email.

License Keys

You can issue license keys for your digital content if you'd like.

To get started, click 'Add Deliverable' and after, click 'License Keys'. From there, you'll be given the option to upload a CSV of license keys directly or to view our license keys CSV template so you can get an idea of how your keys will need to be formatted before you upload them.

After uploading your CSV, your license keys will be displayed to you so you can check they're correct. If all seems good, you can proceed creating your package and we'll take care of issuing license keys to customers via email after successful purchases.

Just so you know:

• We only support CSVs of up-to 500 license keys at once.

• Your CSV can be re-uploaded unlimited times so you can replenish your license keys.

• You can view the license key given to an individual customer by viewing the payment.

File Downloads

You can get Tebex to send a customer a file after a successful purchase, here's how.

Click 'Add Deliverable' and after, click 'File Download', you'll then be prompted to provide the file you'd like to send to customers. We'll host your file and customers will receive an email after purchase with a link where they can download the file from our servers; we handle the process, so you don't need to worry about hosting your file elsewhere.

Just so you know:

• If a customer contacts you stating they haven't received their download link email - please ask them to check their spam or junk folders, and search "Tebex" in their email.

• File size is limited to 300MB.

Webhooks

You can send payment information through webhooks to your own servers to manage product delivery if you'd like; for more information on this, see our Developer Documentation article on Webhooks here.

Gift Cards

You can set packages to issue gift cards to customers after a successful purchase if you like.

To do this, click 'Add Deliverable', then 'Gift Cards'. After, enter a fixed amount for the gift card you'd like to issue, or click the 'Same As Package Price' box on the right to ensure the gift card you issue always reflects what the customer paid for the package.

We'll then take care of the rest, emailing the customer's gift card to them automatically after a successful purchase.

And To Finish...

Once you have entered the relevant information above and you're happy with your package, click Create or Update, and you'll now be able to see your brand new or updated package listed on your webstore 🙌