Conceptos
Bolsas de recompensas
Copiar página
Lia puede financiar un fondo de $LIA para su aplicación. Su servidor paga a los jugadores desde él, una vez por recompensa, dentro del fondo y el límite diario por jugador.
#¿Qué es un pozo
Un fondo de recompensas es $LIA el Lia equipo reserva para su aplicación de Lia'su tesorería. Tu servidor paga a los jugadores desde ella: por ganar un torneo, completar una misión, ver un video, cualquier cosa que tu aplicación decida. El $LIA va directamente al jugador's saldo en Lia, y se muestra en su actividad bajo su app'tu nombre con la razón que das.
El equipo Lia decide si tu aplicación tiene un fondo, lo financia y puede añadir más o recuperar parte. Pregúntales sobre uno cuando tú habla con nosotros.
#Pagar una recompensa
Tu servidor llama POST /rewards con tu clave secreta:
{
"playerId": "p_3f9c0a6d1b2e4f5a6b7c",
"amount": 25,
"key": "tournament-2026-11-01:p_3f9c0a6d1b2e4f5a6b7c",
"reason": "Weekly tournament, 1st place"
}Las recompensas solo provienen de su servidor. Allí'tu no llamada SDK para ellos, porque una página no puede't ser confiado para decir lo que alguien ganó.
#Una vez por clave
Cada recompensa tiene un clave que elijas, hasta 128 caracteres de letras, dígitos, _, ., : y -. Una clave paga una vez, para siempre: enviar la misma clave nuevamente no paga nada y responde { "status": "duplicate" } con la cantidad que pagó la primera vez. Así que:
- Haz que la clave indique para qué es la recompensa, para que un reintento o un doble clic puedan'no pagar dos veces:
daily:2026-11-01:p_3f9c…,quest-7:p_3f9c…,ad:ad_8e1c…. - Es'es seguro reintentar una recompensa después de un tiempo de espera con la misma clave.
#Límites
| Límite | ¿Qué pasa |
|---|---|
| Un premio es más de 0 y como máximo 10,000 LIA, hasta 6 decimales. | 400 bad_amount |
| La piscina debe mantener la cantidad. | 409 pool_empty, con lo que'te queda |
| Un jugador puede obtener como máximo el límite diario por jugador de tu grupo en un día (UTC). El equipo Lia lo establece; 0 significa sin límite. | 429 daily_limit, con el límite |
GET /pool le dice a tu servidor qué'te queda y el límite diario. Observa el saldo y pide al equipo que lo recargue antes de que se agote.
#Modo de prueba
Con tu clave de prueba, las recompensas son ficticias: ellas'se ha grabado y su webhook se ha enviado, pero su pozo no'usado. El límite diario no't aplicar, y ningún $LIA llega al jugador. Las teclas aún se usan una vez.
#Webhooks
Cada recompensa pagada envía un reward.paid webhook con su clave, jugador, cantidad, razón y modo. Una duplicación no envía nada.
Recompensar a los jugadores lo une con un bono diario como ejemplo.
Traducido automáticamente. El inglés es la fuente de verdad. Leer en inglés