Skip to main content

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

EstadoCódigoDescripción
✅ 200200 OKLa solicitud fue exitosa.
⚠️ 422422 Unprocessable EntityError en los datos enviados.
❌ 500500 Internal Server ErrorError 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!"
}