Devuelve el saldo de una membresía.
Este punto final devuelve el saldo de un método de pago específico.
Método: POST
URL: api/cardholder/balance
Ejemplo de Request:
{
"membership": "780038289"
}
Códigos de Estado
| Estado | Código | Descripción |
|---|---|---|
| ✅ 200 | 200 OK | La solicitud fue exitosa. |
| ⚠️ 422 | 422 Unprocessable Entity | Error en los datos enviados. |
| ❌ 500 | 500 Internal Server Error | Error interno del servidor. |
Respuestas detalladas
200 OK - Solicitud exitosa
- Descripción: La solicitud se procesó correctamente.
- Respuesta:
{
"success": true,
"message": "Tu consulta fue exitosa",
"data": [
{
"amount": "4392.19999580",
"label": "available"
},
{
"amount": "0.00000000",
"label": "reserved"
},
{
"amount": "0.00000000",
"label": "unsettled"
},
{
"amount": "0.00000000",
"label": "disputing"
}
]
}
422 Unprocessable Entity - Error en los datos enviados
- Descripción: Los datos enviados no cumplen con las reglas de validación.
- Respuesta:
{
"success": false,
"message": "Error al validar los datos.",
"errors": [
{
"field": "membership",
"message": "El membership no existe."
}
]
}
500 Internal Server Error - Error en el servidor
- Descripción: Ocurrió un problema inesperado en el servidor.
- Respuesta:
{
"success": false,
"message": "¡Ocurrio un problema. Contacte a soporte!"
}