Saltar al contenido principal
Esta sección detalla los formatos de respuesta de la API, los códigos de estado HTTP y una referencia completa de todos los códigos de estado y error de las transacciones que utiliza la API de Localpayment. Dominar estos patrones y códigos de respuesta es fundamental para crear integraciones sólidas, realizar un seguimiento preciso del ciclo de vida de las transacciones, gestionar diversos escenarios y proporcionar información clara al usuario. Las respuestas de la API de Localpayment proporcionan indicadores claros del resultado de las solicitudes mediante códigos de estado HTTP y objetos de estado estructurados. Si bien las estructuras de respuesta pueden variar según el endpoint, siempre incluyen información clave para un procesamiento adecuado.

Códigos de estado HTTP

Códigos de estado HTTP estándar que indican si la solicitud fue exitosa o fallida.

Objetos de estado

Información detallada sobre el estado de los resultados de las transacciones.

Manejo claro de errores

Información de error estructurada para la depuración y resolución.

Códigos de estado HTTP

La API utiliza códigos de estado HTTP estándar para indicar el resultado de las solicitudes a nivel de protocolo. Estos códigos proporcionan la primera indicación de si la solicitud se realizó correctamente.

Códigos de éxito (2xx)

Errores del cliente (4xx)

Errores del servidor (5xx)


Objeto de estado

El objeto status proporciona información detallada y específica de Localpayment sobre los resultados de las transacciones y se incluye en la mayoría de las respuestas de la API relacionadas con operaciones financieras.

Estructura del objeto de estado

Campos del objeto de estado


Patrones de respuesta comunes

Respuesta de pago exitosa

Patrón de respuesta de error


Guía de estado y errores de las transacciones

Selecciona a continuación un tipo de transacción específico para obtener una lista detallada de sus estados y códigos de error.

Payin

Códigos de estado y de error para la recepción de fondos a través de cuentas virtuales, Columns cols= y APM.

Payout

Códigos de estado y de error para el envío de fondos a los beneficiarios.

Reembolso

Códigos de estado y de error para la devolución de fondos a un cliente.

Chargeback

Códigos de estado y de error para transacciones disputadas y reversiones forzadas.

Devolver

Códigos de estado y de error para pagos devueltos y liquidaciones fallidas.

Recall

Códigos de estado y de error para las cancelaciones y reversiones de pagos.

Crédito

Códigos de estado y de error para transacciones y ajustes de crédito.

Débito

Códigos de estado y de error para transacciones de débito y deducciones de fondos.

Suscripciones

Códigos de estado y de error para la facturación recurrente y los ciclos de vida de las suscripciones.

Cambio de divisas

Códigos de estado y de error para transacciones de cambio de divisas.

Wire In

Códigos de estado y de error para las transferencias bancarias entrantes.

Wire Out

Códigos de estado y de error para transferencias bancarias salientes.

Gastos

Códigos de estado y de error para deducciones de tarifas y transacciones de gastos.

Cuota recurrente

Códigos de estado y de error para los cargos periódicos.

Guía de webhooks

Aprende cómo recibir actualizaciones de estado en tiempo real.

Manejo de errores

Guía para gestionar transacciones fallidas

Soporte

Obtén ayuda con problemas de estado específicos.
Consejo profesionalImplementa un sistema de registro exhaustivo que capture tanto los códigos de estado como los códigos de error con marcas de tiempo. Esto crea registros de auditoría claros para cumplir con los requisitos y agiliza considerablemente la depuración de problemas. Incluye la respuesta de error completa en los registros, no solo el código de error.

Última modificación el 10 de noviembre de 2026