Tiers

Sistema de progresion con tiers y experiencia.

El sistema de tiers permite crear una progresion permanente para tus usuarios basada en XP (experiencia).

Configuracion

1. Ve a Tiers en la consola
2. Define los tiers con:
   • Nombre — ej: "Bronce", "Plata", "Oro"
   • XP requerido — XP necesario para alcanzar el tier
   • Recompensa (opcional) — premio al subir de tier

Como se gana XP

El XP se otorga automaticamente al:

• Jugar un juego — configurable por campana
• Ganar un juego — configurable por campana
• Canjear un codigo
• Trackear eventos custom

Progresion

Tier 1: Novato     (0 XP)
Tier 2: Bronce     (100 XP)
Tier 3: Plata      (300 XP)
Tier 4: Oro        (600 XP)
Tier 5: Diamante   (1000 XP)

El XP es permanente — nunca se pierde. A diferencia de los puntos, no se puede gastar.

API

curl "https://southgames.ai/api/v1/clients/tier?externalUserId=user_123" \
  -H "Authorization: Bearer sg_live_xxx" \
  -H "X-Org-Id: mi-empresa"

Respuesta:

{
  "clientId": "user_123",
  "xp": 450,
  "tier": {
    "id": "silver",
    "name": "Plata",
    "color": "#C0C0C0",
    "icon": "medal",
    "benefits": ["10% de descuento", "Soporte prioritario"]
  },
  "nextTier": {
    "name": "Oro",
    "minXp": 600,
    "xpRemaining": 150
  },
  "stats": {
    "totalGamesPlayed": 42,
    "totalWins": 18,
    "totalCodesRedeemed": 5
  }
}

Webhook

Se dispara client.tier_up cuando un usuario sube de tier.

XP vs Puntos

Ambos sistemas funcionan en paralelo y se configuran de forma independiente.