Integrar o banco de cobrança
Para a Ada emitir boletos e pix, ela precisa falar com o seu banco. Esta página mostra o que pedir ao banco e onde informar.
A Ada emite boletos e pix pelo Banco Inter. Outros serviços (Lytex e PJBank) estão em Integrações.
O que você precisa ter
| Item | O que é |
|---|---|
| Conta no Banco Inter da mesma empresa da organização | O nome do certificado precisa bater com o da organização |
| Certificado da API, dois arquivos | Um .crt e um .key |
| ClientID e ClientSecret | As credenciais da integração da API |
| Escopo de cobrança de boleto com leitura e escrita | Sem ele o banco recusa o acesso |
| Conta financeira na Ada | Recebe os valores |
Você gera o certificado e as credenciais na área de integração por API do Banco Inter.
Como cadastrar
- Em Configurações, Contas, cadastre a conta financeira da organização. Veja Contas.
- Em Configurações, Integrações, clique em Novo.
- Empresa: escolha a organização.
- Integração: escolha Banco Inter.
- Configuração:
- Conta financeira: escolha a conta do passo 1.
- Acesso: informe ClientID e ClientSecret.
- Certificado: envie o
.crte o.key.
- A Ada valida. Aparece Credenciais válidas! e, no certificado, o nome e a validade.
- Salve.
- Em Organizações, aba Integrações, marque o Banco Inter para Boleto, Pix e Instituição de pagamento.
O que a Ada valida
| Verificação | Mensagem de falha |
|---|---|
O .crt está dentro da validade | "This certificate has expired" ou "not yet valid" |
O .key combina com o .crt | "Existe um erro nos arquivos" |
| O nome do certificado é o da organização | "O certificado não pertence à ORGANIZAÇÃO e sim à OUTRA" |
| ClientID e ClientSecret funcionam no banco | Falha com o código de resposta do banco |
O nome é comparado sem acentos, maiúsculas e pontuação.
Depois de integrado
- O boleto é solicitado ao banco e confirmado depois.
- Uma rotina consulta o banco e, quando o boleto é pago, marca o lançamento como Pago.
- O certificado tem validade: acompanhe em Integrações, colunas Expira em e A expirar/expirado.
Dados exigidos nos boletos
| De quem | Campos |
|---|---|
| Cliente | CPF/CNPJ, tipo de documento, nome e endereço |
| Organização | Nome, CPF/CNPJ, CEP, endereço, cidade, estado e bairro |
Veja Etapas da automação para as mensagens de erro do boleto.
Se deu errado
| Sintoma | Causa | O que fazer |
|---|---|---|
| Credenciais inválidas | ClientID, ClientSecret ou certificado errados | Gere as credenciais de novo no portal do banco. Depois abra Configurações, Integrações, abra a integração do banco, informe os dados novos e salve |
| O certificado não pertence à organização | O nome do certificado é diferente do da organização | Ajuste o nome da organização ou use o certificado da empresa correta |
| Boleto não é emitido | Falta dado do cliente ou da organização, ou a integração não está marcada na organização | Confira as duas coisas nesta ordem: (1) em Configurações, Organizações, na aba Integrações, se a integração de boleto está marcada; (2) os dados do cliente e da organização, conforme as tabelas acima |
| Boleto emitido e nunca marcado como pago | O banco ainda não confirmou, ou o boleto foi pago fora do prazo de verificação | Aguarde a confirmação do banco. Se persistir, abra o lançamento e use Baixa manual, informando a data e o valor pagos |
| Certificado venceu | A validade passou | Gere um novo certificado no banco. Em Configurações, Integrações, abra a integração e envie o novo. Veja Validade dos certificados |
Onde acessar
Endereços a partir do domínio da sua conta.
| Onde | Endereço | Acesso direto |
|---|---|---|
| Nova integração | /config/integration/new | Sim |
| Lista de integrações | /config/integration | Sim |
| Organização, aba Integrações | /config/organization/{id}?tab=integracoes | Sim |
| Contas | /config/treasury_account | Sim |