Central de Ajuda

Boleto | Itaú

Para saber mais sobre boletos, acesso o artigo Boleto | Saiba mais sobre esse meio de pagamento.

Como contratar

Contratação junto ao Banco

Para contratar o serviço de boleto com registro online Itaú é necessário entrar em contato com o gerente responsável pela sua conta no banco e solicitar a contratação do serviço de boleto e da carteira (109, 175 ou 198) com registro online, que é a que integramos.

Caso você não tenha o contato do seu gerente de contas, você pode falar diretamente com a Central de Atendimento do Banco através do telefone:

0800 728 0728

Na etapa de contratação, será preciso gerar as credenciais e certificados assinados pelo Itaú seguindo o passo a passo descrito no portal de desenvolvedor do Itau, linkado aqui, e com o apoio do seu gerente de conta.

Contratação junto ao Gateway

Aqui no Pagar.me você já tem esse serviço disponível para a sua integração quando contrata o serviço Gateway! Por isso, não é necessário realizar uma nova contratação.


Como homologar

Passo 1 | Configuração da VAN

Se você já utiliza o serviço de boleto registrado via VAN conosco e não pretende mudar o seu domicílio bancário na migração para registro online, não é necessário abrir uma nova Fise na Accesstage.

Se ainda não utiliza o serviço de boleto é necessário realizar, junto ao seu gerente de Contas no Banco, a configuração da VAN.

Para realizar a configuração da VAN, você deve solicitar ao seu gerente de contas no Banco que entre em contato com a VAN Acesstage, através do número de telefone (11) 3549-6570. Seu gerente de contas irá informar à Accesstage que você está realizando uma homologação de boletos através do Pagar.me e passará os dados abaixo para a integração do lado da VAN:

  • Layout: 400
  • Produto: Cobrança - retorno

Após a solicitação, a VAN tem até 7 dias úteis para configurar o tráfego e liberar a FISE, que número de registro da configuração entre o Banco e a Accesstage).

Delete

Não sabe o que é a VAN?

Para entender mais sobre o que é a VAN e qual é a importância desse serviço no processo de homologação de Boletos, basta acessar nosso artigo Boleto | Saiba mais sobre esse meio de pagamento.


Passo 2 | Ajuste na Integração

Nessa etapa, os ajustes são feitos na integração da sua plataforma com o Pagar.me. Ou seja, é necessário seguir as orientações da nossa documentação para realizar as configurações que vão possibilitar que a sua loja transacione com boletos.

Na carteira com registro online é necessário o envio de alguns dados do comprador para o banco: nome do comprador, CPF/CNPJ e endereço do comprador (rua, número, cidade, estado e CEP). Caso algum dado não seja enviado, o registro do boleto no banco não acontecerá, logo o boleto não será gerado.

Também sugerimos que você certifique-se com sua equipe de TI se todos os dados estão sendo enviados dentro dos padrões. Lembrando, todos os parâmetros podem ser encontrados em nossa documentação.

Você também pode conferir na dashboard se os dados foram enviados. Para isso, basta acessar o pedido de boleto gerado e clicar no nome do comprador. Em seguida, verificar se os campos nome, documento e endereço estão preenchidos: 

Outra funcionalidade que você deverá utilizar é o webhook. Ele possibilita a notificação automática para a sua plataforma de que um boleto foi pago. Com ele você pode manter seus boletos atualizados e a liberação automática dos seus pedidos no seu sistema. Para saber como configurar, acesso o nosso artigo Webhook | Como configurar?


Passo 3 | Cadastro no Gateway

Após finalizar a contratação e a homologação com o banco e a VAN, é necessário entrar em contato com o nosso suporte, através do e-mail relacionamento@pagar.me, informando que já realizou os passos descritos acima e enviar os seguintes dados:

  • Razão Social;
  • CNPJ da loja cadastrado no banco (14 caracteres);
  • Endereço da loja cadastrado no banco;
  • Banco;
  • Agência (formato: xxxx | 4 caracteres);
  • Conta (formato: xxxxx-x | 5 caracteres mais dígito verificador);
  • Carteira (109, 175 ou 198)¹;
  • ClientId;
  • Secret;
  • Arquivo com a chave em formato .KEY;
  • Arquivo com certificado em formato .CRT;
Delete

É esperado que o clientid, secret, arquivo com a chave assinada pelo itau (.key) e certificado assinado pelo Itau (.CRT) sejam gerados por você com base no fornecimento do token temporário pelo gerente de conta do Itaú e através do passo a passo descrito no portal do desenvolvedor do Itau, linkado aqui.

A renovação do certificado é de sua responsabilidade junto ao Itaú e deve ser iniciado dentro do prazo de 60 dias da sua data de expiração.

Dessa forma, é esperado que você utilize as credenciais (client_id e client_secret) já geradas no primeiro momento, solicite ao seu gerente de conta o token temporário que possui o prazo de expiração de 7 dias corridos, e siga o passo a passo de geração de certificado descrita no portal do desenvolvedor do Itau. O Pagarme espera o envio do arquivo .CRT renovado ao nosso time de atendimento com antecedência de 15 dias da data de expiração.


Após o envio desses dados, nós aguardamos a VAN entrar em contato com a FISE, solicitando que a gente valide os dados. Por isso precisamos das informações acima. Somente depois dessa confirmação que a VAN segue com a conclusão da FISE do lado deles. 


Passo 4 | Teste em Produção

Com a FISE concluída, a afiliação de boleto cadastrada e o webhook configurado na Dashboard, só falta fazer um teste em ambiente de produção. Você deve gerar um pedido como um cliente final utilizando o meio de pagamento boleto. Nós recomendamos que o valor desse pedido não ultrapasse R$10,00, pois ainda estamos validando o sucesso da homologação.

Não esqueça que você deve inserir todos os dados obrigatórios. Assim que realizar o teste, envie o número do pedido e a confirmação do pagamento para o nosso suporte, através do chamado aberto para a homologação do boleto, para que a gente acompanhe a conciliação desse pedido. 

Caso a conciliação do pedido ocorra como esperado, iremos confirmar que a homologação foi realizada com sucesso e você já pode transacionar com esse meio de pagamento. Se encontrarmos algum problema na geração ou na conciliação, vamos precisar que você entre em contato diretamente com o banco para entender o motivo do erro. 


Pagamento de boletos com cheque

Para receber pagamentos de boletos com cheque no Itaú é necessário habilitar o serviço Cobrança Boa no banco, que possibilita o recebimento de novos códigos de retorno. Para isso, é necessário que você entre em contato com seu gerente de relacionamento e informe:

  • Conta qual pretende cadastrar a solução;
  • Se utilizará os códigos de retorno complementares ou o banco deverá enviar o código de liquidação 06 após a compensação do cheque.

Atenção: o serviço Cobrança Boa não está disponível para todos os segmentos de clientes. Se este for o seu caso, você deve solicitar junto ao banco a permissão para que o código padrão de recebimento 06 seja enviado apenas quando o cheque for compensado.

Delete

Atenção

O serviço Cobrança Boa não está disponível para todos os segmentos de clientes. Se este for o seu caso, você deve solicitar junto ao banco a permissão para que o código padrão de recebimento 06 seja enviado apenas quando o cheque for compensado. 

Não é necessária nenhuma habilitação do parâmetro com a gente.

Delete

Importante

No pagamento de boletos com cheque, nós recebemos os arquivos de retorno quando o título é pago e não quando o valor do cheque é creditado em sua conta. Assim, o boleto será conciliado e constará como pago no dashboard mesmo que o cheque ainda não tenha sido compensado.

Como não recebemos toda a comunicação, não será possível saber caso um cheque seja sustado pelo comprador. Por isso, não nos responsabilizamos caso os valores de um título que consta como Pago não sejam creditados em sua conta.


Cancelamento de boleto

Para saber sobre o cancelamento de boleto, basta acessar nosso artigo Boleto | Saiba mais sobre esse meio de pagamento

Esse artigo foi útil?