Vendre sur ton serveur avec Tebex

En bref. Pour vendre quelque chose sur ton serveur contre de l'argent réel, c'est Tebex qui encaisse, gère les taxes, les remboursements et les litiges, et qui livre. Agora ne fait qu'afficher : il montre ta boutique à tes joueurs et les envoie payer chez Tebex. Agora ne touche jamais l'argent et n'est jamais partie à une vente.

La documentation officielle de Tebex fait foi pour tout ce qui se passe chez Tebex (écrans, noms des réglages, frais). Les liens ci-dessous pointent vers la bonne page.

1. Créer ta boutique Tebex #

1. Crée ton compte sur creator.tebex.io, puis ta boutique (webstore) pour le jeu FiveM.
2. Renseigne le nom, la devise et les informations de paiement que Tebex te demande : ce sont elles qui décident où arrive l'argent.

📖 Guide de Cfx.re : Setting Up a Tebex Store.

2. Créer tes paquets #

Un paquet (package), c'est ce que le joueur achète : un nom, un prix, une image, une catégorie, et ce qui se passe à l'achat (les commandes que ton serveur exécute, par exemple donner un véhicule ou un grade).

1. Crée une catégorie, puis un premier paquet.
2. Dans ses commandes, utilise les variables de Tebex pour viser le bon joueur ; n'écris jamais un identifiant en dur.
3. Choisis si la livraison exige que le joueur soit en ligne : c'est souvent plus sûr pour un objet en jeu.

3. Relier Tebex à ton serveur FiveM (livraison) #

C'est Tebex qui livre, grâce à son intégration FiveM (intégrée à FXServer, rien à télécharger).

1. Dans Tebex : Integrations → Game Servers → Connect Game Server → Plugin, nomme ton serveur, puis copie la clé secrète affichée.
2. Ajoute-la à la fin de ton server.cfg : sv_tebexSecret ta-cle-secrete. Dans Agora, tu peux le faire depuis Serveur → Éditeur .cfg.
3. Redémarre le serveur (Serveur → Console), puis vérifie dans la console que Tebex se connecte.

📖 FiveM — documentation Tebex.

4. Afficher ta boutique dans Agora #

À partir d'Agora 0.2, tes joueurs connectés peuvent voir tes paquets et acheter depuis la page Boutique, à l'adresse /concession/boutique de ton site (aucun menu ni bloc de l'accueil n'y mène encore : donne-leur l'adresse) ; le paiement se fait toujours chez Tebex. Voir Le catalogue Tebex de la concession.

1. Dans Tebex, ouvre Developers → API Keys et copie la clé publique (de la forme xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx). Elle ne permet que de lire la vitrine : ni l'argent ni les commandes.
2. Dans Agora, ouvre Modération → Concession, colle-la dans Clé publique de la boutique, puis Connecter. Agora vérifie la clé auprès de Tebex.
3. Dans Livraison des achats, laisse Le plugin FiveM officiel de Tebex livre lui-même (recommandé).

📖 Clé publique (Headless API).

5. Faire un achat en mode test #

Avant d'ouvrir la boutique à tout le monde, fais un achat sans vrai paiement :

1. Dans Tebex : Settings → Checkout → Test Mode. Un moyen de paiement Test Payments, qui réussit toujours, apparaît au paiement.
2. Achète un paquet avec ton propre compte, connecté sur le serveur, en choisissant Test Payments.
3. Vérifie que la livraison arrive une seule fois et dans le bon délai.
4. Avant d'ouvrir au public : Settings → Checkout → Remove Test Payments.

📖 Tester un achat.

Qui fait quoi #