Blog

Trabalhando com o PIX no Banco Inter (BancoInter / 077)

IMPORTANTE: Os passos aqui descritos são mera complementação e/ou resumo da documentação oficial do Banco Inter. Sigam sempre as instrução oficiais passadas pelo banco. Nem todas as informações aqui contidas podem estar atualizadas (última revisão 16/08/2023).


A inicialização do PIX com o Banco Inter (077) deve seguir os seguintes passos:

  1. Crie um aplicativo na conta digital PJ: https://contadigital.bancointer.com.br/?t=pj (Somente conta Pessoa Jurídica);
  2. Crie uma nova aplicação, e ative todas as permissões na API de PIX (Manual do Inter: https://developers.inter.co/docs/introducao/como-criar-uma-aplicacao );
  3. Após criada e aprovada copie os dados da aplicação: ClientId (“client_id“) e ClientSecret (“client_secret“);
  4. Baixe também o certificado da aplicação, que tem validade de 12 meses, e deve ser renovado antes do vencimento.
  5. O certificado vem em duas partes (KEY e CRT/CER);
  6. De posse das informações acima você poderá inicializar a API no Maker/Webrun;
  7. No fluxo que vai acionar a API crie um mapa com os itens correspondente no site do Inter:
    • client_id“: (Letras) fornecido no site do Inter;
    • client_secret“: (Letras) fornecido no site do Inter;
    • KEY“: (Letras) Conteúdo ou Caminho completo do arquivo KEY (chave) (EX: “C:\meu-dados\certificado-inter.key” ), baixado no site do Inter (ZIP);
    • CER“: (Letras) Conteúdo ou Caminho completo do arquivo CER/CRT (certificado) (EX: “C:\meu-dados\certificado-inter.crt” ), baixado no site do Inter (ZIP).
  8. Na função “PIX – Inicializar” passe os seguintes parâmetros:
    1. Verdadeiro (Lógico) – Para produção;
    2. BancoInter” (Letras) – Texto fixo que identifica o Banco Inter;
    3. Mapeamento com os dados copiados do site do Banco Inter, e o certificado após convertido em PFX.

Webhook

Para receber a notificação de atualização (pagamento, cancelamento) do PIX você pode opcionalmente configurar um Webhook. Para usar tal recurso você deve ter HTTPS no servidor, e um fluxo WEB, após isso você deve observar os seguintes pontos:

  1. Ao inicializar a conexão com o Inter para ler ou alterar o Webhook você deve adiciona um parâmetro extra no mapeamente (3o. parâmetro da função “PIX – Inicializar“), nele deve conter o item com o nome “ESCOPOS” e o valor “webhook.read webhook.write“;
  2. A função “PIX – Webhook – Definir” será usada para definir o webhook, que será a URL completa do fluxo WEB a ser chamado. Importante: O servidor deve ter HTTPS, e ser acessível na Internet.
  3. Para verificar se o Webhook foi definido você pode usar a função “PIX – Webhook – Consultar“.

Observações

  • O Banco Inter não tem ambiente de homologação (Jun/2024). Os testes devem ser feitos em produção.
  • A contratação do serviço e/ou disponibilidade da emissão de PIX é negociada diretamente com o banco. Siga os passos informado por eles para criar/ativar um aplicativo com PIX.
  • O conversor de certificado é uma mera cortesia, sem suporte, sem garantia. Se necessário converta o certificado usando outras ferramentas, e caso deseje contrate suporte extra/adicional para tal conversão.