Pix Itaú: receber o Pix do app, do PDV e da IA direto na conta PJ do Itaú da pizzaria
O cartão Pix Itaú, na guia Integrações Pagamentos, liga a conta PJ do Itaú da pizzaria ao Aliv Hub. O Pix do app, do totem, do garçom, do motoboy, do PDV e da IA do WhatsApp cai direto no Itaú e o pedido vai sozinho para a cozinha quando o cliente paga.
O cartão Pix Itaú, na guia Integrações Pagamentos das Configurações da loja, liga a conta PJ do Itaú da pizzaria ao Aliv Hub. Com ele conectado, o Pix do app de delivery, do totem, do garçom, do motoboy, do PDV e da IA do WhatsApp cai direto na conta do Itaú. Quando o cliente paga, o pedido é confirmado sozinho e vai para a cozinha, do mesmo jeito que acontece com o Mercado Pago.
Por que receber o Pix pelo Itaú
Muita pizzaria já tem a conta da empresa no Itaú e prefere que o dinheiro do Pix entre direto no banco onde paga fornecedor, funcionário e imposto, sem passar por outra conta antes. Com o Pix Itaú, o QR Code que o cliente recebe é da conta da própria pizzaria, e o valor aparece no extrato do Itaú no mesmo dia.
A confirmação continua automática: o sistema consulta o Itaú e, quando o Pix cai, marca o pedido como pago, imprime a comanda, baixa o estoque e avisa o cliente no WhatsApp. A equipe não precisa conferir comprovante. Isso é o que diferencia o Pix Itaú da chave Pix da loja cadastrada em Pagamentos Manuais: pela chave, o cliente paga direto na conta, mas ninguém vê o dinheiro cair e a equipe confere pelo comprovante.
Antes de começar: liberar a API Pix no Itaú
A API Pix não vem ligada na conta PJ. Ela é liberada pelo Itaú, conta por conta, e esse passo é feito uma vez só:
- Fale com o gerente da sua conta PJ (ou com o atendimento empresarial do Itaú, no WhatsApp Itaú Empresas, opção Contratar produtos) e peça a contratação da API Pix, que no Itaú se chama Recebimentos Pix, com o webhook de Pix recebidos. Diga que é para receber Pix com QR Code pelo sistema da pizzaria. Os escopos que o sistema usa são cob.write, cob.read, pix.read, webhook.read e webhook.write.
- Peça que as credenciais sejam enviadas para um e-mail que você acessa. O Itaú manda o client ID e um token temporário por e-mail, em até 1 dia útil depois da liberação.
- Guarde o e-mail. O token temporário vale 7 dias e só pode ser usado uma vez: conecte no Aliv Hub dentro desse prazo.
💡 O Aliv Hub não precisa de cadastro no Itaú. Cada pizzaria usa as credenciais da própria conta. O sistema nunca pede a senha do seu internet banking.
O que aparece no cartão Pix Itaú
- O selo Conectado, Conectado (teste) ou Não Conectado.
- A escolha da Conta: Conta real (produção), a que recebe dinheiro de verdade, ou Teste (sandbox), o ambiente de testes do Itaú.
- Os campos Client ID, Token temporário (e-mail do Itaú) e Chave Pix da conta Itaú que vai receber, e os botões Gerar certificado e Testar e salvar.
- Com a conta conectada: a chave Pix que recebe, a data até quando o certificado vale e os botões Alterar e Desconectar.
Passo a passo: conectar a conta do Itaú
- Abra Configurações, guia Integrações Pagamentos, e vá até o cartão Pix Itaú.
- Em Conta, deixe marcado Conta real (produção).
- Cole o Client ID do e-mail do Itaú no campo Client ID.
- Cole o token do e-mail no campo Token temporário (e-mail do Itaú).
- Clique em Gerar certificado. O sistema cria o certificado de segurança, envia ao Itaú e recebe o client secret sozinho. Ao terminar, aparece Certificado pronto com a data de validade.
- No campo Chave Pix da conta Itaú que vai receber, digite a chave Pix cadastrada nessa conta (CNPJ, e-mail, celular ou chave aleatória).
- Clique em Testar e salvar. O sistema faz um teste no Itaú antes de gravar: se o Itaú aceitar, o selo muda para Conectado e aparece o aviso de que o Pix da loja agora sai pelo Itaú.
⚠️ A chave Pix tem que ser da mesma conta do Itaú que foi liberada na API. Chave de outra conta ou de outro banco faz o Itaú recusar o teste.
Depois de conectar, faça um pedido pequeno pelo app e pague o Pix. Em poucos segundos o pedido aparece como pago e vai para a cozinha, e o valor entra no extrato do Itaú.
Um banco de Pix por vez: Itaú ou Mercado Pago
A loja usa um banco de Pix por vez. Se o Mercado Pago estiver conectado, o cartão Pix Itaú avisa antes de salvar que o Mercado Pago será desconectado. Ao clicar em Testar e salvar, o Pix passa a sair pelo Itaú e o cartão do Mercado Pago muda para Não Conectado. O contrário também vale: clicar em Conectar Minha Conta no Mercado Pago com o Itaú ligado pede a confirmação Trocar o Itaú pelo Mercado Pago? e desliga o Itaú.
Na troca, nenhum pagamento se perde. Os Pix que o banco anterior já tinha gerado continuam sendo conferidos: se o cliente pagar um QR do Mercado Pago gerado minutos antes da troca, o pedido é confirmado normalmente.
Onde o Pix Itaú funciona
- App de delivery e totem: o botão Pagar agora com PIX gera o QR do Itaú e o pedido vai para a cozinha quando o cliente paga.
- PDV: o botão Gerar PIX mostra o QR do Itaú, que pode ser impresso ou enviado no WhatsApp do cliente.
- App do motoboy: o botão Cobrar PIX gera o QR na porta do cliente, inclusive com valor parcial.
- IA do WhatsApp: com o PIX automático no WhatsApp ligado na guia Inteligência Artificial, a IA manda o QR do Itaú e o pedido é confirmado quando o Pix cai.
- Pedido cancelado: se o pedido é cancelado antes do pagamento, a cobrança é cancelada no Itaú e o cliente não consegue mais pagar. Se ele já tinha pago, o sistema avisa a equipe para devolver o valor.
O QR Code do Itaú vale 1 hora. Pedido que fica esperando pagamento além disso é tratado como Pix abandonado, igual ao do Mercado Pago.
Aviso de pagamento na hora (webhook)
Ao salvar a conta real, o Aliv Hub cadastra no Itaú o aviso de pagamento (webhook): quando o Pix cai, o Itaú avisa o sistema e o pedido é confirmado em segundos. O cartão mostra Aviso de pagamento (webhook) cadastrado no Itaú. Se o cadastro não der certo, aparece o motivo e o botão Cadastrar aviso de pagamento para tentar de novo. Mesmo sem o aviso, nenhum pagamento se perde: o sistema confere os Pix em aberto no Itaú a cada 30 segundos. Para o aviso funcionar, a API liberada pelo Itaú precisa incluir o webhook de Pix recebidos: peça isso ao gerente junto com a API Pix.
Certificado de segurança: renovação automática
O Itaú exige um certificado de segurança para a conta conversar com o sistema. Ele vale 1 ano e o cartão mostra a data em Certificado do Itaú vale até. O Aliv Hub renova o certificado sozinho nos 30 dias antes de vencer, sem precisar de token novo. Se a renovação falhar, o cartão mostra o aviso em vermelho e o sistema tenta de novo a cada 6 horas. Se o aviso continuar, chame o suporte do Aliv Hub antes do vencimento.
Modo de teste (sandbox)
A opção Teste (sandbox) usa o ambiente de testes do Itaú, com o client ID e o client secret criados no portal Itaú for Developers. Serve para ver o cartão e o fluxo funcionando antes de ter a conta liberada. No sandbox o QR não é pagável e o Itaú de teste nunca confirma pagamento; por isso aparece o campo Nº do pedido com o botão Simular pagamento, que marca o Pix daquele pedido como pago para você ver a baixa acontecer. Para receber de verdade, volte para Conta real (produção).
Desconectar o Itaú
O botão Desconectar abre a confirmação Desconectar o Itaú?. Pedidos já pagos continuam normais, e o Pix volta para o Mercado Pago se ele estiver conectado. Desconectar apaga o certificado: para conectar a conta real de novo, será preciso pedir outro token temporário ao Itaú.
Quando algo dá errado
- O Itaú não aceitou (login): o client ID ou o segredo não confere. Confira se copiou o client ID inteiro, sem espaço no começo ou no fim.
- Erro ao gerar o certificado: o token temporário venceu (7 dias) ou já foi usado. Peça outro ao gerente e gere de novo.
- O Itaú recusou a geração do PIX: confira se a chave Pix digitada é da mesma conta liberada na API.
- O cliente pagou e o pedido não confirmou: com o aviso de pagamento cadastrado, a confirmação leva poucos segundos; sem ele, até 30 segundos. Se passar disso, confira o extrato do Itaú e chame o suporte do Aliv Hub.
Ligação com o resto do sistema
- O botão de Pix online do app de delivery e do totem aparece sozinho quando o Itaú (ou o Mercado Pago) está conectado.
- O PIX automático no WhatsApp fica na guia Inteligência Artificial e funciona com o Itaú do mesmo jeito que com o Mercado Pago.
- A taxa que o Itaú cobra por Pix, se houver no seu contrato, é cadastrada na forma Pix Online em Pagamentos Manuais, para o fechamento de caixa e o Balancete usarem o valor certo.
Perguntas frequentes
Preciso liberar alguma coisa na minha conta do Itaú para usar o Pix Itaú no Aliv Hub?
Precisa. A API Pix não vem ligada na conta PJ. Peça ao seu gerente do Itaú a contratação da API Pix, que no Itaú se chama Recebimentos Pix. Depois que o banco libera, chega por e-mail o client ID e um token temporário, e é com eles que você conecta o cartão Pix Itaú em Configurações, guia Integrações Pagamentos.
O Aliv Hub precisa de alguma credencial ou cadastro no Itaú?
Não. Cada pizzaria usa as credenciais da própria conta. O Aliv Hub não tem cadastro no Itaú e não vê sua senha do banco. Você cola o client ID e o token temporário no cartão Pix Itaú e o sistema gera sozinho o certificado de segurança e guarda tudo cifrado.
Todo mundo que for conectar o Pix Itaú tem que falar com o gerente da conta?
Tem. A liberação da API Pix é feita pelo Itaú, conta por conta, pelo gerente ou pelo atendimento empresarial da sua conta PJ. É diferente do Mercado Pago, que conecta com um clique. Depois que o Itaú libera, a conexão no Aliv Hub leva poucos minutos.
Posso ficar com o Mercado Pago e o Itaú conectados ao mesmo tempo?
Não. A loja usa um banco de Pix por vez. Ao salvar o Itaú, o Mercado Pago é desconectado; ao conectar o Mercado Pago, o Itaú é desconectado. Os Pix que o banco anterior já tinha gerado continuam sendo conferidos, então o cliente que pagou o QR antigo tem o pedido confirmado normalmente.
O token temporário que o Itaú mandou por e-mail venceu ou deu erro. E agora?
O token temporário vale 7 dias e só pode ser usado uma vez. Se venceu ou já foi usado, peça outro ao seu gerente do Itaú e cole o novo no cartão Pix Itaú, no campo Token temporário (e-mail do Itaú), antes de clicar em Gerar certificado.