Utilizando o registro via Web Service Bancário com o Cora – Central de Atendimento

Solicitando dados necessários

Para integrar sua aplicação com o Banco Cora e realizar emissões via Web Service (WS), siga os passos abaixo:

Quem deve realizar a habilitação na Parceria Cora?

A habilitação deve ser realizada pela software house cliente da TecnoSpeed, uma única vez. Por exemplo, a Conexa deve criar ou utilizar sua própria conta Cora e solicitar a Parceria Cora para disponibilizar a integração aos clientes dela.

O fluxo, confirmado pela Cora, é:

A software house cria ou utiliza sua conta Cora e realiza a solicitação de parceria conforme as telas abaixo.
No formulário, informa que a integração será realizada por meio da TecnoSpeed/PlugBoleto e preenche o campo de link de redirecionamento com a URL de callback correspondente ao ambiente.
Após a aprovação, a software house recebe as credenciais client_id e client_secret e as fornece aos seus clientes para configuração dos respectivos convênios no PlugBoleto.
Cada cliente final utiliza sua própria conta Cora e realiza a autorização de acesso pelo fluxo do PlugBoleto com as credenciais da SH.

Os clientes finais da software house não precisam solicitar uma Parceria Cora nem repetir esse formulário. A solicitação de parceria e a obtenção das credenciais são responsabilidade da software house; a autorização de acesso à conta é realizada por cada cliente final.

1. Criar uma Conta no Cora (Caso a SH não tenha)

Para criar uma conta no Cora basta acessar o https://www.cora.com.br/ inserir as informações necessárias e finalizar o cadastro.

Importante caso vá abrir uma conta Nova Cora

Caso vá abrir uma nova conta haverá uma opção de cadastro de redirect_uri nesse campo é imprescindível que seja cadastrada nossa URL de callback. Desta forma conseguiremos obter o código de autorização e os webhooks bancários

redirect_uri:

Produção: https://plugboleto.com.br/api/v1/authorization/callback

Homologação: https://homologacao.plugboleto.com.br/api/v1/authorization/callback

2. Modalidade de Integração - Parceria Cora

Essa modalidade é utilizada por empresas que querem em conjunto com a Cora, oferecer uma experiência integrada e diferenciada de gestão de cobranças, pagamentos e visualização de entradas e saídas aos clientes finais.

Em Parceria Cora teremos 3 atores e nesta documentação sempre vamos direcionar a eles da seguinte forma:

Cora sempre que falarmos "Cora” estamos nos referindo ao banco cora.
Empresa Parceira sempre que falarmos "Empresa Parceira” estamos nos referindo a você, empresa que buscou a "Cora” para realizar essa parceria.
Cliente Final sempre que falarmos "Cliente Final” estamos nos referindo ao usuário final que utiliza a sua plataforma e a da "Cora” para gerenciamento.

Para quem é destinada essa modalidade?

Empresas ERPs, CRMs, BPO Financeiros, Contabilidades Digitais e vários outros segmentos entram nesta modalidade.

Me dá um exemplo, por favor?

Temos várias empresas parceiras que estão enquadradas como ERPs (Enterprise Resource Planning), ou seja, empresas que oferecem softwares de gestão empresarial para facilitar a operação de seus clientes. Essas empresas buscam na Cora os produtos bancários que faltavam para complementar a gama de produtos e serviços e dar uma experiência mais fluída na gestão de seu negócio e ao ”Cliente Final”.
Mas empresas da modalidade ERP é apenas um exemplo. Como falamos na seção acima, diversas empresas de outras áreas também vem a Cora como a parceira ideal para oferecer produtos bancários de qualidade.

3. Como solicitar as credenciais de acesso?

Para solicitar as credenciais de acesso às APIs da Cora pelo modelo de parceria, siga esses passos no aplicativo/Internet Banking;

Solicitação da Parceria Cora pelo aplicativo (mesmo processo/telas para InternetBanking)

Para solicitar a parceria, acesse a conta Cora da empresa e siga a sequência abaixo. A solicitação é enviada à Cora para análise; o formulário não exibe as credenciais.

Na tela inicial, toque em Conta no menu inferior e depois em Integrações via APIs.
Na tela de integrações, selecione Parceria Cora.
Leia os objetivos da modalidade e selecione todos os itens para continuar. A parceria é destinada ao uso dos serviços da Cora pelos clientes da empresa, por meio do sistema da parceira.
Informe o site ou rede social da empresa, se desejar. Essa etapa é opcional.
Descreva a empresa. O aplicativo exige uma apresentação com no mínimo 50 caracteres. 🚨IMPORTANTE🚨 - Informar a descrição sugerida com URl de Callback e direcionamento para Tecnospeed.
Selecione a faixa que representa aproximadamente a quantidade de clientes da empresa.
Informe nome e e-mail dos responsáveis pelas áreas comercial, jurídica e de desenvolvimento.
Informe o link de redirecionamento solicitado para o ambiente de teste. Se necessário, adicione outros links. Para integração pelo PlugBoleto, confira a URL de callback indicada mais abaixo nesta documentação.
Leia os Termos e Condições e selecione Aceitar para enviar o pedido.
Acompanhe o status da solicitação no aplicativo. A tela informa prazo de até 3 dias úteis para retorno no aplicativo e por e-mail.

Sequência de telas do aplicativo:

Tela inicial da conta Cora, com acesso à área Conta

Menu da conta Cora com a opção Integrações via APIs

Na tela Integrações via APIs selecione a opção Parceria Cora

Marque os objetivos e condições da modalidade Parceria Cora

Campo opcional para informar o site ou rede social da empresa

🚨IMPORTANTE🚨 Campo para descrever a empresa com pelo menos 50 caracteres seguir sugestão de preenchimento*

*Sugestão de preenchimento (Deve conter a URL de callback p? identificação da Tecnospeed no Cora):

A [NOME DA EMPRESA] atua no segmento de [SEGMENTO] e oferece [PRODUTOS OU SERVIÇOS] para [PERFIL DOS CLIENTES]. Para disponibilizar os serviços da Cora aos seus clientes, a integração será realizada por meio da TecnoSpeed, utilizando a plataforma PlugBoleto. O fluxo de autorização será direcionado aos callbacks da TecnoSpeed: Produção — https://plugboleto.com.br/api/v1/authorization/callback.

Opções para informar a quantidade aproximada de clientes

Informar o contato do responsável comercial

Informar o contato do responsável jurídico

Responsável pela integração da SH com o cliente final

Campo para informar os a URL de Callback de homologação - https://homologacao.plugboleto.com.br/api/v1/authorization/callback

Tela dos Termos e Condições da Parceria Cora

Processo finalizado e encaminhado para validação do Cora, basta aguardar a aprovação e liberação das credenciais.

Para dúvidas sobre a análise da parceria, o aplicativo informa o contato suporteapi@cora.com.br.

Exemplos dos valores das credenciais (modalidade Parceria Cora):

Credencial	Valor
client-id	app-teste-doc
client-secret	81d231f4-f8e5-4b52-9c08-24dc45321a16

4. Testar no Ambiente Sandbox

Antes de mover para o ambiente de produção, é recomendável testar sua integração no ambiente Sandbox fornecido pelo Cora. Esse ambiente permite simular operações e garantir que sua aplicação esteja funcionando conforme o esperado.

Para realizar os testes, acesse https://homologacao.plugboleto.com.br para que possa cadastrar sua conta e convênio.

Acessando o ambiente de testes, cadastre sua conta selecionando o banco CORA e em seguida preencha com seus dados bancários.

Assim que for cadastrado, acesse o menu de convênios, preencha os dados obrigatórios e siga para a aba Configurações do convênio

Habilite o Registro instantâneo e preencha os dados abaixo

OBS: o campo Código de autorização - Cora será preenchido com um token retornado executando o processo seguinte

Para ter acesso ao Código de Autorização do Cora, informe o API - ID e o Segredo então clique no botão Salvar e autorizar. Ao salvar, você será redirecionado para o portal de login do banco, para que possa seguir com a criação do código (lembre-se, uma conta desenvolvedora deve existir para que consiga acessar o ambiente).

Assim que seguir em frente, será redirecionado para a URL cadastrada anteriormente informando se houve sucesso ou falha em sua autorização.

Assim que tiver sucesso, uma requisição de autenticação será enviada ao banco para obtermos o access_token e refresh_token. O refresh token tem uma duração de 1 dia e, toda vez que é utilizado, tem sua duração redefinida para 1 dia.

Portanto, esses dados são cruciais para garantir as emissões sem a necessidade de refazer os fluxos anteriores, evitando acionamentos aos clientes finais para autenticação.

Em caso de falha ao autenticar no banco, será exibida uma mensagem de erro na interface informando que ocorreu algum problema.

5. O que fazer?

Primeiramente, podem refazer o processo de obter o código de autorização revisando o ambiente que está sendo executado (sandbox ou produção).
Inserir os dados novamente nos campos API - ID, Segredo, o campo Código de autorização - Cora, deverá se manter vazio novamente, em seguida salve o convênio para que possamos refazer o processo de autorização e autenticação.
Caso o erro persista, recomendamos acessar o chat para obter mais informações e ajuda do nosso time técnico.