Como ativar a API de uma carteira de cobrança?

A forma mais eficiente de comunicação entre a Fintera (Kobana) e o seu banco se dá através do Web Service ou API bancária, que tem acesso direto ao sistema do banco e possibilita o registro do boleto em poucos segundos, permitindo que o seu cliente possa pagar imediatamente ao recebimento e, a depender do banco, é possível realizar outras operações, como alteração, cancelamento e receber a confirmação de pagamento.

Atenção! A ativação da API deve ser realizada após o cadastro da carteira e validação do funcionamento da EDI.

Porém existem bancos, principalmente os digitais como Inter, que só possuem a ativação via API (não há CNAB/EDI). Para mais informações deste tipo de processo é importante acessar a Central de Ajuda da Kobana.

O que é necessário para ativar a comunicação com o banco via API ou web service?

Banco	Tipo	Ações necessárias para ativação
Banco do Brasil	API	Cadastrar as credenciais da API bancária na Kobana: Como conectar à API de cobrança do Banco do Brasil?
Banco Inter	API	Enviar arquivo gerado no internet banking com as credenciais: Como ativar a comunicação via API do Banco Inter?
Bradesco	Web Service	Solicitar ao gerente a ativação do web service para registro do boleto, o mesmo deverá habilitar o indicador 175. Após a confirmação de habilitação pelo gerente, realize a conexão e ativação da comunicação automática através da interface da Kobana, conforme explicamos abaixo.
Caixa Econômica Federal	Web Service	Realizar pedido junto ao banco para a liberação e habilitação do registro via Web Service. Após a confirmação de habilitação pelo gerente, realize a conexão e ativação da comunicação automática através da interface da Kobana, conforme explicamos abaixo.
Itaú	API	Geração de chaves para acesso às credenciais: Como ativar a comunicação via API com o Itaú
Santander	Web Service	Validar certificado no banco e disponibilizar na Kobana junto com o código de estação: Como ativar o registro automático através do Web Service do Santander?
Sicoob	Web Service	Inclusão de credenciais e autorização pelo portal do banco: Como ativar o registro via web service do Sicoob?
Sicredi	API	Gerar Token Master através do Bankline e enviar à nossa equipe: Como ativar o registro automático através do Web Service do Sicredi?

Dica: caso o banco do cliente não esteja exibido acima, verificar com a Kobana o processo.

Como criar uma conexão com o banco e ativar a comunicação?

Cada banco tem sua peculiaridade para a ativação da comunicação, como a geração de credenciais, a criação e validação de certificado e a ativação direta no sistema do banco, como pode ser visto na tabela acima.

Após conversar com o cliente explicando como ou que informações são necessárias para a ativação da API/web service, e realizado os procedimentos necessários no banco.

Você deverá criar uma conexão na interface da Kobana e ativar essa comunicação, da seguinte forma:

Criando a conexão com o banco

O primeiro passo será acessar o menu Integrações > Conexões e clicar para cadastrar uma conexão. No cadastro, selecione o logo do seu banco, dê um nome para essa conexão, como, por exemplo: "REGISTRO BOLETO - BANCO XYZ - NOME DA EMPRESA".

Em seguida, será solicitado a inserção de credenciais, certificado uma simples ativação a depender do banco.

Associando a conexão à respectiva carteira

Realizada a validação acima com sucesso acesse o menu Cobrança > Boletos > Carteiras e clique em Ativar na coluna do web service da carteira que deseja ativar este serviço.

(imagem)

O sistema vai solicitar que selecione uma conexão para vincular a esta carteira. Selecione a conexão que acabou de criar e finalize o procedimento.

Confirmando a ativação do serviço

Ao finalizar o processo é sugerido que seja emitido um boleto, para confirmar se o registro ocorrerá no mesmo dia.

E também, que verifique na aba de registro se o mesmo foi feito pelo web service.