Skip to main content
MonetizationCluster guide · 9 min read

How to Set Up a Tebex Store for Your FiveM Server

Setting up a Tebex webstore is the standard way to take payments and deliver in-game rewards on a FiveM server. This guide walks through the account, the native server integration, secret keys, categories, packages, and payment gateways from start to finish.

How to Set Up Tebex for FiveM (Step by Step)
Quick answer

To set up a Tebex store for FiveM, create a free Tebex account and add a webstore, connect a payment gateway like PayPal or Stripe, then build categories and packages with command or role based delivery. FiveM has native Tebex support built in, so you do not download a resource. You connect your server by adding your store secret key to server.cfg with the sv_tebexSecret convar and restarting, after which purchases are delivered automatically. Tebex acts as the merchant of record and handles checkout, tax, and fraud screening for you.

On this page

Tebex is the payment and delivery platform most FiveM servers use to sell donor perks, vehicles, priority queue, and other in-game rewards. It was previously known as BuyCraft, and you will still see that name in older guides and some legacy URLs. The platform gives you a hosted webstore, a checkout that handles tax and fraud screening, and a native server integration that turns a completed purchase into an in-game action. This guide covers the full setup so a purchase on your store reliably delivers the reward in your server.

Before you start, understand the split of responsibilities. Tebex hosts the store, processes the money, and acts as the merchant of record. Your FiveM server uses the built in Tebex integration to receive completed purchases and execute the commands you defined. FiveM has native Tebex support, so there is no resource to download for the standard setup. You connect the two with a secret key. Get that link right and the rest is mostly content work.

Step 1: Create a Tebex account and add a webstore

Sign up at the Tebex creator dashboard with an email and password. After verifying your email you will create your first webstore. Tebex asks which game or platform the store is for, and you select FiveM. This matters because it sets the correct integration type and unlocks the FiveM specific options later.

During webstore creation you pick a store name, a URL slug, and a base currency. The base currency is the currency Tebex uses internally for your pricing and reporting, so choose the one that matches your main payout account. You can still show localized prices to buyers in other regions, which is covered further down.

Once the store exists you land on the store dashboard. From here you manage packages, categories, payments, and the appearance of the public storefront. The public store has its own address, usually yourname.tebex.io, which you share with your community.

Step 2: Connect a payment gateway

No store can take money until at least one payment gateway is connected. In the dashboard open the payments or gateways section and link an account. Common options for FiveM creators include PayPal and Stripe, with additional methods such as cards, Apple Pay, and various local methods available depending on your region and Tebex plan.

Tebex operates as the merchant of record, which means Tebex is the entity that legally sells to the buyer and remits to you on a payout schedule. This is helpful because Tebex handles sales tax and VAT collection and a layer of fraud and chargeback screening. Your job is to connect a valid gateway and complete any identity or business verification the gateway requires before payouts release.

Connect more than one gateway if you can. If a single provider has an outage or limits a transaction, a second gateway keeps sales flowing. Test a small live purchase yourself once a gateway is active so you know the money path works end to end.

Step 3: Plan categories and packages

A category is a section of your store, and a package is a single item a buyer can purchase. Plan the structure before you create items so the store reads cleanly. A typical FiveM store has categories like Donor Ranks, Vehicles, and Quality of Life, with packages inside each.

When you create a package you set its name, price, image, and description, then attach it to a category. You also choose whether the package is a one time purchase or a recurring subscription. Subscriptions are how monthly donor tiers work, and Tebex bills the buyer automatically each cycle. For each package you also decide what actually gets delivered, which is the next step.

Command rewards versus role rewards

Tebex delivers a purchase in one of two main ways for FiveM. The first is command delivery, where Tebex tells your server to run one or more server commands when the purchase completes. You write these commands in the package settings, and Tebex substitutes placeholders such as the buyer identifier into them. A command package might add money to a character, grant a vehicle, or set an ace permission.

The second is role or group delivery, often handled by pairing Tebex with a Discord integration so a purchase assigns a Discord role, or by using commands that set a permission group your framework reads. Many servers combine both: a command grants the in-game effect and a separate action grants a Discord role for visible status. Decide per package which delivery method fits, because a cosmetic vehicle needs a command while a priority queue perk may be driven by a permission group.

Step 4: Connect your server with the secret key

The link between your store and your server is the secret key, and FiveM has native Tebex support built in, so for the standard setup there is nothing to download. In your Tebex control panel go to Integrations, then Game Servers, choose Connect Game Server, and select the plugin option for FiveM. Tebex shows you a unique secret key and the exact line to add.

You apply the key by adding a convar to your server.cfg. Paste the line Tebex gives you, which looks like sv_tebexSecret followed by your key, near the bottom of the file. Treat this key like a password. Anyone with it can act as your store integration, so never paste it into a public channel, a screenshot, or a committed config file in a public repository.

After adding the line, restart your server as you normally would. Return to the control panel and confirm the connection, where Tebex reports that your server is linked. If it does not connect, the key is wrong, copied with extra whitespace, or the line was not loaded. The native integration polls Tebex on a short interval for completed purchases, so newly purchased commands are picked up automatically within a minute. If you instead run a community wrapper resource rather than the native integration, place it in your resources folder and add a start line such as ensure tebex after the sv_tebexSecret line, but the native path is recommended for reliability.

Step 5: Map deliveries and test a purchase

With the resource connected, return to each package and confirm the delivery commands are exactly what your framework expects. Run the command manually in your server console first to prove it works, then copy that working command into the package. This avoids the common trap of a purchase succeeding while the reward silently fails because the command had a typo.

Now run a real test purchase. Buy the cheapest package yourself, or use any sandbox or test mode your gateway offers, and watch the server console as the purchase completes. You want to see the integration receive the event and run the command. Tebex also lets you manually resend or re-run a purchase from the dashboard, which is useful when a player was offline at the moment of purchase and the command needs to fire when they next join.

Step 6: Regional pricing and presentation

Tebex can localize prices so buyers see amounts in their own currency. You can let Tebex convert from your base currency automatically, or set explicit prices per region for cleaner round numbers. Localized pricing meaningfully improves conversion because a buyer in the EU seeing euros trusts the checkout more than one seeing a converted figure with odd decimals.

Spend time on the storefront presentation too. Clear package names, a short benefit focused description, and a consistent image style make the store feel legitimate. A store that looks unfinished loses sales even when the underlying delivery works perfectly.

A note on Cfx compliance

FiveM runs under the Cfx.re platform, and Cfx publishes rules about what servers may sell. At a high level, you may sell things that do not create pay to win advantages or break the terms, such as cosmetic items, priority queue access, and supporter ranks, while selling outright gameplay power or anything that infringes Rockstar or third party intellectual property is not allowed. Tebex setup does not exempt you from these rules. Read the current Cfx server commercialization terms before you decide what your packages grant, because a takedown of your server costs far more than any single sale.

Keep your delivery commands aligned with that. A donor rank that grants visible status and a queue slot is safe ground. A package that hands a paying player a clear combat or economy advantage over everyone else is the kind of thing that draws enforcement and erodes your community at the same time.

Checklist
  • Create a Tebex account and verify your email
  • Add a webstore and select FiveM as the platform
  • Set your base currency to match your payout account
  • Connect at least one payment gateway (PayPal or Stripe) and complete verification
  • Plan categories before creating packages
  • Create packages with prices, images, and clear descriptions
  • Choose command or role based delivery per package
  • In the control panel open Integrations, then Game Servers, and connect your FiveM server
  • Copy the unique secret key Tebex shows you
  • Add the sv_tebexSecret line to your server.cfg and restart the server
  • Confirm the control panel reports a successful store connection
  • Test each delivery command in the console before saving it to a package
  • Run a live test purchase and watch the reward deliver
  • Configure regional pricing for your main buyer currencies
  • Review current Cfx commercialization rules against your packages
Package type Typical delivery method Notes
Donor rank or supporter tier Recurring subscription plus command or permission group Bills monthly, often paired with a Discord role
In-game currency or kit One time command Run the command manually first to confirm syntax
Cosmetic vehicle or skin One time command Keep cosmetic only to stay Cfx compliant
Priority queue access Permission group or ace permission via command Drive from a group your framework reads
Discord visible perk Role assignment via Discord integration Combine with a command for in-game effect
Offline player reward Command queued and run on next join Use the dashboard resend if delivery is missed
Common mistakes
  • Pasting the store secret key into a public channel, screenshot, or committed config. Fix: treat it like a password, keep the sv_tebexSecret line out of any public repo, and rotate the key in the control panel if it leaks.
  • Saving a delivery command without testing it. Fix: run the exact command in the server console first, confirm the reward appears, then copy it into the package.
  • Forgetting to add the sv_tebexSecret line to server.cfg, so the server never links to your store. Fix: add the line near the bottom of server.cfg, restart, and confirm the control panel reports a successful connection.
  • Selling pay to win advantages that break Cfx rules. Fix: limit packages to cosmetics, status, and queue access, and read the current commercialization terms before launch.
  • Relying on a single payment gateway. Fix: connect a second gateway so an outage or a declined method does not stop all sales.
  • Assuming offline players get rewards instantly. Fix: use a delivery method that queues the command for next join, and use the dashboard resend when a delivery is missed.
The Quasar take

Sustainable FiveM monetization is boring on purpose. Sell status, convenience, and identity, never raw power, and your store keeps earning because players trust that paying does not ruin the server for everyone else. The servers that flame out are the ones that sold the in-game economy to the highest bidder. Build the store once, keep it compliant, and let recurring donor tiers do the slow compounding work.

Is Tebex the same as BuyCraft?
Yes. Tebex was previously known as BuyCraft, so older guides and some legacy links use that name. The platform and your FiveM setup steps are the same regardless of the name you see referenced.
Where do I find my Tebex secret key for FiveM?
In your control panel go to Integrations, then Game Servers, and connect your FiveM server. Tebex shows you a unique secret key there. Copy it carefully without extra whitespace, add it to server.cfg as sv_tebexSecret, and never share it publicly since it authenticates your server to your store.
How does a purchase actually reach my server?
FiveM has native Tebex support, so you do not download a resource. You add your secret key to server.cfg with sv_tebexSecret and restart. The built in integration then polls Tebex for completed purchases and executes the delivery commands you set on each package, picking up new purchases within about a minute.
What payment methods can I accept?
Common options include PayPal and Stripe, plus cards and various local methods depending on your region and plan. Tebex acts as the merchant of record and handles tax collection and fraud screening for you.
What can I sell without breaking Cfx rules?
Cosmetics, supporter ranks, and priority queue access are generally safe. Selling outright gameplay power or infringing intellectual property is not allowed. Always check the current Cfx commercialization terms before launch.
Do offline players still get their rewards?
Yes, if your delivery method queues the command to run when the player next joins. If a delivery is missed you can resend or re-run the purchase from the Tebex dashboard.

Ready for the next step?

Stop guessing. Get a concrete plan for your server and move with confidence.

Written by
Kishi · FiveM Coach
Part of the FiveM Coach by Quasar team. We help server owners launch, fix, grow, and monetize stable RP cities.