Skip to Content
QvaPay API
User

TrustScore

Consultar la puntuación de confianza de la cuenta, de dónde sale y cómo subirla.

Cada cuenta tiene una puntuación de confianza de 0 a 100. El equipo de QvaPay puede asignarla a mano; si no lo ha hecho, se calcula sola con la actividad de la cuenta y llega como máximo a 84.

La puntuación calculada es informativa: no cambia límites ni permisos. Los requisitos de TrustScore de las ofertas P2P y los depósitos con tarjeta y PayPal siguen usando la puntuación asignada por el equipo, que es el campo trustscore de GET /user/extended.

Cómo se calcula

BloqueQué cuentaPuntos
IdentidadIdentidad verificada, teléfono, Telegram, autenticador o llave de acceso25
AntigüedadTiempo con la cuenta y meses con operaciones P2P20
Historial P2POperaciones completadas, personas distintas y volumen35
ReputaciónValoraciones recibidas20

Cada bloque suma rápido al principio y cada vez menos después. Repetir muchas operaciones con la misma persona cuenta poco.

Restan puntos las operaciones que no se pagaron a tiempo, las disputas resueltas en contra, las valoraciones de 1 o 2 estrellas y los bloqueos recibidos. Lo que resta pesa la mitad cada 90 días y pesa menos cuanto menor es su proporción sobre la actividad reciente.

GET /user/trust-score

Autenticacion

Bearer Token (Authorization: Bearer {token}).

Request

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

Response

Puntuación calculada:

{
  "enabled": true,
  "available": true,
  "source": "auto",
  "score": 75,
  "max": 84,
  "blocks": [
    {
      "key": "identity",
      "title": "Identidad",
      "points": 25,
      "max": 25,
      "items": [
        { "key": "kyc", "label": "Identidad verificada", "points": 15, "max": 15 },
        { "key": "phone", "label": "Teléfono verificado", "points": 4, "max": 4 }
      ]
    }
  ],
  "penalties": [
    { "key": "disputesLost", "label": "Disputas resueltas en tu contra", "points": 2.4 }
  ],
  "penalty": 8.7,
  "limit": null,
  "tips": ["Evita las disputas: paga lo acordado y libera en cuanto recibas."],
  "computed_at": "2026-11-20T23:00:19.000Z"
}
CampoDescripción
enabledfalse si la consulta no está activa para la cuenta. No trae más campos.
availablefalse si la puntuación no se puede mostrar en este momento. No trae más campos.
sourceauto (calculada) o manual (asignada por el equipo).
score, maxPuntuación y su máximo: 84 si es calculada, 100 si es asignada.
blocksSolo con auto. Puntos obtenidos y máximos por bloque y por elemento.
penalties, penaltySolo con auto. Lo que resta, por motivo, y el total.
limitTexto que explica un máximo temporal (cuenta nueva, identidad sin verificar, pausa de seguridad) o null.
tipsHasta cuatro sugerencias para subirla.
computed_atCuándo se calculó. Se recalcula como mucho cada seis horas.

Puntuación asignada por el equipo:

{ "enabled": true, "available": true, "source": "manual", "score": 90, "max": 100 }

Errores

CódigocodeMotivo
401UNAUTHORIZEDToken inválido o ausente.
429RATE_LIMITEDMás de 10 consultas por minuto.