← VoltarAda

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

ItemO que é
Conta no Banco Inter da mesma empresa da organizaçãoO nome do certificado precisa bater com o da organização
Certificado da API, dois arquivosUm .crt e um .key
ClientID e ClientSecretAs credenciais da integração da API
Escopo de cobrança de boleto com leitura e escritaSem ele o banco recusa o acesso
Conta financeira na AdaRecebe os valores

Você gera o certificado e as credenciais na área de integração por API do Banco Inter.

Como cadastrar

  1. Em Configurações, Contas, cadastre a conta financeira da organização. Veja Contas.
  2. Em Configurações, Integrações, clique em Novo.
  3. Empresa: escolha a organização.
  4. Integração: escolha Banco Inter.
  5. Configuração:
    • Conta financeira: escolha a conta do passo 1.
    • Acesso: informe ClientID e ClientSecret.
    • Certificado: envie o .crt e o .key.
  6. A Ada valida. Aparece Credenciais válidas! e, no certificado, o nome e a validade.
  7. Salve.
  8. Em Organizações, aba Integrações, marque o Banco Inter para Boleto, Pix e Instituição de pagamento.

O que a Ada valida

VerificaçãoMensagem 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 bancoFalha 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 quemCampos
ClienteCPF/CNPJ, tipo de documento, nome e endereço
OrganizaçãoNome, CPF/CNPJ, CEP, endereço, cidade, estado e bairro

Veja Etapas da automação para as mensagens de erro do boleto.

Se deu errado

SintomaCausaO que fazer
Credenciais inválidasClientID, ClientSecret ou certificado erradosGere 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çãoO nome do certificado é diferente do da organizaçãoAjuste o nome da organização ou use o certificado da empresa correta
Boleto não é emitidoFalta dado do cliente ou da organização, ou a integração não está marcada na organizaçãoConfira 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 pagoO banco ainda não confirmou, ou o boleto foi pago fora do prazo de verificaçãoAguarde a confirmação do banco. Se persistir, abra o lançamento e use Baixa manual, informando a data e o valor pagos
Certificado venceuA validade passouGere 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.

OndeEndereçoAcesso direto
Nova integração/config/integration/newSim
Lista de integrações/config/integrationSim
Organização, aba Integrações/config/organization/{id}?tab=integracoesSim
Contas/config/treasury_accountSim