Skip to Content
QvaPay API
Saving

Cuenta de Ahorro

Consultar el estado de la cuenta de ahorro del usuario autenticado.

GET /saving

Retorna el resumen de la cuenta de ahorro del usuario autenticado: balance, totales historicos, tasa de interes vigente y el estado del ajuste de redondeo automatico.

La cuenta de ahorro requiere KYC aprobado y se crea con el primer deposito. Si el usuario no tiene cuenta, hasAccount retorna false con los totales en cero.

Autenticacion

Bearer Token (Authorization: Bearer {token}).

Request

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

Response

{
  "success": true,
  "data": {
    "hasAccount": true,
    "balance": 125.4,
    "totalDeposited": 300.0,
    "totalWithdrawn": 180.0,
    "totalEarned": 5.4,
    "currentRate": 3.75,
    "lastEarningDate": "2026-06-30",
    "kycVerified": true,
    "usRestricted": false,
    "usDebtRepaymentMax": 0,
    "savings_roundup": false
  }
}

Campos de respuesta

CampoTipoDescripcion
hasAccountbooleanSi el usuario tiene cuenta de ahorro creada
balancenumberBalance actual de la cuenta de ahorro (puede ser negativo si existe una deuda cargada por administracion)
totalDepositednumberTotal historico depositado
totalWithdrawnnumberTotal historico retirado
totalEarnednumberTotal historico ganado por intereses
currentRatenumberTasa de interes anual vigente (%)
lastEarningDatestring | nullFecha del ultimo pago de intereses
kycVerifiedbooleanSi el usuario tiene KYC aprobado (requisito para operar la cuenta)
usRestrictedbooleanCuenta verificada con documento de Estados Unidos: no puede abrir ni depositar en ahorros (si puede retirar lo que ya tenga)
usDebtRepaymentMaxnumberCon usRestricted y balance negativo, monto maximo que puede depositar para saldar la deuda (nunca deja el balance por encima de 0). 0 en cualquier otro caso
savings_roundupbooleanSi el usuario tiene activo el redondeo automatico

Errores

CodigoDescripcion
401No autorizado o token invalido
500Error al obtener la informacion de ahorro

Depositos de cuentas con documento de Estados Unidos

POST /saving/deposit responde 403 con code: "US_SAVINGS_RESTRICTED" a una cuenta con usRestricted sin deuda. Con deuda acepta depositos hasta usDebtRepaymentMax; por encima responde 400 con code: "US_SAVINGS_DEBT_CAP" y el maximo en max.

Límite de peticiones

POST /saving/deposit y POST /saving/withdraw admiten una operación cada 5 segundos por usuario. Por encima responden 429 con code: "RATE_LIMITED".