Puntos: saldo

Consultar el saldo de puntos de un cliente.

GET/api/sdk/points/balance

Retorna el saldo actual, total ganado y total gastado de puntos.

Query params

ParametroTipoDescripcion

Ejemplo

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

Respuesta

{
  "success": true,
  "data": {
    "pointsBalance": 150,
    "pointsEarned": 200,
    "pointsSpent": 50,
    "pointsName": "Monedas"
  }
}

Errores

CodigoHTTPDescripcion
NOT_FOUND404Cliente no encontrado
POINTS_NOT_ENABLED400Sistema de puntos no habilitado