Cuenta de Ahorro

`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,
    "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)
`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