Skip to main content

Tebex Implementation

This guide explains how to connect your Coinsystem V2 with Tebex to handle coin purchases via Tebex.

Step 1: Add Tebex Secret Key to Your server.cfg​

  1. Log in to your Tebex control panel.
  2. On the left-hand navigation menu, click Integrations and Game Servers.
  3. Click Instructions next to the Game Server you want to use.
  4. Copy the command provided and paste it into your server.cfg. It should look something like this:
sv_tebexSecret <YourSecretKey>

Make sure to replace <YourSecretKey> with the actual secret key provided by Tebex.

Step 2: Create a Tebex Package​

  1. In your Tebex control panel, navigate to Packages.
  2. Create a new package, for example, "100 Coins".
  3. At the bottom of the package creation screen, select Game Server Commands as the deliverable type.

  1. Select your game server and click Add Command.

  2. Use the following command to deliver the coins:

    saveredeemcode {transaction} 100
    • Replace the 100 with the actual amount of coins the user will receive for this package.

  3. Click on the settings icon on the right

  4. Select your game server again here and make sure that the command is executed even if the player is offline (if you require the player to be online and the player is online, it may not work)

  1. Save your package.

Step 3: Test the Integration​

  1. In the Tebex control panel, click Payments on the left-hand menu.
  2. Click on Create Payment.
  3. Enter your username under Customer and select the package you created earlier.
  4. After creating the payment, you should be able to claim the coins in-game by using your payment ID.

Possible Problems​

If players are unable to claim their coins after a Tebex purchase, try the following solutions:

Wait for Processing​

Problem: Sometimes there's a short delay before coins become available after a successful purchase.

Fix: Inform players that it can take up to 5 minutes for coins to be claimable in-game after completing the purchase.

Check Tebex Secret Key Usage​

Problem: Payments may not be linked to the correct server if multiple servers are using the same tebexSecretKey.

Fix:

  • Open the server.cfg file on all running servers.
  • Make sure only your live (production) server contains the tebexSecretKey.
  • Remove the key from all other environments (e.g., development or test servers).