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]"
    }
}