Aquesta pàgina descriu el maneig dels errors d’integració.
Si voleu personalitzar el maneig dels errors que ocorren quan rebutja una transacció, consulteu el següent article:
KR.onError ()
Com es mostren els errors?
En el formulari carregat, els errors es mostren automàticament en el div kr-form-error:
<!-- error zone --> <div class="kr-form-error"></div>
<!-- error zone --> <div class="kr-form-error"></div>
Només ha de afegir-ho.
Manejar els errors manualment
Per gestionar els errors manualment, només cal interceptar i personalitzar el missatge d’error predeterminat. En el següent exemple, el missatge d’error personalitzat es col·locarà al div de classe customerror:
<script type="text/javascript"> $(document).ready(function() { KR.onError( function(event) { var code = event.errorCode; var message = event.errorMessage; var myMessage = code + ": " + message; document.getElementsByClassName("customerror").innerText = myMessage; }); }); </script>
codis d’error JS
l’API REST té molts codis d’error, que d’descriuen aquí: codis d’error de l’API REST.
Els codis d’error amb el prefix CLIENT_ corresponen a errors que tenen lloc en el navegador del comprador. Es produeixen abans que les dades de pagament s’enviïn als nostres servidors. Inclouen, per exemple, errors de validació de les dades de formulari o errors d’integració de client de JavaScript.
| CODI | DEFINICIÓ |
|---|---|
| CLIENT_004 | Clau pública invàlida |
| CLIENT_100 | formToken invàlid |
| CLIENT_101 | Avortat |
| CLIENT_300 | Dades de formulari invàlids |
| CLIENT_301 | Número de targeta invàlid |
| CLIENT_302 | Data de caducitat invàlida |
| CLIENT_303 | Codi de seguretat invàlid |
| CLIENT_304 | El valor és obligatori |
| CLIENT_500 | Sense formulari o botó definit |
| CLIENT_501 | Kr-public-key està buida o no definida |
| CLIENT_502 | El formulari ja ha estat i nviado (No està suportada la navegació cap enrere) |
| CLIENT_997 | La configuració de endpoint no coincideix |
| CLIENT_998 | Formulari de demostració, veure la documentació |
| CLIENT_999 | Error de servidor |
codis d’advertència
Els codis d’error que van de CLIENT_700 a CLIENT_799 són advertiments. Serveixen d’ajuda per a la integració de client JavaScript:
| CODI | DEFINICIÓ |
|---|---|
| CLIENT_704 | necessita incloure Font Awesome en l’element & lt; head & gt; |
Detall dels codis d’error
CLIENT_004
| Codi | CLIENT_004 |
| Definició | Clau pública invàlida |
| Categoria | Errors |
La clau pública definida en kr-public-keyno és vàlida. Ha de tenir la la següent manera::
Per exemple: 69876357: testpublickey_DEMOPUBLICKEY95me92597fd28tGD4r5
Per a més informació, consulteu: Obtenir les meves claus.
CLIENT_100
| Codi | CLIENT_100 |
| Definició | formToken invàlid |
| Categoria | Errors |
El formToken definit per vostè en kr-form-token no és vàlid. Per obtenir més informació sobre com crear un formToken, consulteu: Guia d’integració.
CLIENT_101
| Codi | CLIENT_101 |
| Definició | Avortat |
| Categoria | Errors |
La transacció va ser abandonada pel comprador. Aquest error ocorre, per exemple, quan el comprador tanca el pop-in de 3D-Secure abans de l’autenticació.
Si el comprador no ho intenta una altra vegada, es crea automàticament una transacció rebutjada quan expira el formToken .
CLIENT_300
| Codi | CLIENT_300 |
| Definició | Dades de formulari invàlids |
| Categoria | Errors |
Quan diversos camps del formulari no són vàlids , es retorna un error general CLIENT_300. La llista detallada de tots els errors detectats estarà continguda en el camp children:
{ "errorCode": "CLIENT_300", "errorMessage": "Invalid form data", "children": , "detailedErrorCode": null, "detailedErrorMessage": null, (...)}
CLIENT_301
| Codi | CLIENT_301 |
| Definició | Número de targeta invàlid |
| Categoria | Errors |
el camp kr-pa (número de targeta) de l’formulari de pagament no és vàlid .
CLIENT_302
| codi | CLIENT_302 |
| Definició | Data de caducitat invàlida |
| Categoria | Errors |
El camp kr-expiry (data de venciment) de l’formulari de pagament no és vàlid.
CLIENT_303
| Codi | CLIENT_303 |
| Definició | Codi de seguretat invàlid |
| Categoria | Errors |
el camp kr-security-code (codi de seguretat o CVV) de l’formulari de pagament no és vàlid.
CLIENT_304
| Codi | CLIENT_304 |
| Definició | El valor és obligatori |
| Categoria | Errors |
Un camp addicional declarat com a obligatori està buit. Per a més informació, consulteu: Camps personalitzats de l’formulari.
CLIENT_500
| Codi | CLIENT_500 |
| Definició | Sense formulari o botó definit |
| Categoria | Errors |
No s’ha trobat cap botó de formulari de pagament en el codi HTML. Comproveu si existeixen les etiquetes necessàries o si hi ha algun error de sintaxi.
CLIENT_501
| Codi | CLIENT_501 |
| Definició | Kr-public-key està buida o no definida |
| Categoria | Errors |
La clau pública no està definida en kr-public-key.
CLIENT_502
| Codi | CLIENT_502 |
| Definició | El formulari ja ha estat enviat (No està suportada la navegació cap enrere) |
| Categoria | Errors |
l’aplicació ha detectat que el comprador va tornar a la pàgina de pagament amb el botó enrere del seu navegador. El formulari de pagament ha estat bloquejat.
Tingueu en compte que aquesta detecció només funciona en certs navegadors.
CLIENT_704
| Codi | CLIENT_704 |
| Definició | necessita incloure Font Awesome en l’element & lt; head & gt; |
| Categoria | Alertes |
Un camp addicional utilitza icones de Font Awesome, però la biblioteca no s’ha carregat. Per a més informació, aneu a: Camps personalitzats de l’formulari.
CLIENT_997
| Codi | CLIENT_997 |
| Definició | La configuració de endpoint no coincideix |
| Categoria | Errors |
el formToken es va crear en una plataforma diferent d’aquella en què es va descarregar el client JavaScript. La URL de crida a l’servei web REST ha de ser la mateixa que l’URL de el client de JavaScript.
CLIENT_998
| Codi | CLIENT_998 |
| Definició | Formulari de demostració, veure la documentació |
| Categoria | Errors |
El formulari de pagament utilitza 1 formToken de demostració que no permet la interacció amb el servidor. Utilitzeu un formToken vàlid: Charge / CreatePayment.
CLIENT_999
| Codi | CLIENT_999 |
| Definició | Error de servidor |
| Categoria | Errors |
error desconegut, poseu-vos en contacte amb el suport tècnic indicant la següent informació:
- Nombre de botiga,
- URL de l’formulari,
- Nom i versió de el navegador,
- Tipus i versió del sistema operatiu,
- Dispositiu utilitzat (iPhone 6S, PC, iPad Pro …)
- Data i hora de l’error .