A Aliv Hub Central de Ajuda
Parceiro
8 min de leitura

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ó:

  1. 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.
  2. 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.
  3. 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ú

  1. Abra Configurações, guia Integrações Pagamentos, e vá até o cartão Pix Itaú.
  2. Em Conta, deixe marcado Conta real (produção).
  3. Cole o Client ID do e-mail do Itaú no campo Client ID.
  4. Cole o token do e-mail no campo Token temporário (e-mail do Itaú).
  5. 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.
  6. 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).
  7. 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.

Quer ver isso funcionando na sua operação?

O Aliv Hub junta PDV, cozinha, estoque, app próprio e os aplicativos de delivery numa tela só. 15 minutos de conversa e você vê o sistema rodando com o seu cardápio.

Conhecer o Aliv Hub