Referidos: aplicar

Aplicar un codigo de referido a un cliente.

POST/api/sdk/referrals/apply

Aplica un codigo de referido. El cliente que lo usa queda como 'referido' del dueno del codigo.

Request body

Parametro	Tipo	Descripcion

Se requiere clientId o externalUserId.

Ejemplo

curl -X POST https://southgames.ai/api/sdk/referrals/apply \
  -H "Authorization: Bearer sg_live_xxx" \
  -H "X-Org-Id: mi-empresa" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "REF-A1B2C3",
    "externalUserId": "user_456"
  }'

Respuesta

{
  "success": true,
  "data": {
    "success": true,
    "referralId": "ref_xyz",
    "status": "pending",
    "reward": {
      "type": "points",
      "amount": 50
    }
  }
}

Campo	Tipo	Descripcion
`referralId`	`string`	ID del referido creado
`status`	`string`	Estado: `pending` o `completed`
`reward`	`object`	Recompensa otorgada al referido (si aplica)

Errores

Codigo	HTTP	Descripcion
`REFERRAL_ERROR`	400	Codigo no encontrado, inactivo, auto-referido, ya referido, limite alcanzado, cuenta muy nueva, mismo dispositivo, o cliente anonimo