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:

1. Criar uma Conta no Cora

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

Ao abrir a 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. Credenciais de acesso

As credenciais de acesso às APIs da Cora variam de acordo com a modalidade escolhida, mas todas podem ser solicitadas no menu Conta > Integrações via APIs

Agora, segue exemplos dos valores dessas variáveis (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.