¶ Cora
A integração com o banco cora Cora tem como objetivo principal, a emissão e compensação de boletos bancários. Através de APIs, o HubSoft irá se comunicar com o banco Cora para:
- Emitir Boletos
- Cancelar Boletos
- Verificar Pagamentos
¶ Gerar Credencias de Integração - Painel Cora
Para realizar a integração, o primeiro passo é realizar a abertura de sua conta Cora (clique aqui)
Com a sua conta aberta, acesse o menu Conta e caso não tenha contratado o Plano Cora Pro, contrate o mesmo, conforme a imagem abaixo:
Caso já tenha o o Plano Cora Pro contratado, clique em Integrações via APIs, conforme imagem abaixo:
Agora vamos gerar as credenciais, clique em Integração Direta:
E clique em Ambiente de Produção:
Será gerado o client_id e basta clicar para gerar os certificados, quando gerar, será baixado um zip na sua maquina contendo a chave publica e a chave privada do certificado.
¶ Adicionar Integração - HubSoft
Agora, com todos os dados em mãos, vamos até o HubSoft para cadastrar a Integração
O primeiro passo é acessar no HubSoft o menu lateral Configuração > Integrações > Pagamento, conforme imagem abaixo:
Clique em Adicionar, para inserirmos os dados da Integração
Nessa etapa, escolha o Gateway de Pagamento como Cora:
Preencha os parâmetros desejados da imagem acima, os parâmetros disponíveis são:
- client_id: (Obrigatório) Parametro gerado pelo Cora
- certificado: (Obrigatório) Dados da chave pública (.PEM) + chave privada (.KEY) do certificado digital disponibilizado pelo Banco Cora
- boleto_pix: (Opcional) Parâmetro para indicar se dever habilitado o BOLETO + PIX no Cora. Para ativar, precisa ter uma chave pix registrada na sua conta. Parâmetros aceitos (true|false). Padrão do sistema: false
- transmite_baixa: (Opcional) Indica se a integração irá transmitir as baixas de títulos, por exemplo: recebimentos na empresa, descontos totais, ou seja, situações onde o título deverá ser baixado no cora. Valores aceitos (true|false). O não preenchimento desse atributo, faz com que o sistema não transmita as baixas para o Cora
- ambiente: (Opcional) Indica se a integracão está em produção ou não. Valores aceitos (homologacao|producao). Caso nada seja preenchido o sistema irá assumir o valor «producao»
Feito isso clique em Salvar
Após a integração ser criada, você pode clicar em Ações > Testar Integração para conferir se esta tudo certo.
¶ Configurar Forma de Cobrança - HubSoft
Agora vamos onfigurar a Forma de Cobrança, que será associada com o seu Cliente e Boletos
Então, no menu lateral acesse o menu Configuração > Financeiro > Forma de Cobrança, conforme imagem abaixo
Clique em Adicionar uma Forma de Cobrança e preencha o Banco como Cora e selecione a Integração que você acabou de adicionar
Feito isso, acesse a aba Configuração e preencha os dados conforme a imagem abaixo
Feito isso, está tudo pronto para você iniciar a emitir seus boletos no HubSoft de forma integrada ao Cora.
¶ BOLETO + PIX
Também é possível emitir o Boleto + Pix direto, para isso, na integração, basta adicionar o parametro boleto_pix como true, que quando um boleto for registrado, o mesmo terá os dados do QRCODE, lembrando que para ativar essa funcionalidade, é preciso ter uma chave pix registrada na sua conta
Nessa modalidade, ao emitir um boleto bancário, automaticamente já é emitido um PIX com os mesmos dados do boleto. Dessa forma, em um único boleto, o cliente conseguirá pagar utilizando o código de barras ou QR Code do PIX.
¶ WEBHOOK
O Webhook é ativado para seu client_id assim que emite o primeiro boleto na hubsoft, sendo assim, assim que um boleto constar como pago no sistema do Cora, eles automaticamente enviam para hubsoft o informe daquele pagamento.
Por mais que o Banco Cora envie Webhooks para o sistema, é importante ter a Rotina de VERIFICA COBRANÇA GATEWAY adicionada, para assim, nenhum boleto ficar sem seu devido recebimento.
¶ Perguntas/Problemas Frequentes
Abaixo serão listadas algumas perguntas/problemas frequentes relacionados a Cora. Caso alguma dessas situações aconteça e você tenha dificuldades para resolver, não hesite em chamar nosso suporte, pois estamos aqui para lhe ajudar.
¶ É possível enviar baixas automaticamente para a plataforma?
É possível sim, na integração temos o parâmetro opcional chamado transmite_baixa, o mesmo aplicado com o valor true indica que a integração irá transmitir as baixas de títulos, por exemplo: recebimentos na empresa, descontos totais, ou seja, situações onde o título deverá ser baixado no Cora.
¶ Qual prazo de transmissão de um boleto para o Cora?
A transmissão de boletos para gateways de pagamento é de 100 boletos a cada 6 minutos.