Redondeo Automatico

Cuando el usuario activa el redondeo automatico y recibe un pago mayor a $1 USD, el monto se redondea hacia abajo al dolar entero y los centavos se depositan automaticamente en su cuenta de ahorro. Por ejemplo: al recibir $25.37, el balance principal queda con $25.00 y $0.37 se mueven al ahorro.

El movimiento ocurre despues de acreditarse el pago completo y es best-effort: si por cualquier motivo no puede aplicarse, el usuario conserva el monto integro y el pago nunca se bloquea.

Eventos donde aplica

El redondeo se ejecuta cuando el usuario recibe fondos por:

• Depositos — topups crypto (NowPayments, QryptoMe, TronDealer) y PayPal
• P2P — liberacion de fondos al completarse una oferta (completa o parcial)
• Transferencias — recibidas de otros usuarios (web, API o bot de Telegram)
• Pagos — facturas pagadas por otros usuarios y cobros de apps merchant (/v2/charge)
• Marketplace — payout del vendedor al momento de la venta
• Bonos de referido — bono crypto del 0.2% (cuando supera $1)

No aplica a reembolsos (dinero propio que regresa: cancelaciones P2P, refunds, extracciones fallidas), retiros del propio ahorro ni a pagos de $1 o menos.

Cada redondeo genera un movimiento de tipo roundup en el historial de la cuenta de ahorro (GET /saving/transactions) y una transaccion espejo con remote_id: "SAVINGS_ROUNDUP" en el historial general. Los clientes que rendericen el historial de ahorro deben contemplar este tipo ademas de deposit, withdraw, earning y admin_debit.

Requisitos

• Cuenta de ahorro creada (hasAccount: true en GET /saving). Sin cuenta, el ajuste no se puede activar y la UI debe mostrar el toggle deshabilitado.
• KYC aprobado (implicito al tener cuenta de ahorro).

Consultar el estado

El flag savings_roundup se retorna en tres endpoints:

• GET /saving — recomendado para pantallas de ajustes de ahorro (incluye hasAccount para el estado deshabilitado del toggle)
• GET /user
• GET /user/extended

POST /saving/roundup

Activa o desactiva el redondeo automatico del usuario autenticado.

Autenticacion

Bearer Token (Authorization: Bearer {token}).

Request

curl -X POST https://api.qvapay.com/saving/roundup \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{ "enabled": true }'

Parametros

Response

{
  "success": true,
  "savings_roundup": true
}

Errores