# 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:
{
"errors": [{
"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]"
}
}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.barte.com/guias/inicio/codigos-de-erro.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.