Recompensa
Qué se entrega al completar una mecánica, y cómo llega a tu sistema
El recompensa es lo que se entrega cuando el usuario completa la mecánica: puntos, o un producto con su código.
Se configura en el Control Center. Tu sistema no decide qué se entrega ni cuándo — solo lo recibe y lo muestra.
Cuándo se paga
Una recompensa se entrega al completarse la campaña, nunca al completarse una misión suelta. Vale para las cuatro mecánicas por igual: una campaña de tipo hito con tres misiones paga una vez, cuando las tres están cumplidas — no tres veces.
| Experiencia | Qué tiene que completarse |
|---|---|
| Hito | Todas las misiones de la campaña |
| Reto | La cadena completa |
| Racha | La meta de ventanas seguidas |
| Rutina | El último ciclo |
Cómo llega a tu sistema
Tres caminos, según cómo integres:
- En la respuesta del evento.
POST /gamification/triggersdevuelve la recompensa en el mismo request que lo disparó, cuando se pudo resolver en el momento. - Por webhook. Si emitís por el camino asincrónico, el resultado llega a tu endpoint. Ver Webhooks.
- Consultando.
GET /v1/gamification/missions/my-rewards/{accountId}devuelve las recompensas ganadas, con sus códigos cuando corresponde.
La rama de espera
La misión puede completarse sin que la recompensa esté disponible todavía. Si el stock se agotó justo en ese momento, la misión queda completada y la recompensa se entrega después.
En la respuesta lo ves como una misión COMPLETED con rewards vacío. Mostrale al usuario "misión cumplida, tu recompensa llega en breve" y reconciliá con my-rewards. Nunca digas "no ganaste".
Reclamo explícito
Si tu UX incluye un botón de reclamo, existe un endpoint dedicado. Si no lo incluye, la recompensa se entrega sola y ese caso no existe en tu app. Ver Progreso y recompensas.
Las recompensas ya entregadas no se tocan
Ni cuando la campaña se pausa, ni cuando termina, ni cuando el usuario pierde una racha. El historial de recompensas se mantiene intacto.