Saltar a contenido

Créditos

Este módulo maneja la gestión de créditos de los usuarios en el sistema AgroMarket.

Endpoints

GET /api/v1/credits/get

Obtiene el saldo actual de créditos del usuario autenticado.

URL: /api/v1/credits/get

Método: GET

Headers:

Authorization: Bearer <token>

Respuesta exitosa (200):

{
  "credits": 150.50
}

Respuesta de error (401):

{
  "error": "Token inválido"
}

Respuesta de error (500):

{
  "error": "Error de server"
}

POST /api/v1/credits/add

Agrega créditos al saldo actual del usuario autenticado.

URL: /api/v1/credits/add

Método: POST

Headers:

Authorization: Bearer <token>
Content-Type: application/json

Body:

{
  "credits": 50.25
}

Respuesta exitosa (200):

{
  "credits": 200.75
}

Respuesta de error (400):

{
  "error": "Credits must be a positive number"
}

Respuesta de error (401):

{
  "error": "Token inválido"
}

POST /api/v1/credits/substract

Resta créditos del saldo actual del usuario autenticado.

URL: /api/v1/credits/substract

Método: POST

Headers:

Authorization: Bearer <token>
Content-Type: application/json

Body:

{
  "credits": 25.50
}

Respuesta exitosa (200):

{
  "credits": 125.00
}

Respuesta de error (400):

{
  "error": "Insufficient credits"
}

Respuesta de error (401):

{
  "error": "Token inválido"
}

Códigos de Error Comunes

Código Descripción
400 Datos de entrada inválidos o saldo insuficiente
401 Token no válido o expirado
500 Error interno del servidor

Notas Importantes

  • Todos los endpoints requieren autenticación mediante token JWT
  • Los créditos deben ser números positivos
  • No se pueden restar más créditos de los disponibles
  • El saldo se actualiza en tiempo real
  • Los créditos se usan para comprar productos
  • Los créditos se pueden agregar mediante depósitos
  • Los créditos se restan automáticamente al comprar productos