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
| Campo | Tipo | Descripcion |
|---|---|---|
hasAccount | boolean | Si el usuario tiene cuenta de ahorro creada |
balance | number | Balance actual de la cuenta de ahorro (puede ser negativo si existe una deuda cargada por administracion) |
totalDeposited | number | Total historico depositado |
totalWithdrawn | number | Total historico retirado |
totalEarned | number | Total historico ganado por intereses |
currentRate | number | Tasa de interes anual vigente (%) |
lastEarningDate | string | null | Fecha del ultimo pago de intereses |
kycVerified | boolean | Si el usuario tiene KYC aprobado (requisito para operar la cuenta) |
usRestricted | boolean | Cuenta verificada con documento de Estados Unidos: no puede abrir ni depositar en ahorros (si puede retirar lo que ya tenga) |
usDebtRepaymentMax | number | Con 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_roundup | boolean | Si el usuario tiene activo el redondeo automatico |
Errores
| Codigo | Descripcion |
|---|---|
401 | No autorizado o token invalido |
500 | Error 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".