Puntos: gastar

Gastar puntos del saldo de un cliente.

POST/api/sdk/points/spend

Gasta puntos del saldo del cliente. Falla si el saldo es insuficiente.

Request body

Parametro	Tipo	Descripcion

Ejemplo

curl -X POST https://southgames.ai/api/sdk/points/spend \
  -H "Authorization: Bearer sg_live_xxx" \
  -H "X-Org-Id: mi-empresa" \
  -H "Content-Type: application/json" \
  -d '{
    "externalUserId": "user_123",
    "amount": 100,
    "reason": "Canje por descuento"
  }'

Respuesta

{
  "success": true,
  "data": {
    "pointsSpent": 100,
    "newBalance": 50
  }
}

Errores

Codigo	HTTP	Descripcion
`INSUFFICIENT_BALANCE`	400	Saldo insuficiente
`POINTS_NOT_ENABLED`	400	Sistema de puntos no habilitado

Webhook

Se dispara el evento points.spent.