Gerenciar os erros (cliente JS)

Esta página apresenta o tratamento 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()

Como são exibidos os erros?

Para o formulário JavaScript, 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>

Basta adicioná-lo.

Gerenciar os erros manualmente

Para gerenciar manualmente os erros, basta interceptar a mensagem de erro default e personalizá-lo. No exemplo seguinte, a mensagem de erro personalizada será posicionada na 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;

            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 erro JS

A API REST tem vários códigos de erro, apresentados aqui:

• ACQ
• AUTH
• INT
• PSP

Os código de erro pré-fixados por CLIENT_ correspondem aos erros que ocorrem no navegador do comprador. Ocorrem antes do envio dos dados de pagamento para nossos servidores. Podem ser por exemplo erros de validação de dados do formulário realizados localmente, ou erros de integração do cliente JavaScript.

Códigos de advertência

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:

Detalhes dos códigos de erro

CLIENT_004

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

por exemplo: 69876357:testpublickey_DEMOPUBLICKEY95me92597fd28tGD4r5

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

CLIENT_100

O formToken que você definiu em kr-form-token é inválido. Para maiores informações sobre a criação de um formToken, consultar: Guia de integração.

CLIENT_101

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 realizar uma outra tentativa, uma transação recusada será automaticamente criada quando o formToken chegar ao vencimento.

CLIENT_300

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

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

CLIENT_302

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

CLIENT_303

O campo kr-security-code (número de segurança ou CVV) do formulário de pagamento está inválido.

CLIENT_304

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

CLIENT_305

O formToken não existe ou não é compatível. Para mais detalhes, acesse: undefined.

CLIENT_500

Nenhum botão de formulário de pagamento foi encontrado no código HTML. Verifique que os tags estejam presentes, ou se há um erro de sintaxe.

CLIENT_501

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

CLIENT_502

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.

Esta detecção opera apenas em certos navegadores.

CLIENT_505

Le thèmematerialnão é suportado pelo formuláriosmartForm.
Il fautimpérativementmudar e escolher entre o temanéonou o temaclassic. Ver :"Temas".

CLIENT_508

Tenha certeza de ter um contrato de pagamento por cartões ativo e associado a sua loja.

CLIENT_704

Um campo adicional usa ícones de fonte Awesome mas a biblioteca não foi instalada. Para maiores detalhes, consultar: Campos de formulário personalizados.

CLIENT_705

O tag <meta>, via a diretriz "viewport", indica ao navegador como controlar as dimensões e a escala da página a ser exibida Recomendamos usá-lo em todas as páginas HTML5.

CLIENT_997

O formToken foi criado em uma plataforma diferente da plataforma que o cliente usou para baixar JavaScript. A URL de chamada aos web service REST deve ser a mesma que o cliente JavaScript usa.

CLIENT_998

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

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.