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:
¿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:
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ódigo | 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_505 | SmartForm not supported with the current theme |
| CLIENT_508 | Card payment is not available |
| 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 entre CLIENT_700 y CLIENT_799 son advertencias. Le ayudan a la hora de integrar el cliente JavaScript:
| Código | 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. 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
| 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 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 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
| Código | CLIENT_300 |
| DEFINICIÓN | Invalid form data |
| Categoría | Errors |
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
| Código | CLIENT_301 |
| DEFINICIÓN | Invalid card number |
| Categoría | Errors |
El campo kr-pan (número de tarjeta) del formulario de pago es invá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 del formulario personalizados.
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 : undefined.
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 un 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_505
| Código | CLIENT_505 |
| DEFINICIÓN | SmartForm not supported with the current theme |
| Categoría | Errors |
Le thèmematerialn'est pas supporté par le formulairesmartForm.
Il fautimpérativementchanger et choisir entre le thèmenéonou le thèmeclassic. Voir :"Temas".
CLIENT_508
| Código | CLIENT_508 |
| DEFINICIÓN | Card payment is not available |
| Categoría | Errors |
Debe disponer de un contrato de pago con tarjetas activo y asociado a su tienda.
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 fuentes Awesome, pero la biblioteca no se carga. Para más información, consulte:: Campos del formulario personalizados.
CLIENT_705
| Código | CLIENT_705 |
| DEFINICIÓN | viewport definition is missing ( |
| Categoría | Warnings |
La etiqueta "
", a través de la directiva "viewport", le indica al navegador cómo controlar las dimensiones y la escala de la página que se mostrará Se recomienda utilizarl 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 Web Service 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 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.