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 camposstatus.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.
- Implementar un registro de eventos completo
- 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:
- Mecanismo de reintento con retroceso exponencial
- 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.

