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:
- Crie um aplicativo na conta digital PJ: https://contadigital.bancointer.com.br/?t=pj (Somente conta Pessoa Jurídica);
- 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 );
- Após criada e aprovada copie os dados da aplicação: ClientId (“client_id“) e ClientSecret (“client_secret“);
- Baixe também o certificado da aplicação, que tem validade de 12 meses, e deve ser renovado antes do vencimento.
- O certificado vem em duas partes (KEY e CRT/CER);
- De posse das informações acima você poderá inicializar a API no Maker/Webrun;
- 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).
- Na função “PIX – Inicializar” passe os seguintes parâmetros:
- Verdadeiro (Lógico) – Para produção;
- “BancoInter” (Letras) – Texto fixo que identifica o Banco Inter;
- 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:
- 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“;
- 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.
- 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.