modobank - Cartão de Crédito
Atenção, Beta!
A integração modobank - Cartão de Crédito está presente na versão Beta do Sistema. Sua disponibilidade na versão Estável será a partir de Julho de 2025.
Introdução
A integração entre o Sistema e a plataforma de pagamentos modobank tem como objetivo automatizar os processos financeiros e de vendas, oferecendo soluções completas e eficientes para pagamentos. Esta documentação apresenta os detalhes do processo de integração, seus benefícios e as configurações necessárias.
Solução Oferecida
Meio de pagamento por cartão de crédito, tanto individual quanto recorrente.
Acesso ao Formulário
Caminho: Sistema > Cadastros > Financeiro > Carteira de cobrança.
Benefícios da Integração
| Benefício | Descrição |
|---|---|
| Automação | Diminui a necessidade de ações manuais e aumenta a eficiência |
| Flexibilidade de Pagamento | Aceita cartão de crédito tanto para pagamentos únicos quanto recorrentes |
| Receita Previsível | Ao ativar a recorrência, o fluxo de caixa se torna mais regular |
| Comodidade para o Cliente | Redução de atrasos e interrupções no serviço por inadimplência |
Estrutura
Como funciona a integração
- Configuração.
- Acesso à Central do Assinante.
- Escolha da Opção de Pagamento.
- Preenchimento dos dados do Cartão de Crédito.
- Habilitação da Recorrência.
Etapas de configuração do módulo
- Configuração da integração com cartão de crédito.
- Juros, multas e desconto.
- Tarefa responsável pelo envio das cobranças recorrentes.
Processo de Integração e Homologação
Para realizar a integração e homologação da Integração de Cartão de Crédito modobank no Sistema, siga os passos abaixo:
Homologação
O cliente interessado deverá entrar em contato com o time Comercial modobank, manifestando seu interesse na integração:
- O cliente receberá uma proposta comercial, elaborada com base em seu CNAE e em uma taxa compatível com os padrões praticados pelo mercado.
- Após a aceitação da proposta, a conta do cliente será duplicada, permitindo a separação dos recebíveis de cartão e a geração das credenciais de API que serão utilizadas na carteira de cobrança.
- O time de Suporte modobank ficará responsável pela homologação da integração, incluindo a criação da carteira de cobrança, utilizando as credenciais de API associadas à nova conta.
- Como parte do processo de homologação, serão realizados testes para garantir que a integração esteja funcional e operando corretamente.
Concluída essa etapa, o sistema estará habilitado para que os clientes da empresa acessem a Central do Assinante e realizem o pagamento de suas faturas por cartão de crédito, tanto de forma avulsa quanto por meio de cobrança recorrente.
Criando a Carteira de Cobrança
- Acesse o menu Sistema.
- Abra a pasta Financeiro.
- Clique em Carteira de cobrança.
- Clique no botão Novo.
Aviso!
Antes de realizar qualquer configuração, vá até a aba Impressão e selecione no campo Layout de Impressão o modelo: Boleto + fatura detalhada.
Como essa integração não gera documento em papel, essa configuração garante que ao solicitar a impressão, uma fatura detalhada seja gerada.
- Na aba Carteira de cobrança, realize os seguintes ajustes:
- Descrição: Nome da carteira que será cadastrada.
- Conta: Crie a conta que armazenará os dados bancários.
- Tipo de recebimento: Selecione a opção Cartão de crédito.
- Enviar e-mail para cliente ao gerar: Marque como Não, pois exige que o cliente tenha um e-mail válido e faz o envio automático da fatura, o que não é recomendado neste caso.
- Validar filial na venda: Marque como Não.
- Ativo: Marque como Sim.
- Filial: Remova clicando no X à direita do campo.
- Planejamento analítico: Use o código 240 ou crie um novo conforme a necessidade.
Criando a Conta
- Conta: Escolha um nome para a conta.
- Tipo da Conta: Selecione a opção Banco.
- Data de abertura: Data em que a conta está sendo criada.
- Planejamento analítico: Mais informações em: Contas Contábeis Analíticas.
- Filial: Escolha o ID da filial à qual a Conta e a Carteira estarão ligadas.
Na aba Banco:
- Banco: Selecione o ID da instituição conforme o cadastro nacional de bancos. Neste caso, escolha:
- **
273 - modobank - Cooperativa de Crédito Sulcredi Amplea****`
- **
- Agência: Coloque o número da agência.
- Dígito verificador da agência: Informe o dígito da agência.
- Número da conta: Número da conta bancária.
- Dígito verificador da conta: Informe o dígito da conta.
Configurações Cartão de Crédito
- Gateway: Selecione modobank.
- Ambiente gateway: Escolha Produção.
- Client ID: Insira a credencial de ID da aplicação de API.
- Client Secret: Insira a credencial chave de segurança da aplicação de API.
- Repassar taxa para o cliente: Marque Sim para incluir a taxa da transação na fatura ou Não para manter o valor original da fatura.
Redirecionar Taxas
Melhoria!
O Sistema agora permite repassar a taxa de cartão ao cliente (válido para pagamentos únicos e recorrentes), o que está previsto por lei.
Se selecionar Repassar taxa para o cliente como Sim, novos campos aparecerão:
- Será aplicada em pagamentos: Escolha entre Individuais, Recorrentes ou Ambos.
- Porcentagem da taxa (%): Percentual que será adicionado à fatura.
- Valor fixo da taxa (R$): Valor fixo em Reais acrescido ao pagamento com Cartão de Crédito.
Aviso!
Ao escolher Individuais, aplica-se somente aos pagamentos únicos feitos na Central do Assinante. Ao escolher Recorrentes, aplica-se apenas nas cobranças programadas. Com Ambos, aplica-se para as duas situações.
Juros/Multas/Desconto
- Juros %: Valor sugerido de 0.033% (valor legal).
- Multa %: Valor sugerido de 2% (valor legal).
- Desconto até o vencimento R$: Valor fixo em Reais para pagamento antecipado.
- Desconto até o vencimento %: Percentual de desconto para pagamento antecipado.
Mais informações: Juros, Multas e Desconto.
Dica!
Após todas as configurações, clique em Salvar para finalizar.
Ativando a Carteira de Cobrança no Sistema
Com a carteira criada, você pode ativá-la de duas formas:
- Hotsite (Central do Assinante): Configure a carteira nos parâmetros gerais do Sistema para que todos os clientes tenham acesso a essa forma de pagamento.
- Alternativa de Pagamento: Crie vínculos personalizados para disponibilizar essa carteira a grupos específicos de clientes.
Configurando a Carteira no Hotsite - Central do Assinante
- Vá ao menu Sistema.
- Clique em Hotsite.
- Acesse a pasta Configurações.
- Clique em Configurações Geral.
- Vá até a aba Financeiro.
- Defina os parâmetros de Cartão de Crédito e Recorrência com Cartão de Crédito.
- Clique em Salvar.
Dica!
Consulte o passo a passo completo no guia: Configurar Recorrência com Cartão de Crédito.
Configurando a Carteira como Alternativa de Pagamento
- Crie um cadastro de Alternativa de Pagamento de acordo com Configurações Alternativas de Pagamento.
- Acesse o menu Sistema > Cadastros > Financeiro > Carteira de cobrança e localize a carteira desejada.
- Clique em Editar.
- Em Configuração de alternativa de pagamento, informe o ID ou utilize a Lupa para buscar a alternativa criada.
- Clique em Salvar para finalizar.
Concluído!
Apenas contratos que usam essa carteira com a alternativa de cartão configurada poderão utilizar a forma de pagamento via cartão.
Tarefa de Baixa de Títulos em Recorrência
Para que os pagamentos recorrentes sejam efetivados, é necessário configurar uma tarefa no Sistema. Os pagamentos são enviados no dia do vencimento.
- Vá ao menu Ferramentas.
- Clique em Ferramentas.
- Acesse Agenda de tarefas.
- Clique em Novo.
- Tarefa: Escolha Baixar títulos cartão de crédito recorrente.
- Minuto (0-59): Informe o minuto de execução.
- Hora (0-23): Defina a hora de execução.
Dica!
Configure a tarefa para rodar apenas uma vez por dia, em horário que não coincida com outras tarefas.
Fluxo de Integração
sequenceDiagram participant S as Sistema participant API as API modobank participant W as Webhook S->>API: Envia requisição (ex: gerar fatura) API->>S: Responde com dados da fatura Note over API,W: Evento ocorre (ex: pagamento) W->>S: Notifica sobre o evento S->>API: Confirma recebimento da notificação
Considerações Finais
A integração entre a modobank e o Sistema representa uma grande melhoria, tornando os processos financeiros mais simples e automáticos. Com isso, é possível reduzir custos operacionais e oferecer um serviço mais eficiente para os clientes, contribuindo para um modelo de negócio mais sustentável.
Etiquetas
IntegracaoFinanceira modobank PagamentosOnline CartaoDeCredito APImodobank Recorrencia
