Gerenciar erros (cliente JS)

Esta página descreve o processamento dos erros de integração.

Se você desejar personalizar o gerenciamento dos erros que ocorrem quando uma transação for recusada, favor consultar o artigo seguinte:

KR.onError()

Gerenciar erros manualmente

No caso do formulário incorporado, os erros são automaticamente exibidos na div kr-form-error:

    <!-- error zone -->
    <div class="kr-form-error"></div>
    <!-- error zone -->
    <div class="kr-form-error"></div>

Para gerenciar os erros manualmente:

  <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")[0].innerText = myMessage;
          });
    });
  </script>

Códigos de erro JS

A API REST tem vários códigos de erro, apresentados aqui: Código de erros da API REST.

Os códigos de erro com o prefixo CLIENT_ correspondem aos erros gerados no navegador do comprador. Eles ocorrem antes do envio dos dados de pagamento para nossos servidores. Isso inclui, por exemplo, erros de validação de dados do formulário realizados localmente ou erros de integração do cliente JavaScript.

CÓDIGO DEFINITION
CLIENT_004  
CLIENT_100  
CLIENT_101  
CLIENT_300  
CLIENT_301  
CLIENT_302  
CLIENT_303  
CLIENT_304  
CLIENT_500  
CLIENT_501  
CLIENT_502  
CLIENT_997  
CLIENT_998  
CLIENT_999  

Códigos de aviso

Os códigos de erro que constam entre CLIENT_700 e CLIENT_799 são advertências. São úteis para a integração do cliente JavaScript:

CÓDIGO DEFINITION
CLIENT_704  

Detalhes dos códigos de erro

CLIENT_004

Código CLIENT_004
Definição  
Categoria  

A chave pública definida em kr-public-key não está válida, deve ter a forma: [NÚMERO]:[STRING]

par exemple : 28478261:testpublickey_LHvSiWObWJnSBv6lnBMmS0tlDPLslOFYXvmKguoWiBIWj

Para maiores informações, consultar: Recuperar minhas chaves.

CLIENT_100

Código CLIENT_100
Definição  
Categoria  

O formToken definido em kr-form-token é inválido. Para mais informações sobre a criação de um formToken, consulte: guia de integração.

CLIENT_101

Código CLIENT_101
Definição  
Categoria  

A transação foi abandonada pelo comprador. Este erro ocorre, por exemplo, quando o comprador fecha o pop-in 3D-Secure antes de autenticar-se.

Se o comprador não fizer outra tentativa, uma transação recusada será automaticamente criada assim que o formToken expirar.

CLIENT_300

Código CLIENT_300
Definição  
Categoria  

Se mais de um campo do formulário estiver inválido, um erro geral CLIENT_300 será retornado. A lista detalhada de todos os erros detectados constará no 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
Definição  
Categoria  

O campo kr-pan (número do cartão) do formulário de pagamento é inválido.

CLIENT_302

Código CLIENT_302
Definição  
Categoria  

O campo kr-expiry (data de vencimento) do formulário de pagamento é inválido.

CLIENT_303

Código CLIENT_303
Definição  
Categoria  

O campo kr-security-code (código de segurança ou CVV) do formulário de pagamento é inválido.

CLIENT_304

Código CLIENT_304
Definição  
Categoria  

Um campo adicional declarado obrigatório está vazio. Para maiores detalhes, consultar: Campos de formulário personalizados

CLIENT_500

Código CLIENT_500
Definição  
Categoria  

Nenhum botão de formulário de pagamento foi encontrado no código de HTML. Verifique se as tags necessárias estão presentes ou se existe algum erro de sintaxe.

CLIENT_501

Código CLIENT_501
Definição  
Categoria  

A chave pública não foi definida em kr-public-key.

CLIENT_502

Código CLIENT_502
Definição  
Categoria  

A aplicação detectou que o comprador voltou na página de pagamento usando o botão para voltar, no seu navegador internet. O formulário de pagamento foi bloqueado.

Essa detecção não é compatível com todos os navegadores.

CLIENT_704

Código CLIENT_704
Definição  
Categoria  

Um campo adicional utiliza ícones de fonte Awesome, mas a biblioteca não foi carregada. Para mais detalhes, consulte: Campos personalizados de formulário.

CLIENT_997

Código CLIENT_997
Definição  
Categoria  

O formToken foi criado em uma plataforma diferente daquela em que o cliente JavaScript foi baixado. O URL de chamada ao Web service REST precisa ser igual ao do cliente JavaScript.

CLIENT_998

Código CLIENT_998
Definição  
Categoria  

O formulário de pagamento usa um formToken de exemplo que não permite interagir com o servidor. Use um formToken válido: Charge/CreatePayment.

CLIENT_999

Código CLIENT_999
Definição  
Categoria  

Erro desconhecido, favor entrar em contato com o suporte com as informações seguintes:

  • Número de loja,
  • URL do formulário,
  • Nome e versão do navegador,
  • Tipo e versão do sistema operacional,
  • Dispositivo utilizado (Iphone 6S, PC, Ipad Pro…),
  • Data e hora do erro.