085 - Ailos

1. Visão Geral
2. Como obter e cadastrar as credenciais junto ao banco (Sandbox)
3. Como obter e cadastrar credenciais junto ao banco (Produção)

Visão Geral

O recurso de transmissão instantânea foi desenvolvido para facilitar a integração de sistemas de cobrança com as APIs bancárias, oferecendo uma solução prática e eficiente para desenvolvedores.

Esse método permite a consulta direta dos dados dos boletos nos servidores bancários, retornando imediatamente após sua criação o status REGISTRADO como nos boletos de cobranças de grandes marketplaces.

Ao utilizar a transmissão instantânea, desenvolvedores conseguem implementar um fluxo de emissão de boletos mais ágil e seguro, permitindo que clientes finais possam realizar o pagamento dos títulos logo após a criação. Isso elimina o tempo de espera que existe no tradicional método de transmissão de remessas e obtenção de retorno que é D+1, já que cada boleto emitido pelo sistema é validado instantaneamente, integrando-se com o servidor bancário em tempo real.

Essa solução simplifica a comunicação com instituições financeiras, reduzindo o esforço de implementação e manutenção de sistemas de cobrança, enquanto melhora a experiência do usuário final. Com a transmissão instantânea, é possível construir aplicações financeiras robustas que garantem precisão nos dados de pagamento, ao mesmo tempo em que agilizam o processo de verificação e registro de boletos.

Atenção: Apesar de a captura do status de REGISTRO ou REJEIÇÃO via API ser imediato as LIQUIDAÇÕES(pagamentos) não seguem a mesma dinâmica, dependendo dos procedimentos internos do banco. Isso significa que o status de liquidação não está disponível instantaneamente e depende dos prazos internos de atualização de suas bases. Esse tempo pode variar de acordo com o banco e o serviço de API.

Como obter e cadastrar as credenciais junto ao banco (Sandbox)

O processo se inicia no contato a Central de Cooperativas Ailos, portando sua FRASE de desenvolvedor.
 

Central de Cooperativas Ailos - E-mail: homologacaocobranca@ailos.coop.br

A Ailos vai solicitar CNPJ/CPF, Nome, FRASE do desenvolvedor e outras informações cadastrais para
realizar a liberação das APIs de acordo com o nível de permissão de acesso.

Se for seu primeiro contato então será criado um usuário no Portal de APIs da Ailos. Será enviado um e-mail com suas credenciais de acesso acompanhada da CHAVE do desenvolvedor em formato UUID.

Feito essa solicitação o banco encaminhará uma cartilha (que pode ser desconsiderada) e no e-mail encaminhará as credenciais nesse padrão: 

Nesse momento salve essas informações:

• Consumer Key

• Consumer Secret   

• AilosApiKeyDeveloper UUID 

• Conta Ambiente SandBox  

• Senha

Após esse processo cadastre a conta em Produção com os dados fornecidos, mas no número de conta informe a Conta Ambiente SandBox. 

 

No Convênio realize o cadastro das credenciais seguindo essa recomendação: 
 

Via API - Rotas de Convênio 

• Cooperativa -> ConvenioCodigoCooperativa

• Consumer Key -> ConvenioApiId

• Consumer Secret ->  ConvenioApiSecret

• AilosApiKeyDeveloper UUID -> ConvenioApiKey

• Senha -> ConvenioAilosAuthPassword
   

Via GUI - Dados do convênio


 

Configurações do convênio

Assim que cadastrados os dados na API devem ser realizadas 3 emissões de teste em Sandbox e envio dos 3 PDF's ao banco para conclusão e disponibilização das credenciais de produção! 

IMPORTANTE: Para emissão com o AILOS via WS o campo "TituloCodEmissaoBloqueto" é obrigatório, informações do campo clique aqui.  

Como obter e cadastrar credenciais junto ao banco (Produção)

Feito o cadastro do passo anterior "Como obter credenciais junto ao banco (Sandbox)" realize a geração de 3 boletos de teste na conta e convênio cadastrado nesse passo. 

Dica de inclusão, se atente de preencher o campo "TituloLocalPagamento" com:

"Pagavel Preferencialmente nas Cooperativas do Sistema Ailos" 

Gerando os boletos, encaminhe os 3 PDF's ao e-mail da Central de Cooperativas Ailos (informado nos passos acima) e aguarde as credenciais em produção. 

 

Após coletar as credenciais de produção, devem chegar no mesmo padrão de Sandbox no e-mail, nesse momento salve essas informações:

• Consumer Key

• Consumer Secret   

• AilosApiKeyDeveloper UUID 

• Conta Ambiente SandBox  

• Senha

Após esse processo cadastre a conta em Produção com os dados fornecidos, mas no número de conta informe a Conta Produção. 

 

No Convênio realize o cadastro das credenciais seguindo essa recomendação: 
 

Via API - Rotas de Convênio 

• Cooperativa -> ConvenioCodigoCooperativa

• Consumer Key -> ConvenioApiId

• Consumer Secret ->  ConvenioApiSecret

• AilosApiKeyDeveloper UUID -> ConvenioApiKey

• Senha -> ConvenioAilosAuthPassword
   

Via GUI - Dados do convênio


 

Configurações do convênio

Feito esse processo sua conta já deve estar disponível em produção!