QvaPay API
User

Notificaciones

Consultar y actualizar las preferencias de notificaciones del usuario.

GET /user/notifications

Retorna las preferencias de notificaciones del usuario autenticado. Si no existen preferencias previas, se crean con valores por defecto.

Autenticacion

Bearer Token (Authorization: Bearer {token}).

Request

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

Response

{
  "email_enabled": true,
  "telegram_enabled": true,
  "push_enabled": true,
  "sms_enabled": false
}

Campos de respuesta

CampoTipoDescripcion
email_enabledbooleanNotificaciones por email habilitadas
telegram_enabledbooleanNotificaciones por Telegram habilitadas
push_enabledbooleanNotificaciones push habilitadas
sms_enabledbooleanNotificaciones por SMS habilitadas

POST /user/notifications

Actualiza las preferencias de notificaciones del usuario. Solo se actualizan los campos enviados.

Autenticacion

Bearer Token (Authorization: Bearer {token}).

Request

curl -X POST https://api.qvapay.com/user/notifications \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "email_enabled": true,
    "telegram_enabled": false,
    "push_enabled": true,
    "sms_enabled": false
  }'

Parametros

ParametroTipoRequeridoDescripcion
email_enabledbooleanNoHabilitar/deshabilitar notificaciones por email
telegram_enabledbooleanNoHabilitar/deshabilitar notificaciones por Telegram
push_enabledbooleanNoHabilitar/deshabilitar notificaciones push
sms_enabledbooleanNoHabilitar/deshabilitar notificaciones por SMS

Response

{
  "message": "Notification settings updated successfully",
  "settings": {
    "email_enabled": true,
    "telegram_enabled": false,
    "push_enabled": true,
    "sms_enabled": false
  }
}

Errores

CodigoDescripcion
400No se enviaron campos validos para actualizar
401No autorizado o token invalido
500Error al obtener o actualizar las preferencias