Manual e Termos de Uso do Módulo Taffarel.dev Efi Pay

Introdução

Este manual destina-se a fornecer instruções detalhadas sobre como utilizar o módulo Taffarel.dev Banco Cora no sistema Perfex CRM. 
O módulo Banco Cora permite receber cobranças através de PIX ou boleto com baixa automática enviada pelo banco, oferecendo integração direta através do plano Banco Cora Pro.

Para você que possui uma licença de uso válida, além de contato direto com o desenvolvedor oficial, também terá acesso as atualizações e correções durante o período de suporte, acesse https://taffarel.dev.

1. Requisitos mínimos

Para utilizar este módulo em seu sistema, confira os requisitos mínimos:

1.1. Perfex CRM versão 3.0 ou superior;
1.2. PHP versão 8.0 ou superior;
1.3. Mod_security disabled, para receber retornos do banco;
1.4. Ser cliente Pessoa Jurídica com conta ativa no Banco Cora e assinatura do plano Cora Pro que permite o consumo das API do banco;
1.5. Licença de uso do módulo ativa através do site do desenvolvedor https://taffarel.dev;
1.6. Conhecimentos básicos sobre configuração de sistemas de pagamentos.

2. Assinatura do Plano Cora Pro

Para assinar o serviço de API como integração direta com o banco Cora, siga os passos:

2.1. Acesse o site oficial do Cora Pro: Cora Pro;
2.2. Verifique os Termos e Condições e contrate o plano Cora Pro conforme instruções fornecidas no site;
2.3. Após a contratação, acesse o aplicativo Cora ou CoraWeb, vá para o menu Conta e selecione Plano Cora Pro;
2.4. Revise os dados da contratação e clique em Contratar para ativar o plano;
2.5. Certifique-se de ter o valor mensal dos serviços disponível em sua conta para débito automático;

3. Acessos de Client-ID e Certificados

Para ativar o acesso via API e obter a chave de Client-ID e certificados, siga os passos:

3.1. Acesse https://app.cora.com.br através de seu computador;
3.2. Clique em Conta > Integrações via APIs > Acessar integração Direta;
3.3. Na tela de Etapas de integração, clique no botão Ambiente de produção;
3.4. Clique em criar uma nova Credencial;
3.5. Anote ou copie sua Client-Id, e baixe o arquivo contendo seu certificado e Private-Key, é um arquivo zip, baixar o arquivo só poderá ser feito uma vez;
3.6. Esta credencial tem validade de um ano, lembre-se de renova-la quando necessário.

4. Configuração do Módulo 

Agora em seu sistema Perfex CRM, siga os passos:

4.1. Na menu laterial, clique em Utilidades > Mídia;
4.2. Crie uma pasta chamada "banco_cora" dentro da pasta Master;
4.3. Descompacte o arquivo baixado do Banco Cora no passo 3.5 e envie  os arquivos "certificate.pem" e "private-key.key". para a pasta "banco_cora" dentro de Master;
4.4. Acesse Configurações > Meios de Pagamento > Guia Banco Cora SCD no sistema Perfex CRM;
4.5. Ative o módulo e insira o Client-ID de produção fornecido pelo banco Cora;
4.6. Para os certificados, mantenha o nome para os arquivos "certificate.pem" e "private-key.key";
4.7. Defina a moeda de pagamento como BRL e configure os campos de juros e multa conforme necessário;
4.8. Para descontos antes do pagamento, defina o tipo e valor do desconto;
  4.8.1 SE OPTAR POR FORNECER UM DESCONTO aos clientes para pagamentos antecipados; o sistema Perfex CRM receberá a baixa da cobrança com o valor integral, e o cliente receberá o desconto no ato do pagamento, considere controlar a diferença no seu fluxo de caixa manualmente;
4.9. Tipo de desconto deve ser escrito em maiúsculo como FIXED para um valor fixo e PERCENT para percentual sobre o valor total da fatura
4.10. Habilite as opções de boleto e PIX para as formas de pagamento desejadas;

5. Autorização e Webhooks 

Chegamos ao momento de conexão com o Banco Cora, siga os passos:

5.1. Acesse Configurações > Meios de Pagamento > Guia Banco Cora SCD no sistema Perfex CRM;
5.2. Abaixo do nome Banco Cora SCD clique no link  Autorização e Webhooks;
5.3. Clique em Fazer login, a partir deste ponto o módulo está conectado;
5.4. Criação de 3 webhooks para os retornos do banco;
5.4.1. Clique no botão Novo Webhook;
5.4.2. URL do perfex deve ser mantida a que o sistema gerou, é automática;
5.4.3. Em recurso escolha TRANSFER e o gatilho como * para receber todos os status, Clique no botão Salvar;
5.4.4. Clique no botão Novo Webhook, novamente;
5.4.5. Em recurso escolha PAYMENT e o gatilho como * para receber todos os status, Clique no botão Salvar;
5.4.6. Clique no botão Novo Webhook, novamente;
5.4.7. Em recurso escolha INVOICE e o gatilho como * para receber todos os status, Clique no botão Salvar.

6. Gerar Faturas

Agora você pode utilizar como modo de pagamento o Banco Cora, siga os passos:

6.1. Cada cadastro de seu Cliente possui um novo campo customizado chamado E-MAIL FINANCEIRO, No cadastro do cliente clique na guia Campos Personalizados > insira o e-mail financeiro do cliente. Sem este e-mail preenchido, o banco Cora não aceita cobranças;
6.2. Vá para Vendas > Faturas ;
6.3. Crie uma nova fatura para o cliente;
6.4. Escolha o método de pagamento (PIX, boleto ou ambos) e adicione os itens a serem faturados;
6.5. O campo PIX copia e cola deixe em branco, ele é automático;
6.5. Salve a fatura e envie-a, se necessário.

O sistema irá receber o retorno de pagamento via webhook (retorno de requisição) automaticamente enviado pelo Banco Cora, configurado no item 5.4.

Sobre tarifas e prazos

A tabela de valores de serviços completa você pode consultar aqui https://www.cora.com.br/termos-e-condicoes-de-apis/ no item 3.2.1, que descreve melhor sobre as taxas.

• O plano Cora Pro realiza a cobrança por boleto e PIX compensados, ou seja, você só é cobrado quando há pagamento da cobrança pelo cliente e não pela emissão dele;
• Todo boleto cancelado ou excluído também possui uma taxa no banco Cora;
• O valor mínimo para gerar um boleto é de R$ 5,00;
• Após a confirmação de pagamento do seu boleto, o dinheiro é liberado na conta em até 3 dias úteis;
• O boleto é aceito apenas se gerado antes das 21 horas para pagamento no mesmo dia;
• Você receberá mensalmente uma nota fiscal de serviços do banco Cora referente ao serviço de uso da API fornecida pelo plano Cora Pro;

Observações Importantes sobre a Independência da Empresa e do Módulo em Relação ao Banco Cora

É importante destacar que o Módulo Taffarel.dev Banco Cora e o Perfex CRM operam de forma independente do Banco Cora. Embora o módulo facilite a integração e o processamento de transações bancárias através do banco Cora, a empresa mantém sua autonomia e não possui vínculo direto com o banco em termos de operações ou responsabilidades financeiras. Assim, quaisquer transações realizadas ou problemas encontrados relacionados ao banco Cora devem ser tratados diretamente com o banco, e a empresa não assume responsabilidade por eventuais questões decorrentes da utilização dos serviços bancários oferecidos pelo Banco Cora.

Estas informações foram obtidas diretamente do site https://www.cora.com.br/termos-e-condicoes-de-apis/#termos-e-condicoes-de-apis

CASO VOCÊ TENHA QUALQUER DÚVIDA SOBRE OS TERMOS DE SERVIÇO DA API, entre em contato direto com o Banco Cora:

Suporte Técnico: suporteapi@cora.com.br
Comercial: api@cora.com.br
Jurídico: juridico@cora.com.br

Para mais detalhes sobre a API e termos de serviço, consulte os links fornecidos.

Última atualização: 28/03/2024