• Francia
lyra.com
Buscar
Categoria
Tags
España
Francia
España
Europa (Inglés)
India
Implementación
Formulario incrustado (tarjetas)
API REST
API REST PCI-DSS
API REST SEPA
Formulario en redirección
Formulario de recolección de datos
Intercambio de ficheros
Pago móvil
Módulos de pago
Guías
Back office Experto
Ayuda
FAQ
Video tutorials
Contacte el soporte tecnico

Manejo de 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?

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

https://github.com/lyra/rest-php-examples/blob/master/www/minimalEmbeddedForm.php#L81-L82
    <!-- error zone -->
    <div class="kr-form-error"></div>
    <!-- error zone -->
    <div class="kr-form-error"></div>

Solo tiene que añadirlo.

Manejar los errores manualmente

Para gestionar los errores manualmente, basta con interceptar y personalizar el mensaje de error predeterminado. En el siguiente ejemplo, el mensaje de error personalizado se colocará en el div de clase customerror:

https://github.com/lyra/rest-php-examples/blob/master/www/js_examples/jquery/minimalEmbeddedForm.onError.php#L70-L80
          <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

La API REST tiene códigos de error descritos aquí:

  • ACQ
  • AUTH
  • INT
  • PSP

Los códigos de error con el prefijo CLIENT_ corresponden a 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 los datos de formulario o errores de integración del cliente de JavaScript.

CODE DEFINICIÓN
CLIENT_004 Invalid public key
CLIENT_100 Invalid formToken
CLIENT_101 Aborted
CLIENT_300 Invalid form data
CLIENT_301 Invalid card number
CLIENT_302 Invalid expiry date
CLIENT_303 Invalid security code
CLIENT_304 value is required
CLIENT_305 No formToken defined
CLIENT_500 No form or button defined
CLIENT_501 Kr-public-key is empty or not defined
CLIENT_502 Form already submitted (browser back button not supported)
CLIENT_997 Endpoint configuration mismatch
CLIENT_998 The used FormToken is for demo purposes only, payment is disabled. Check the documentation to get a real formToken.
CLIENT_999 Technical error

Códigos de advertencia

Los códigos de error que van de CLIENT_700 a CLIENT_799 son advertencias. Sirven de ayuda para la integración del cliente JavaScript:

CODE DEFINICIÓN
CLIENT_704 you need to load Font Awesome in your
CLIENT_705 viewport definition is missing ( )

Detalle de los códigos de error

CLIENT_004

Código CLIENT_004
Definición Invalid public key
Categoría Errors

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

Por ejemplo: 69876357:testpublickey_DEMOPUBLICKEY95me92597fd28tGD4r5

Para más información, consulte: Obtener mis claves.

CLIENT_100

Código CLIENT_100
Definición Invalid formToken
Categoría Errors

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, consulte: Guía de integración.

CLIENT_101

Código CLIENT_101
Definición Aborted
Categoría Errors

La transacción fue abandonada por el comprador. Este error ocurre, por ejemplo, cuando el comprador cierra el pop-in de 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_300

Código CLIENT_300
Definición Invalid form data
Categoría Errors

Cuando varios campos del formulario no son válidos, se devuelve un error general CLIENT_300. La lista detallada de todos los errores detectados estará contenida 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 Invalid card number
Categoría Errors

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

CLIENT_302

Código CLIENT_302
Definición Invalid expiry date
Categoría Errors

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

CLIENT_303

Código CLIENT_303
Definición Invalid security code
Categoría Errors

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 value is required
Categoría Errors

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

CLIENT_305

Código CLIENT_305
Definición No formToken defined
Categoría Errors

Le formToken n'existe pas ou n'est pas conforme. Pour plus de détails, rendez-vous ici : Créer un formToken.

CLIENT_500

Código CLIENT_500
Definición No form or button defined
Categoría Errors

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 algún error de sintaxis.

CLIENT_501

Código CLIENT_501
Definición Kr-public-key is empty or not defined
Categoría Errors

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

CLIENT_502

Código CLIENT_502
Definición Form already submitted (browser back button not supported)
Categoría Errors

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 you need to load Font Awesome in your
Categoría Warnings

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

CLIENT_705

Código CLIENT_705
Definición viewport definition is missing ( )
Categoría Warnings

La etiqueta <meta>, a través de la directiva "viewport", le dice al navegador cómo controlar las dimensiones y la escala de la página que se mostrará. Se recomienda usarlo en todas las páginas HTML5.

CLIENT_997

Código CLIENT_997
Definición Endpoint configuration mismatch
Categoría Errors

El formToken se creó en una 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 The used FormToken is for demo purposes only, payment is disabled. Check the documentation to get a real formToken.
Categoría Errors

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 Technical error
Categoría Errors

Error desconocido, póngase en contacto con el soporte técnico indicando la siguiente información:

  • 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.
Contratación

Head Office :

LYRA NETWORK
109, rue de l’innovation
31670 Labège
FRANCE

2.8.1-doc-1.8