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 :
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 :
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 | clave pública no válida |
| CLIENT_100 | formToken no válido |
| CLIENT_101 | cancelado |
| CLIENT_300 | datos de formulario no válidos |
| CLIENT_301 | número de tarjeta no válido |
| CLIENT_302 | fecha de expiración no válida |
| CLIENT_303 | código de seguridad no válido |
| CLIENT_304 | El valor es obligatorio |
| CLIENT_305 | no formToken definido |
| 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 | la configuración de endpoint no coincide |
| CLIENT_998 | formToken no definido |
| CLIENT_999 | error técnico |
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 | necesita incluir Font Awesome en el elemento |
| CLIENT_705 | viewport no definido ( |
Detalle de los códigos de error
CLIENT_004
| Código | CLIENT_004 |
| DEFINICIÓN | clave pública no válida |
| Categoría | Errores |
La clave pública definida en kr-public-key no es válida. Esta última debe tener la siguiente forma: [NÚMERO]:[CADENA]
par exemple : 89289758:testpublickey_TxzPjl9xKlhM0a6tfSVNilcLTOUZ0ndsTogGTByPUATcE
Para más información, consulte aquí: Recuperar mis claves.
CLIENT_100
| Código | CLIENT_100 |
| DEFINICIÓN | formToken no válido |
| Categoría | Errores |
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 | cancelado |
| Categoría | Errores |
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 | datos de formulario no válidos |
| Categoría | Errores |
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 | número de tarjeta no válido |
| Categoría | Errores |
El campo kr-pan (número de tarjeta) del formulario de pago es inválido.
CLIENT_302
| Código | CLIENT_302 |
| DEFINICIÓN | fecha de expiración no válida |
| Categoría | Errores |
El campo kr-expiry (fecha de vencimiento) del formulario de pago no es válido.
CLIENT_303
| Código | CLIENT_303 |
| DEFINICIÓN | código de seguridad no válido |
| Categoría | Errores |
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 | El valor es obligatorio |
| Categoría | Errores |
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 definido |
| Categoría | Errores |
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 | Errores |
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 | Errores |
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 | Errores |
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 | Errores |
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 | Errores |
Debe disponer de un contrato de pago con tarjetas activo y asociado a su tienda.
CLIENT_704
| Código | CLIENT_704 |
| DEFINICIÓN | necesita incluir Font Awesome en el elemento |
| Categoría | Advertencias |
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 no definido ( |
| Categoría | Advertencias |
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 | la configuración de endpoint no coincide |
| Categoría | Errores |
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 | formToken no definido |
| Categoría | Errores |
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 | error técnico |
| Categoría | Errores |
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.