Gestionar errores (cliente JS)

Esta página describe el manejo de los errores de integración.

Si desea personalizar el manejo de los errores que ocurren cuando rechaza una transacción, consulte el siguiente artículo:

KR.onError()

Gestionar errores manualmente

Para el formulario cargado, los errores se muestran automáticamente en el div kr-form-error:

    <!-- error zone -->
    <div class="kr-form-error"></div>
    <!-- error zone -->
    <div class="kr-form-error"></div>

Para manejar los errores manualmente:

  <script type="text/javascript">
    $(document).ready(function() {
          KR.onError( function(event) {
            var code = event.errorCode;
            var message = event.errorMessage;
            var myMessage = code + ": " + message;

            $("#customerror").html(myMessage);
          });
    });
  </script>

Códigos de error JS

La API REST tiene muchos códigos de error descritos aquí: Códigos de error de la API REST.

Los códigos de error con el prefijo de CLIENT_ corresponden a aquellos errores que ocurren en el navegador del comprador. Se producen antes de que los datos de pago se envíen a nuestros servidores. Incluyen, por ejemplo, errores de validación de datos de formulario revisados localmente o errores de integración de cliente de JavaScript.

CÓDIGO DEFINICIÓN
CLIENT_004  
CLIENT_100  
CLIENT_101  
CLIENT_300  
CLIENT_301  
CLIENT_302  
CLIENT_303  
CLIENT_304  
CLIENT_500  
CLIENT_501  
CLIENT_502  
CLIENT_997  
CLIENT_998  
CLIENT_999  

Códigos de advertencia

Los códigos de error entre CLIENT_700 y CLIENT_799 son advertencias. Le ayudan a la hora de integrar el cliente JavaScript:

CÓDIGO DEFINICIÓN
CLIENT_704  

Detalle de los códigos de error

CLIENT_004

Código CLIENT_004
Definición  
Categoría  

La clave pública definida en kr-public-key no es válida. Debe configurarse de la siguiente forma: [NÚMERO]:[CADENA]

par exemple: 28478261:testpublickey_LHvSiWObWJnSBv6lnBMmS0tlDPLslOFYXvmKguoWiBIWj

Para más información, vaya a: Recuperar mis claves.

CLIENT_100

Código CLIENT_100
Definición  
Categoría  

El formToken definido por usted en kr-form-token no es válido. Para obtener más información sobre cómo crear un formToken, vaya a: Guía de integración.

CLIENT_101

Código CLIENT_101
Definición  
Categoría  

La transacción fue abandonada por el comprador. Este error ocurre, por ejemplo, cuando el comprador cierra el popIn 3D-Secure antes de la autenticación.

Si el comprador no lo intenta otra vez, se crea automáticamente una transacción rechazada, cuando expira el formToken.

CLIENT_200

Código CLIENT_200
Definición  
Categoría  

No se ha encontrado ningún botón o formulario de pago en el código HTML. Compruebe si existen las etiquetas necesarias o si hay un error de sintaxis.

CLIENT_300

Código CLIENT_300
Definición  
Categoría  

Cuando haya más de un campo de formulario no válido, se genera un error general de CLIENT_300. La lista detallada de todos los errores detectados se incluirá en el campo children:

{
    "errorCode": "CLIENT_300",
    "errorMessage": "Invalid form data",
    "children": [{
        "errorCode": "CLIENT_301",
        "errorMessage": "Invalid card number",
        "field": "pan",
        (...)
    }, {
        "errorCode": "CLIENT_302",
        "errorMessage": "Invalid expiry date",
        "field": "expiryDate",
        (...)
    }, {
        "errorCode": "CLIENT_303",
        "errorMessage": "Invalid security code",
        "field": "securityCode",
        (...)
    }],
    "detailedErrorCode": null,
    "detailedErrorMessage": null,
    (...)
}

CLIENT_301

Código CLIENT_301
Definición  
Categoría  

El campo kr-pan (número de tarjeta) del formulario de pago no es válido.

CLIENT_302

Código CLIENT_302
Definición  
Categoría  

El campo kr-expiry (fecha de vencimiento) del formulario de pago no es válido.

CLIENT_302

Código CLIENT_302
Definición  
Categoría  

El campo kr-security-code (código de seguridad o CVV) del formulario de pago no es válido.

CLIENT_304

Código CLIENT_304
Definición  
Categoría  

Un campo adicional declarado como obligatorio está vacío. Para más información, vaya a: Campos de formulario personalizados.

CLIENT_500

Código CLIENT_500
Definición  
Categoría  

No se ha encontrado ningún botón de formulario de pago en el código HTML. Compruebe si existen las etiquetas necesarias o si hay un error de sintaxis.

CLIENT_501

Código CLIENT_501
Definición  
Categoría  

La clave pública no está definida en kr-public-key.

CLIENT_502

Código CLIENT_502
Definición  
Categoría  

La aplicación ha detectado que el comprador regresó a la página de pago con el botón atrás de su navegador. El formulario de pago ha sido bloqueado.

Tenga en cuenta que esta detección solo funciona en ciertos navegadores.

CLIENT_704

Código CLIENT_704
Definición  
Categoría  

Un campo adicional utiliza iconos de fuentes Awesome, pero la biblioteca no se ha cargado. Para más información, vaya a: Campos de formulario personalizados.

CLIENT_997

Código CLIENT_997
Definición  
Categoría  

El formToken se creó en otra plataforma distinta de aquella en la que se descargó el cliente JavaScript. La URL de llamada al servicio web REST debe ser la misma que la URL del cliente de JavaScript.

CLIENT_998

Código CLIENT_998
Definición  
Categoría  

El formulario de pago utiliza un formToken de demostración que no permite la interacción con el servidor. Utilice un formToken válido: Charge/CreatePayment.

CLIENT_999

Código CLIENT_999
Definición  
Categoría  

Error desconocido, póngase en contacto con soporte técnico e indíqueles la información siguiente:

  • Número de tienda,
  • URL del formulario,
  • Nombre y versión del navegador,
  • Tipo y versión del sistema operativo,
  • Dispositivo utilizado (iPhone 6S, PC, iPad Pro ...)
  • Fecha y hora del error.