Tebex

Connect a Tebex webstore with its server secret key and a webhook, and see which events Analyse records.

Updated September 15, 20261 min read

Before you start

You need access to your store in the Tebex creator panel, and the game open in Analyse under Settings, Integration. Choose Connect and pick Tebex.

1. Paste the game server secret key

  1. In Tebex, open Game Servers and pick your server.
  2. Copy its Secret key. No server yet? Choose Connect Game Server, then Plugin.
  3. Paste it into Game server secret key in Analyse.

Analyse checks the key with Tebex and reads your packages and categories.

2. Add the webhook

  1. In Tebex, open Developers, then Webhooks.
  2. Add an endpoint and paste the webhook URL Analyse shows you. It ends in /api/webhooks/<id>.
  3. Tick the payment events (below) and save.

Tebex sends a validation request when you add the endpoint. Analyse answers it automatically.

3. Paste the webhook secret

Copy the webhook secret from the top of the Webhooks page in Tebex, above your endpoints, and paste it into Analyse. Every webhook is checked against it; requests with a wrong signature are rejected.

Events

Tebex eventRecorded as
payment.completedCompleted purchase
payment.refundedRefunded
payment.dispute.openedChargeback
payment.dispute.wonCompleted again

Other Tebex events are ignored.

How purchases map

  • Player: the Minecraft username attached to the package, or the customer's username. UUIDs without dashes are normalised.
  • Package: the Tebex package id and name. A basket with several packages becomes one row per package, with the amount paid split by price.
  • Coupon and creator code: the first coupon and the creator code on the payment.

Past payments

After connecting, choose Import past payments in the setup dialog to bring in your history.