# Códigos de Erro

O código de retorno é a resposta obtida de uma requisição de transação no Cartão de Crédito nos casos em que a transação não foi aprovada.

Para auxiliar nesse momento, listamos abaixo os códigos de retornos e qual ação tomar quando isso acontecer.

| **Cód de Erro Barte** | **Mensagem de Erro**                            | **CTA (Call to Action)**                                                                                             |
| --------------------- | ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| BAR-0436              | Pagamento bloqueado pelo fluxo de segurança     | Verifique as informações e tente novamente                                                                           |
| BAR-7001              | Este cartão não é aceito                        | Utilize um cartão de crédito ou outro cartão aceito                                                                  |
| BAR-7002              | Este cartão está expirado                       | Verifique a data de validade ou utilize outro cartão                                                                 |
| BAR-7003              | Este cartão foi recusado por fraude confirmada  | Entre em contato com seu banco para resolver a fraude                                                                |
| BAR-7004              | Este cartão foi recusado por suspeita de fraude | Entre em contato com seu banco para resolver a suspeita                                                              |
| BAR-7005              | Erro no Pagamento                               | Verifique os detalhes da transação e/ou contate a central do seu cartão                                              |
| BAR-7006              | Saldo Insuficiente                              | Verifique com seu banco emissor se há limite suficiente no cartão. Após, tente novamente                             |
| BAR-7007              | Valor Inválido                                  | Verifique se o valor da transação está correto, pois está abaixo do mínimo, ou acima do máximo permitido pelo cartão |
| BAR-7008              | CVV Inválido                                    | Verifique seu CVV, e tente novamente                                                                                 |
| BAR-7009              | Dados do Cartão Inválidos                       | Verifique os dados do seu cartão e tente novamente                                                                   |
| BAR-7010              | Parcelamento Inválido                           | Verifique se as parcelas que quer disponibilizar está no seu plano contratado com a Barte                            |
| BAR-7011              | Erro Pagamento                                  | Verifique os detalhes da transação e/ou contate a central do seu cartão                                              |
| BAR-7012              | Dados do Cartão Inválidos                       | Verifique os dados do seu cartão e tente novamente                                                                   |
| BAR-7013              | Dados do Cartão Inválidos                       | Verifique os dados do seu cartão e tente novamente                                                                   |
| BAR-7014              | Dados do Cartão Inválidos                       | Verifique os dados do seu cartão e tente novamente                                                                   |
| BAR-7015              | Cartão Perdido                                  | O banco acusou que este cartão foi perdido, contate a central do seu cartão. Não tente novamente                     |
| BAR-7016              | Transação não permitida para o cartão           | Verifique com seu banco emissor e tente novamente                                                                    |
| BAR-7017              | Transação não permitida para o cartão           | Verifique com seu banco emissor e tente novamente                                                                    |
| BAR-7018              | Dados do Cartão Inválidos                       | Verifique com seu banco emissor e tente novamente                                                                    |
| BAR-7019              | Cartão Bloqueado                                | Entre em contato com seu banco, desbloqueie o cartão e tente novamente                                               |
| BAR-7020              | Dados do Cartão Inválidos                       | Verifique os dados do seu cartão e tente novamente                                                                   |
| BAR-7021              | Serviço não permitido                           | Transação não permitida para o cartão. Verifique com seu banco emissor e tente novamente                             |
| BAR-7022              | Cartão Perdido                                  | O banco acusou que este cartão foi perdido, contate a central do seu cartão. Não tente novamente                     |
| BAR-7023              | Erro Pagamento                                  | Verifique os detalhes da transação e/ou contate a central do seu cartão                                              |
| BAR-7024              | Tente Novamente                                 | Aconteceu um erro inesperado com o cartão. Tente pagar novamente                                                     |
| BAR-7025              | Este cartão está bloqueado                      | Utilize outro cartão                                                                                                 |
| BAR-7026              | Tipo de chave PIX inválido                      | Corrija a chave PIX e tente novamente                                                                                |
| BAR-7027              | Cartão Cancelado / E-mail inválido              | Realize tentativa com outro cartão ou corrija o e-mail                                                               |
| BAR-7028              | Pagamento não confirmado / Documento inválido   | Verifique fatura/vendedor ou informe um CPF/CNPJ válido                                                              |
| BAR-7029              | O número de telefone deve ser válido            | Informe um número de telefone válido                                                                                 |
| BAR-7030              | A chave PIX fornecida já existe                 | Verifique a chave PIX e tente novamente                                                                              |
| BAR-7031              | Código de verificação da chave PIX inválido     | Forneça um código válido                                                                                             |
| BAR-7032              | Limite de chaves PIX excedido (20)              | Remova uma chave existente e tente novamente                                                                         |
| BAR-7033              | Formato de data inválido                        | Corrija a data e tente novamente                                                                                     |
| BAR-7034              | O valor não pode ser inferior a R$ 0,00         | Informe um valor válido                                                                                              |
| BAR-7035              | O tipo de pagador deve ser válido               | Informe um tipo de pagador válido                                                                                    |
| BAR-7036              | O documento do pagador deve ser CPF ou CNPJ     | Informe um CPF ou CNPJ válido                                                                                        |
| BAR-7037              | Nome do pagador inválido                        | Informe um nome válido                                                                                               |
| BAR-7038              | E-mail do pagador inválido                      | Informe um e-mail válido                                                                                             |
| BAR-7039              | Número de telefone do pagador inválido          | Informe um número de telefone válido                                                                                 |
| BAR-7040              | Chave PIX não encontrada                        | Verifique a chave PIX e tente novamente                                                                              |
| BAR-7041              | Não permitido enviar PIX para conta salário     | Verifique os dados e tente novamente                                                                                 |
| BAR-7042              | Data inválida                                   | Corrija a data e tente novamente                                                                                     |
| BAR-7043              | Chave já registrada                             | Aguarde o processo ser finalizado                                                                                    |
| BAR-7044              | Não é possível excluir chaves em processo       | Aguarde a finalização do processo                                                                                    |
| BAR-7045              | Status da chave não permite iniciar processo    | Verifique o status da chave e tente novamente                                                                        |
| BAR-7046              | Status da chave não permite cancelar processo   | Verifique o status e tente novamente                                                                                 |
| BAR-7047              | Status da chave não permite confirmar processo  | Verifique o status e tente novamente                                                                                 |
| BAR-7048              | Já existe um processo de reivindicação em curso | Aguarde a finalização do processo                                                                                    |
| BAR-7049              | Pix devolvido                                   | Verifique os dados e tente novamente                                                                                 |
| BAR-7050              | Falha no envio da transferência                 | Verifique os dados bancários e tente novamente                                                                       |
| BAR-7051              | Dados do QRCode duplicados                      | Verifique os dados e tente novamente                                                                                 |
| BAR-7052              | QRCode finalizado, não pode ser alterado        | Crie um novo QRCode e tente novamente                                                                                |
| BAR-7053              | Formato do documento inválido                   | Corrija o formato e tente novamente                                                                                  |
| BAR-7054              | Não é permitido criar divisões de valor fixo    | Verifique o parâmetro e tente novamente                                                                              |
| BAR-7055              | Valor das divisões excede o valor do QRCode     | Ajuste o valor das divisões e tente novamente                                                                        |
| BAR-7056              | Valor do QRCode inválido                        | Informe um valor válido e tente novamente                                                                            |
| BAR-7057              | Conflito entre campos de retirada e alteração   | Verifique os campos e tente novamente                                                                                |
| BAR-7058              | Descrição com caracteres inválidos              | Corrija os caracteres e tente novamente                                                                              |
| BAR-7059              | Status da chave não permite remoção             | Verifique o status e tente novamente                                                                                 |
| BAR-7060              | ID end2end expirado                             | Utilize um ID válido e tente novamente                                                                               |
| BAR-7061              | ID end2end duplicado                            | Verifique o ID e tente novamente                                                                                     |
| BAR-7062              | Pix bloqueado para reembolso                    | Aguarde a finalização do MED e tente novamente                                                                       |
| BAR-7063              | Formato de chave PIX inválido                   | Corrija o formato da chave e tente novamente                                                                         |
| BAR-7064              | Limite de chaves PIX atingido                   | Remova uma chave existente e tente novamente                                                                         |
| BAR-7065              | Tipo de chave PIX não permitido para esta conta | Verifique o tipo de chave e tente novamente                                                                          |
| BAR-7066              | Chave PIX divergente do CPF/CNPJ                | Verifique os dados e tente novamente                                                                                 |
| BAR-7067              | Limite de consultas no DICT excedido            | Aguarde e tente novamente                                                                                            |

A seguir, um exemplo de um erro retornado na API:

<pre class="language-json"><code class="lang-json">{
<strong>    "errors": [{
</strong>        "status": "400",
        "code": "BAR-7005",
        "title": "generic",
        "description": "Erro no pagamentoo",
        "action": "Verifique os detalhes da transação e/ou contate a central do seu cartão",
        "additionalInfo": {
            "chargeUUID": "8ef3900d-e7d2-45e0-8530-830f5657c9e4",
            "provider": "Barte"
        }
    }],
    "metadata": {
    "totalRecords": 1,
    "totalPages": 1,
    "requestDatetime": "2024-08-09T16:28:53.265693613-03:00[America/Sao_Paulo]"
    }
}
</code></pre>
