QvaPay API
User

Referidos

Consultar los usuarios referidos por el usuario autenticado.

GET /user/referrals

Retorna la lista de usuarios que fueron referidos por el usuario autenticado, junto con el total de referidos.

Autenticacion

Bearer Token (Authorization: Bearer {token}).

Request

curl -X GET https://api.qvapay.com/user/referrals \
  -H "Authorization: Bearer {token}"

Response

{
  "referrals": [
    {
      "uuid": "550e8400-e29b-41d4-a716-446655440000",
      "username": "maria456",
      "name": "Maria",
      "lastname": "Lopez",
      "kyc": true,
      "golden_check": false,
      "image": "profiles/uuid/avatar.webp"
    }
  ],
  "totalReferrals": 15
}

Campos de respuesta

CampoTipoDescripcion
referralsarrayLista de usuarios referidos (max 30)
referrals[].uuidstringUUID del referido
referrals[].usernamestringUsername del referido
referrals[].namestringNombre del referido
referrals[].lastnamestringApellido del referido
referrals[].kycbooleanSi tiene KYC verificado
referrals[].golden_checkbooleanSi tiene plan GOLD
referrals[].imagestringRuta del avatar
totalReferralsnumberTotal de usuarios referidos

Errores

CodigoDescripcion
401No autorizado o token invalido