Skip to main content
Formato de error Pix Lerian responde un error en una de dos formas. El tipo de medio de la respuesta indica cuál forma recibiste. Una respuesta con el tipo de medio application/json lleva el envelope de code, title y message. Una respuesta con el tipo de medio application/problem+json lleva un problem detail de RFC 9457. Ambas formas llevan el campo code, así que puedes bifurcar la lógica según el valor PIX-NNNN. Un rechazo generado dentro de un handler usa la forma application/problem+json. Un rechazo generado antes de que el handler se ejecute usa la forma application/json. Una ruta sin coincidencia, un método no permitido, un timeout, una desconexión y la verificación de repetición de idempotencia rechazan todos antes de que el handler se ejecute.
Definiciones de campos El envelope application/json lleva tres campos:
  • code – Un identificador estable y único para el error (PIX-NNNN). Útil para el manejo programático y las solicitudes de soporte.
  • title – Un resumen breve y legible por humanos del problema.
  • message – Orientación detallada para ayudarte a resolver el error.
El envelope application/problem+json sigue el RFC 9457:
  • type – Un URI que identifica el error en el catálogo de errores de Lerian. Se construye como https://errors.lerian.studio/v1/<code>.
  • title – El texto del estado HTTP (por ejemplo, Not Found).
  • status – El código de estado HTTP.
  • detail – Una explicación legible por humanos de esta ocurrencia del problema. Usa code para bifurcar la lógica de forma programática.
  • code – El mismo identificador PIX-NNNN que lleva el envelope application/json.
  • errors – Lista opcional de detalles de validación por campo, cada uno con un message y una location.
  • instance – Referencia URI opcional que identifica esta ocurrencia específica.
Las tablas siguientes listan los códigos por dominio. La columna Status muestra el estado HTTP del código. La columna detail muestra el texto que lleva la forma application/problem+json. En el estado 500 y superiores, esa forma lleva el texto fijo internal error, y las tablas lo muestran en esas filas. PIX-0010 y PIX-0000 son códigos genéricos de reserva. En un rechazo generado antes de que el handler se ejecute, cualquiera de los dos puede llevar un estado distinto al de la tabla.

​
Errores comunes

DICT, las cobranzas y los pagos comparten estos códigos. Van de PIX-0000 a PIX-0061.

​
Errores de DICT y claves Pix

Estos códigos provienen de las entradas de claves Pix, la búsqueda de claves, las reclamaciones, los marcadores de fraude, las recuperaciones de fondos y la sincronización de claves. Van de PIX-0100 a PIX-0174.

​
Errores de cobranzas y BR Code

Estos códigos provienen de los BR Codes, las cobranzas inmediatas y las cobranzas con vencimiento. Van de PIX-0200 a PIX-0267.

​
Errores de pagos y devoluciones

Estos códigos provienen de las transferencias Pix, las devoluciones y su liquidación. Van de PIX-0300 a PIX-0706.