Saltar al contenido principal
Una gestión eficaz de los errores es fundamental para crear integraciones sólidas con la API de Localpayment. Comprender los diferentes tipos de errores y sus códigos correspondientes te ayudará a diagnosticar problemas rápidamente e implementar las soluciones adecuadas. Ofrecemos una gestión integral de errores mediante códigos de estado HTTP estandarizados y respuestas de error detalladas. Esta guía te muestra cómo gestionar los errores de forma eficaz para crear una integración más robusta y fácil de usar.

Descripción general

Una gestión de errores adecuada es fundamental para crear integraciones de pago fiables. Localpayment utiliza una estructura de errores coherente en todos los endpoints de la API para ayudarte a identificar y resolver problemas rápidamente.

Códigos estandarizados

Códigos de error consistentes en todos los endpoints de la API y métodos de pago.

Mensajes detallados

Descripciones legibles para humanos con detalles específicos sobre los errores.

Mejores prácticas

Estrategias comprobadas para gestionar errores en entornos de producción.

Códigos de respuesta HTTP

Localpayment utiliza códigos de estado HTTP estándar para indicar el éxito o el fracaso de las solicitudes de API:​

Estructura de respuesta de error

Cuando se produce un error, Localpayment devuelve un objeto JSON con información detallada sobre el error:

Campos de respuesta de error


Referencia de códigos de estado internos

Aunque Localpayment utiliza códigos HTTP estándar para el estado a nivel de solicitud, los campos status.code y errors[].code proporcionan un estado detallado de la lógica de negocio y del procesamiento.

Escenarios de errores comunes

Errores de autenticación

SoluciónVerifica tus credenciales de API y asegúrate de que tu token de acceso sea válido. Si es necesario, utiliza el endpoint de actualización de token.

Errores de validación

SoluciónRevisa el arreglo errors para ver los problemas de validación de campos específicos. Consulta la documentación de la API para conocer los campos obligatorios y las especificaciones de formato.

Errores de lógica empresarial

SoluciónEstos errores requieren una solución a nivel empresarial. Verifica los saldos de las cuentas, los límites de transacciones o comunícate con el servicio de asistencia para conocer las restricciones específicas.

Buenas prácticas para el manejo de errores

Consejo profesionalImplementa el registro estructurado desde el primer día. Incluye identificadores de correlación, códigos de error e información de contexto para facilitar la depuración cuando surjan problemas en producción.

  1. Implementar un registro de eventos completo

  1. Mensajes de error fáciles de entender

Crea una correspondencia entre los códigos de error técnicos y los mensajes fáciles de usar:

  1. Mecanismo de reintento con retroceso exponencial

  1. Patrón de disyuntor

Implementa un interruptor automático para evitar fallas en cascada:

Próximos pasos

Referencia de la API

Lista completa de códigos de error con explicaciones detalladas.

Guía de pruebas

Aprende a probar escenarios de error en un entorno aislado (sandbox).

Contacto de soporte

Obtén ayuda con escenarios de error específicos.
Última modificación el 10 de noviembre de 2026