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()

¿Cómo se muestran los errores?

Para el formulario iJavaScript, 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>

Solo tiene que añadirlo.

Gestionar errores manualmente

Para gestionar los errores manualmente, debe personalizar el mensaje de error por defecto. En el siguiente ejemplo, el mensaje de error personalizado se indica en la div de clase customerror :

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

            try {
              /* if client answer exists, a refused transaction has been created */
              /* it's not always the case. For example, if the form is empty,    */
              /* error is raised before transaction creation                     */

Códigos de error JS

Aquí se describen los códigos de error de la API REST:

• ACQ
• AUTH
• INT
• PSP

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. Se trata, por ejemplo, de errores de validación de datos del formulario realizados localmente, o de errores de integración del cliente JavaScript.

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:

Detalle de los códigos de error

CLIENT_004

La clave pública definida en kr-public-key no es válida. Esta última debe tener la siguiente forma: [NÚMERO]:[CADENA]

Por ejemplo: 69876357:testpublickey_DEMOPUBLICKEY95me92597fd28tGD4r5

Para más información, consulte aquí: Recuperar mis claves.

CLIENT_100

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

CLIENT_101

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

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

CLIENT_300

Cuando más de un campo dentro del formulario no es válido, se devuelve un error general de CLIENT_300. La lista de todos los errores detectados estará incluida 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

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

CLIENT_302

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

CLIENT_303

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

CLIENT_304

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

CLIENT_305

El formToken no existe o no cumple con los requisitos. Para más detalles, consulte aquí: indefinido.

CLIENT_500

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

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

CLIENT_502

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_505

Le thèmematerialno es compatible con el formulariosmartForm.
Il fautimpérativementcambiar y elegir entre el temanéono el temaclassic. Ver :"Temas".

CLIENT_508

Debe disponer de un contrato de pago con tarjetas activo y asociado a su tienda.

CLIENT_704

Un campo adicional utiliza íconos de fuentes Awesome, pero la biblioteca no se carga. Para más información, consulte:: Campos del formulario personalizados.

CLIENT_705

La etiqueta "

CLIENT_997

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

CLIENT_998

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

Error desconocido, póngase en contacto con la asistencia técnica e indique la siguiente información:

• Identificador de la 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.