Guia de Integração | Cora
1. Configurando a Carteira do Cora
Você pode cadastrar a carteira bancária de seus clientes para facilitar o controle de cobranças e pagamentos. Isso ajuda a manter as informações organizadas e evita a necessidade de digitar os dados bancários a cada operação.
Com a carteira configurada, o sistema consegue gerar boletos e processar pagamentos automaticamente, reduzindo erros e agilizando o trabalho diário.
Entre os principais benefícios, destacam-se:
-
Agilidade no recebimento: os pagamentos por cartão são processados instantaneamente, acelerando o fluxo de caixa e melhorando a previsibilidade financeira.
-
Segurança nas transações: gateways utilizam padrões avançados de criptografia e protocolos de segurança, reduzindo riscos de fraudes.
-
Melhoria na experiência do cliente: a possibilidade de pagar por cartão de crédito oferece mais conveniência, ampliando as opções de cobrança e aumentando a satisfação do consumidor.
-
Controle centralizado: todas as transações ficam concentradas no SGP, permitindo relatórios unificados e gestão integrada de recebíveis.
Antes de iniciar o processo, consulte nossa FAQ Boas Práticas para uma Integração Segura para garantir uma implementação mais segura e eficiente.
2. Dados necessários para integrar ao SGP
Para a integração, não precisamos de credenciais de API. O fluxo de Autorização exige apenas que você tenha acesso à sua conta.
Enviaremos o link de consentimento, e você deverá:
-
Acessar o link.
-
Logar na Cora com seu CPF e senha.
-
Confirmar a autorização.
Seu CPF e senha são utilizados somente no ambiente seguro do Cora para conceder o acesso à nossa aplicação.
3. Integração do Portador
Mesmo sendo uma integração via API, os dados da conta são necessários para a emissão dos boletos.
- Você será direcionado para a página de cadastro de Portador, onde poderá inserir e configurar os dados necessários.
Na guia Dados Bancários configure:
- Código do Banco: 998 - Conta Digital Cora
- Descrição: Banco Cora
- Agência: 0
- Conta Cedente: 0
- Carteira: 0
Em seguida, na guia Relacionamentos da Empresa selecione:
- Empresa beneficiária
- Nome do beneficiário
- CPF ou CNPJ do beneficiário
Confirme essas informações com o cliente para evitar rejeição de boletos por dados incorretos.
Por fim, devemos configurar os Juros e Multa, acessando a guia Juros, Multas, Descontos e Taxas
Durante essa configuração, é necessário , que seja tratado com o cliente com relação à configuração de Juros e Multa em sua base. O Cora aceita os modos de juros e multa abaixo:
- Percentual Multa, Percentual Juros ao mês
- Percentual Multa, Percentual Juros ao dia
- Percentual Multa, Fixo Juros ao dia
- Fixo Multa, Percentual Juros ao mês
- Fixo Multa, Percentual Juros ao dia
- Fixo Multa, Fixo Juros ao dia
Para uma melhor compreensão, recomendamos a leitura da nossa documentação de Configuração de Juros e Multa
4. Ponto de Recebimento (Caixa)
O ponto de recebimento é o local onde os pagamentos de boletos serão registrados.
- Na guia Dados Básicos, defina o Nome do caixa e selecione o Portador padrão.
5. Cadastro do Gateway de Boletos
Agora vamos integrar o Gateway ao SGP para emissão de boletos.
Clique no botão Cadastrar e preencha da seguinte forma:
- Nome da Integração: Cora API V2
- Descrição: Cora API
- Habilite Pagamentos via PIX
- Selecione o Portador Cora
- URL de Notificação: https://cora.sgp.net.br/cora/https/{NOME_SGP_NA_URL}/{ID_DA_GATEWAY}
- Esta URL, pode ser solicitada ao Suporte. - Ponto de Recebimento: Cora
- Gerar Boleto/Carnê + Pix?: Selecionar
Antes de cadastrar a URL de notificação, verificar a URL verificar a seção de Informações Adicionais
Imagem de Referência (API BOLETO + PIX)
Antes de cadastrar a URL de notificação, verificar a URL verificar a seção de Informações Adicionais
6. Informações Adicionais
- No cadastro da URL de notificação, o ID do Gateway é indispensável para o correto processamento dos retornos.
- Para identificá-lo, siga os passos:
- Crie um gateway deixando o campo “URL de notificação” em branco.
- Anote o ID gerado.
- Em seguida, cadastre a URL de notificação utilizando esse ID.
-
A seguir, listamos algumas funcionalidades disponíveis para a sua integração:
- Para identificá-lo, siga os passos:
-
Funcionalidade Cora Boleto - Registro ✔️ Boleto - Retorno ✔️ Boleto - Cancelamento ✔️ Boleto - Tempo de Retorno Rotina PIX - Emissão ✔️ PIX - Cancelamento ✔️ PIX - Tempo de Baixa Rotina/webhook PIX Híbrido ou Avulso? Ambos
