Códigos de error

Un código de error tiene la forma [PREFIJO]_[CÓDIGO], donde:

Existen distintos prefijos:

Los errores se envían a través de 4 parámetros:

{
  "errorCode": "INT_015",
  "errorMessage": "invalid customer email",
  "detailedErrorCode": null,
  "detailedErrorMessage": "Invalid input value [name=customer.email, value=fake-email]"
}

Podrán añadirse nuevos códigos de error en el futuro. Es obligatorio que su implementación lo tenga en cuenta.

Esos errores se producen en el adquiriente del comerciante (banco).

El código de rechazo de autorización del adquiriente se envía en detailedErrorCode. Esos códigos se envían sin modificación. Son específicos para cada adquiriente.

Por ejemplo, si una tarjeta VISA es rechazada por robo, la estructura de error será:

{
  "errorCode": "ACQ_001",
  "errorMessage": "payment refused",
  "detailedErrorCode": "43",
  "detailedErrorMessage": "Stolen card"
}

Los códigos de errores detallados (detailedErrorCode) más frecuentes son:

Los errores AUTH (de “autentificación”) generalmente se deben a un problema en los servidores de autentificación (en 3D-Secure por ejemplo).

Esos errores se producen en el navegador del comprador. Se producen antes de que los datos de pago se envíen a nuestros servidores. Se trata, por ejemplo, de errores de validación de datos del formulario realizados localmente, o de errores de integración del cliente JavaScript.

Consultar más información en la documentación del cliente JavaScript

Los errores INT (de “integración”) se deben generalmente a un problema de integración del comerciante.

Los errores PSP (Payment Service Provider) se producen cuando el PSP no puede tratar la petición.