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:
- Acesse Configurações > Pagamento > Gerenciamento.
- 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.