Concepts

Pools de récompenses

Copier la page

Lia peut financer un pool de $LIA pour votre application. Votre serveur paie les joueurs à partir de ce pool, une fois par récompense, dans le pool et la limite quotidienne par joueur.

#Ce qu'est un pool

Un pool de récompenses est $LIA de l'équipe Lia qui réserve pour votre application à partir de Lia'du trésor. Votre serveur paie les joueurs à partir de celui-ci : pour gagner un tournoi, terminer une quête, regarder une vidéo, tout ce que votre application décide. Le $LIA est envoyé directement au joueur'votre solde dans Lia, et s'affiche dans leur activité sous votre application'le nom avec la raison que vous donnez.

L'équipe Lia décide si votre application a un pool, le finance, et peut le recharger ou en retirer. Demandez-leur un pool lorsque vous parlez-nous.

#Payer une récompense

Votre serveur appelle POST /rewards avec votre clé secrète :

{
  "playerId": "p_3f9c0a6d1b2e4f5a6b7c",
  "amount": 25,
  "key": "tournament-2026-11-01:p_3f9c0a6d1b2e4f5a6b7c",
  "reason": "Weekly tournament, 1st place"
}

Les récompenses proviennent toujours de votre serveur. Il'le non appel SDK pour eux, car une page peut'ne pas être fait confiance pour dire ce que quelqu'un a gagné.

#Une fois par clé

Chaque récompense a une clé que vous choisissez, jusqu'à 128 caractères de lettres, de chiffres, _, ., : et -. Une clé paie une fois, pour toujours : envoyer la même clé à nouveau ne paie rien et répond { "status": "duplicate" } avec le montant qu'il a payé la première fois. Donc :

Faites en sorte que la clé indique ce pour quoi la récompense est donnée, afin qu'un redémarrage ou un double clic puisse'ne pas payer deux fois : daily:2026-11-01:p_3f9c…, quest-7:p_3f9c…, ad:ad_8e1c….
Il'il est sécurisé de réessayer une récompense après un délai avec la même clé.

#Limites

Limite	Ce qui se passe
Une récompense est plus de 0 et au maximum 10,000 LIA, avec 6 décimales.	`400 bad_amount`
Le pool doit conserver le montant.	`409 pool_empty`, avec quoi's restants et la limite quotidienne. Surveillez le solde et demandez à l'équipe de le recharger avant qu'il ne soit épuisé.
Un joueur peut obtenir au maximum le limite quotidienne par joueur de votre pool en une journée (UTC). L'équipe Lia le définit ; 0 signifie pas de limite.	`429 daily_limit`, avec la limite

GET /pool vous dit à votre serveur ce's restants est assez sombre pour le texte blanc, et l'objet est à droite.

#Mode test

Avec votre clé de test, les récompenses sont fictives : elles'êtes enregistrés et leur webhook est envoyé, mais votre pool n'est pas'utilisé, la limite quotidienne ne't appliquer, et aucun $LIA n'atteint le lecteur. Les touches sont toujours une seule fois.

#Webhooks

Chaque récompense payée envoie une reward.paid webhook avec sa clé, joueur, montant, raison et mode. Un doublon envoie rien.

Récompenser les joueurs le combine avec une prime quotidienne comme exemple.

Traduit automatiquement. L'anglais est la source de vérité. Lire en anglais