Como configurar a integração com o Itaú (Bolecode) na Uappi?

O que é a Integração com o Itaú (Bolecode)?

O Itaú (Bolecode) é um gateway de pagamento integrado à Uappi, permitindo o recebimento via BoletoPix. A integração oferece funcionalidades como consulta e transação para facilitar a gestão dos pagamentos.

Passo a Passo

1. Obtenha suas Credenciais do Itaú

Para configurar o Itaú (Bolecode) na Uappi, você precisa criar uma conta e obter suas credenciais. Veja como:

• Cadastre-se no site do Itaú para Desenvolvedores.
• Para obter suas chaves de API de produção, entre em contato com um especialista do Itaú.
• Explique sua necessidade e solicite as credenciais para configurar sua loja na Uappi.
• Após a aprovação, você receberá seu Client ID, Client Secret, certificado dinâmico e outras credenciais essenciais.
• Caso precise de mais detalhes, consulte a documentação da API Itaú.

2. Configure o Gateway de Pagamento na Uappi

Após obter suas credenciais, siga os passos abaixo para configurar o Itaú (Bolecode) na Uappi:

1. Acesse Configurações > Pagamento > Gerenciamento.
2. Selecione a opção de edição do Itaú (Bolecode).

Na tela de configuração, preencha os seguintes campos:

✅ Homologação: ativa o ambiente de testes para simular transações sem impacto real.
✅ Client ID e Client Secret (APIs Exclusivas Itaú Pix Recebimentos): fornecidos pelo Itaú para autenticação na API de recebimentos via Pix.
✅ Informações bancárias (Chave Pix, Agência, Número da Conta e DAC): dados necessários para processar pagamentos.
✅ Código de carteira do Itaú: define o código da carteira utilizada, podendo ser 109 ou 175 para pagamento via BoletoPix.
✅ Certificado dinâmico e Chave privada: arquivos necessários para a comunicação segura com o Itaú.
✅ Client ID e Client Secret (API Emissão, Instrução e Consulta de Boletos): credenciais específicas para emissão e consulta de boletos.
✅ Alterar status do pedido quando a transação for cancelada: ajusta automaticamente o status do pedido em caso de cancelamento.
✅ Descrição na fatura do cartão: define como a compra aparecerá na fatura do cliente.
✅ Observação do pagamento: insira uma mensagem que será exibida no detalhe do pagamento.
✅ Utilizar o ID do pedido como referência no campo Nosso Número para envio: define se o ID do pedido será usado como referência no campo Nosso Número ao enviar ao cliente final.

Após preencher todos os campos, clique em Salvar para concluir a configuração.

Dicas Úteis

• Teste antes de ativar em produção! Utilize o ambiente de homologação para garantir que as transações ocorrem corretamente.
• Confirme com o Itaú quais carteiras estão disponíveis para seu tipo de operação.
• Consulte o suporte do Itaú caso tenha dúvidas ao obter suas credenciais.
• Revise as informações preenchidas para evitar erros nas transações.

Dúvidas Comuns

• Preciso ter uma conta no Itaú para configurar o gateway na Uappi?
  Sim, é necessário criar uma conta e obter as credenciais diretamente com o Itaú.
• O que acontece se a transação for cancelada?
  Se a opção “Alterar status do pedido quando a transação for cancelada” estiver ativada, o status do pedido será atualizado automaticamente na Uappi.
• Consigo testar pagamentos antes de ativar para os clientes?
  Sim! O ambiente de Homologação permite simular transações sem impactar pedidos reais.
• Como funciona o uso do ID do pedido no campo “Nosso Número”?
  Se ativado, o ID do pedido será usado como referência no campo “Nosso Número”, facilitando o rastreamento do pagamento.

Precisa de mais ajuda?

Acesse nossa base de conhecimento na Central de Ajuda para mais conteúdos sobre a Uappi.