Para realizar a ativação do Pix Itaú em seu sistema, siga as orientações abaixo. Esse processo envolve etapas junto ao banco e também o envio de informações para a nossa equipe.
Contratação e obtenção de credenciais
Inicialmente, é necessário entrar em contato com o Itaú para contratar o serviço API Pix Recebimento, no modelo sem parceria. Durante esse processo, o banco irá orientar você sobre os próximos passos. Será necessário solicitar as credenciais de acesso junto ao time de implantação do Itaú, por meio do e-mail:
implantacao_cash_varejo@itau-unibanco.com.br
As credenciais solicitadas são:
Client ID;
Client Secret (em alguns casos, não é enviado pelo banco);
Token.
Modelo de e-mail para solicitar a contratação do serviço de API Pix ao banco:
Prezados,
Meu nome é [SEU NOME], responsável pela empresa [RAZÃO SOCIAL / NOME DA EMPRESA], CNPJ [CNPJ].
Venho por meio deste e-mail solicitar a contratação do serviço de API Pix Recebimento, no modelo sem parceria, conforme disponibilizado pelo Itaú para pessoa jurídica.
Nosso objetivo é integrar o Pix como método de pagamento em nossa plataforma, e para isso precisamos ter acesso às credenciais e à documentação necessárias para iniciar o processo de homologação.
Solicitamos orientações sobre:
- Documentação e requisitos necessários para a contratação;
- Processo de cadastro e geração das credenciais (Client ID e Client Secret);
- Ambiente de sandbox disponível para testes;
- Contato ou canal dedicado ao suporte técnico da API.
Ficamos à disposição para fornecer qualquer informação adicional que seja necessária.
Atenciosamente,
[SEU NOME]
[CARGO]
[EMPRESA]
[TELEFONE / E-MAIL DE CONTATO]
Cadastro no portal do Itaú e geração do certificado
Você também deverá realizar o cadastro no portal de desenvolvedores do Itaú.
Após o cadastro, será necessário gerar o certificado digital em ambiente de produção, que é utilizado para autenticação das chamadas da API.
Esse certificado é essencial, pois:
Permite a comunicação segura com o Itaú;
Possibilita a geração do Client Secret, caso ele não tenha sido fornecido pelo banco.
✅ Importante: A geração do certificado deve ser feita na área de Gestão de Certificados do portal. Acesse nosso artigo sobre geração de certificado Itaú.
Informações necessárias para configuração
Para que possamos concluir a configuração do Pix em seu sistema, precisamos que você nos envie os seguintes dados:
Client ID;
Client Secret (caso já possua);
Token;
Certificado gerado no portal do Itaú (arquivos baixados);
Chave Pix;
Agência e conta do Itaú;
CNPJ vinculado à conta;
Informação se deseja cobrar juros e multa para contas vencidas, com os respectivos percentuais;
Definição do tempo de expiração do Pix, conforme as opções:
30 minutos, 1h, 2h, 4h, 8h, 12h, 18h ou 24h.
✅ Caso o Client Secret não tenha sido disponibilizado pelo banco, nós realizaremos a geração a partir do certificado enviado.
Após o recebimento de todos os dados e do certificado, nossa equipe realizará a liberação do módulo de Pix Itaú em seu sistema.
Configuração pelo cliente
Com o módulo liberado, o usuário master da clínica deverá:
Acessar a tela de Formas de Pagamento no sistema
Localizar a opção de configuração do Pix Itaú
Preencher as informações solicitadas:
Chave Pix: Identificador da conta que receberá os pagamentos via Pix;
Client ID: Código fornecido pelo banco que identifica sua aplicação na integração com a API;
Client Secret: Chave de segurança utilizada junto ao Client ID para autenticar as requisições na API;
Tempo de expiração: Defina o período em que a cobrança Pix ficará disponível para pagamento antes de expirar;
Multa: Valor original em caso de pagamento após o vencimento;
Juro: Adicional cobrado por atraso, calculado com base no atraso;
Arquivo: Arquivos do certificado digital gerados no portal do Itaú, utilizados para autenticação da integração;
Senha: Senha definida no momento da geração do certificado, necessária para acessar/utilizar os arquivos.
Ao salvar a configuração, a integração ficará com o status “Pendente”, aguardando a validação do nosso time interno. Nossa equipe irá analisar os dados informados. Se todas as informações estiverem corretas, a integração será validada e aprovada com sucesso.
Teste de funcionamento
Após a aprovação, será realizado um teste inicial acompanhado pelo nosso suporte.
Esse teste consiste em:
Emissão de um Pix com valor simbólico (ex.: R$ 1,00) para um paciente de teste
Validação da leitura do QR Code
Teste do recurso “copiar e colar” do código Pix
Envio do Pix por e-mail e WhatsApp, verificando o recebimento correto
Em seguida, será necessário realizar o pagamento desse Pix para validar o fluxo completo. O sistema deverá identificar automaticamente o pagamento e efetuar a baixa do valor. Com o teste concluído com sucesso, a integração estará totalmente funcional e pronta para uso no dia a dia da sua clínica.
O que achou do nosso artigo? Deixe seu feedback! 💚