Pular para o conteúdo principal

Métodos de Pagamento

Bem-vindo ao guia de Métodos de Pagamento do CMS E-commerce! Este manual irá ajudá-lo a criar, gerenciar e configurar os métodos de pagamento personalizados disponíveis no sistema.

Visão Geral​

A tela de Métodos de Pagamento permite que você:

  • 📋 Visualize todos os métodos cadastrados no sistema
  • 🔍 Filtre métodos por nome e status (Ativo/Inativo)
  • ➕ Crie novos métodos com configurações completas
  • ✏️ Edite métodos existentes para atualizar dados
  • 🗑️ Exclua métodos que não são mais necessários
  • 💰 Configure limites financeiros (valores mínimo e máximo)
  • 📊 Defina taxas de juros aplicáveis
  • 📅 Estabeleça prazos de vencimento
  • 🔄 Ative ou desative métodos conforme necessário

Os métodos de pagamento personalizados permitem que você configure opções específicas de pagamento para sua loja, como boleto bancário, pagamento em dinheiro, transferência bancária, entre outros.

Acessando a Tela de Métodos de Pagamento​

A tela de métodos de pagamento está localizada no menu de Checkout do sistema. Ao acessá-la, você verá:

  • Título "Métodos de Pagamento"
  • Subtítulo "Gerencie os métodos de pagamento do sistema."
  • Botão "Criar Método"
  • Barra de busca
  • Filtro de status
  • Seletor de itens por página
  • Tabela com os métodos cadastrados

Tela de métodos de pagamento

Como Buscar e Filtrar Métodos de Pagamento​

Busca por Nome​

A barra de busca permite encontrar métodos de pagamento específicos por nome:

Como usar:

  1. Digite o nome do método no campo de busca (ex: "Boleto", "PIX", "Dinheiro")
  2. Pressione Enter para realizar a busca
  3. Os resultados serão filtrados automaticamente

Barra de busca

Dica

Use nomes completos ou parciais. Por exemplo, digite "Bol" para encontrar "Boleto 21 dias" ou métodos relacionados.

Filtro por Status​

Você pode filtrar os métodos de pagamento por seu status:

Como usar:

  1. Clique no filtro de Status
  2. Selecione:
    • Ativo: Métodos disponíveis para uso
    • Inativo: Métodos desativados
  3. Os resultados serão filtrados automaticamente
  4. Clique em Limpar filtro para remover o filtro

Filtro de status

Métodos por Página​

Para facilitar a navegação, você pode ajustar quantos métodos são exibidos por vez:

  1. Localize o seletor "Pagamentos por página"
  2. Escolha entre: 10, 15, 20, 25, 30 métodos por página
  3. Use a paginação no rodapé da tabela para navegar

Entendendo a Tabela de Métodos de Pagamento​

A tabela exibe as seguintes informações:

Colunas da Tabela​

ColunaDescrição
NomeNome do método (Ex: Boleto 21 dias, PIX, Dinheiro)
DescriçãoDescrição breve sobre o método de pagamento
StatusBadge visual indicando se o método está Ativo (verde) ou Inativo (cinza)

Indicadores Visuais​

  • As linhas da tabela são clicáveis para acessar os detalhes do método
  • Ao passar o mouse sobre uma linha, ela fica destacada
  • Badge verde: Método ativo e disponível para uso
  • Badge cinza: Método inativo

Tabela de métodos

Como Criar um Novo Método de Pagamento​

Passo a Passo para Criar​

Passo 1: Clique em "Criar Método"​

No canto superior direito da tela, clique no botão "Criar Método".

Botão Criar Método

Passo 2: Preencha as Informações Básicas​

Um modal será aberto com duas seções. Comece preenchendo as Informações Básicas:

  1. Nome (obrigatório): Digite o nome do método (Ex: "Boleto 21 dias", "Boleto 28 dias")
  2. Status (obrigatório): Selecione "Ativo" ou "Inativo"
  3. Descrição (opcional): Adicione uma descrição sobre o método

Modal de criação - Informações Básicas

Campos Obrigatórios:

  • ✅ Nome: Identificador principal do método
  • ✅ Status: Define se o método está disponível para uso

Campos Opcionais:

  • Descrição: Informações sobre o método e suas características
Dica de Nomenclatura

Use nomes descritivos que incluam informações importantes, como prazo de vencimento ou condições especiais. Exemplos: "Boleto 21 dias", "Boleto 28 dias".

Passo 3: Preencha as Configurações Financeiras​

Na seção Configurações Financeiras, você pode definir:

  1. Valor Mínimo (R$) (opcional): Valor mínimo para usar este método
  2. Valor Máximo (R$) (opcional): Valor máximo permitido
  3. Taxa de Juros (%) (opcional): Taxa de juros aplicada
  4. Dias para Vencimento (opcional): Prazo em dias (0 = à vista)

Modal de criação - Configurações Financeiras

Detalhes dos Campos:

  • Valor Mínimo: Define o valor mínimo da compra para usar este método
  • Valor Máximo: Define o valor máximo permitido
  • Taxa de Juros: Percentual que será aplicado sobre o valor da transação
  • Dias para Vencimento:
    • 0: Pagamento à vista
    • Número maior que 0: Prazo em dias (ex: 21 para boleto com vencimento em 21 dias)
Configuração de Valores

Se você deixar os valores em branco, o sistema considerará como "0.00". É recomendado preencher limites mínimos e máximos para evitar transações inválidas.

Passo 4: Confirme a Criação​

  1. Revise os dados preenchidos
  2. Clique no botão "Criar Método"
  3. Aguarde a confirmação (você verá "Criando...")
  4. Você será redirecionado automaticamente para a tela de detalhes do novo método

Botão Criar

Sucesso

Após criar o método, você será direcionado para a página de detalhes onde poderá visualizar todas as configurações e fazer edições se necessário.

Visualizando Detalhes de um Método de Pagamento​

Para ver informações completas sobre um método:

  1. Clique em qualquer linha da tabela
  2. Você será direcionado para a tela de detalhes

Tela de detalhes do método

Informações Disponíveis na Tela de Detalhes​

1. Cabeçalho​

  • Nome do método em destaque
  • Descrição do método (se cadastrada)
  • Badge de status: Ativo (verde) ou Inativo (cinza)
  • Botão "Atualizar": Para modificar as informações
  • Botão "Deletar": Para remover o método
  • Botão "Voltar": Para retornar à lista de métodos

Cabeçalho de detalhes

2. Card de Limites Financeiros​

Exibe:

  • Valor Mínimo: Valor mínimo formatado em reais (R$)
  • Valor Máximo: Valor máximo formatado em reais (R$)

Card de limites financeiros

3. Card de Taxa de Juros​

Mostra a taxa de juros aplicada:

  • Taxa aplicada: Percentual formatado (ex: 2.50%)
  • Aviso informativo: Explicação sobre a aplicação da taxa (quando aplicável)

Se houver taxa de juros configurada:

  • Exibe um alerta informativo em azul explicando que a taxa será aplicada sobre o valor da transação

Se não houver taxa:

  • Exibe um hífen (-) indicando que não há taxa

Card de taxa de juros

4. Card de Prazo de Vencimento​

Dias para vencimento:

  • 0 dias: Exibe "À vista"
  • Mais de 0 dias: Exibe o número de dias (ex: "21 dias")
  • Aviso informativo: Explicação sobre o cálculo do prazo (quando aplicável)

Se houver prazo configurado:

  • Exibe um alerta informativo em amarelo explicando que o prazo será calculado a partir da data da compra

Card de prazo

5. Card de Informações Adicionais​

Status do método:

  • ✅ Ativo: "Este método está ativo e disponível para uso"
  • ❌ Inativo: "Este método está inativo e não pode ser utilizado"

Descrição:

  • Se houver descrição cadastrada, exibe em um bloco separado

Card de informações adicionais

6. Card de Informações de Auditoria​

Criação:

  • 👤 Criado por: Nome do usuário que criou
  • 📅 Data de criação: Data e hora da criação

Última Atualização (quando aplicável):

  • 👤 Atualizado por: Nome do usuário que fez a última alteração
  • 📅 Data de atualização: Data e hora da última modificação

Card de auditoria

Como Editar um Método de Pagamento​

Passo a Passo para Editar​

Passo 1: Acesse os Detalhes​

  1. Clique no método desejado na tabela
  2. Na tela de detalhes, clique no botão "Atualizar"

Botão Atualizar

Passo 2: Modifique os Dados​

Um modal será aberto com os dados atuais preenchidos:

Informações Básicas:

  1. Nome: Altere o nome se necessário
  2. Status: Mude entre Ativo e Inativo
  3. Descrição: Atualize ou adicione descrição

Configurações Financeiras:

  1. Valor Mínimo: Atualize o limite mínimo
  2. Valor Máximo: Atualize o limite máximo
  3. Taxa de Juros: Modifique a taxa de juros
  4. Dias para Vencimento: Altere o prazo

Modal de edição

Campos Editáveis

Todos os campos podem ser editados. Apenas Nome e Status são obrigatórios. Os campos financeiros podem ser deixados em branco se desejar.

Passo 3: Salve as Alterações​

  1. Revise as modificações
  2. Clique no botão "Atualizar Método"
  3. Aguarde a confirmação (você verá "Atualizando...")
  4. As informações serão atualizadas automaticamente

Botão Confirmar Atualização

Como Excluir um Método de Pagamento​

Passo a Passo para Excluir​

Importante

A exclusão de um método de pagamento é uma ação irreversível e pode afetar clientes com as formas de pagamentos associadas e pedidos existentes. Tenha certeza antes de prosseguir.

Passo 1: Acesse os Detalhes​

  1. Clique no método desejado na tabela
  2. Na tela de detalhes, clique no botão "Deletar" (vermelho)

Botão Deletar

Passo 2: Confirme a Exclusão​

Um diálogo de confirmação será exibido com:

  • Título: "Confirmar exclusão"
  • Mensagem: Confirmação com o nome do método
  • Aviso: "Esta ação não pode ser desfeita"

Diálogo de confirmação de exclusão

Passo 3: Finalize a Exclusão​

  1. Leia atentamente o aviso
  2. Clique em "Excluir" para confirmar (ou "Cancelar" para desistir)
  3. Aguarde o processamento (você verá "Excluindo...")
  4. Você será redirecionado para a lista de métodos de pagamento

Botão Confirmar Exclusão

Casos de Uso Práticos​

1. Criar Método de Boleto Bancário​

Situação: Você precisa cadastrar uma opção de pagamento por boleto com 21 dias de vencimento.

Como fazer:

  1. Clique em "Criar Método"
  2. Digite "Boleto 21 dias" no campo Nome
  3. Selecione "Ativo" no Status
  4. Adicione a descrição: "Boleto bancário com vencimento em 21 dias após a compra"
  5. Configure o Valor Mínimo: 50.00
  6. Configure o Valor Máximo: 10000.00
  7. Deixe a Taxa de Juros em branco ou 0
  8. Configure Dias para Vencimento: 21
  9. Clique em "Criar Método"

2. Cadastrar PIX à Vista​

Situação: Adicionar uma opção de pagamento instantâneo via PIX.

Como fazer:

  1. Clique em "Criar Método"
  2. Digite "PIX à vista" no campo Nome
  3. Selecione "Ativo" no Status
  4. Adicione descrição: "Pagamento instantâneo via PIX"
  5. Configure o Valor Mínimo: 10.00
  6. Configure o Valor Máximo: 50000.00
  7. Taxa de Juros: 0
  8. Dias para Vencimento: 0 (à vista)
  9. Clique em "Criar Método"

3. Configurar Pagamento em Dinheiro com Desconto​

Situação: Criar um método de pagamento em dinheiro que oferece desconto (representado por taxa negativa).

Como fazer:

  1. Clique em "Criar Método"
  2. Digite "Dinheiro com 5% desconto" no campo Nome
  3. Selecione "Ativo" no Status
  4. Adicione descrição: "Pagamento em dinheiro na entrega com 5% de desconto"
  5. Configure o Valor Mínimo: 0.00
  6. Configure o Valor Máximo: 5000.00
  7. Taxa de Juros: -5.00 (desconto de 5%)
  8. Dias para Vencimento: 0
  9. Clique em "Criar Método"

4. Desativar Temporariamente um Método​

Situação: Você precisa desativar temporariamente um método de pagamento sem excluí-lo.

Como fazer:

  1. Busque o método na lista
  2. Clique no método desejado
  3. Clique em "Atualizar"
  4. Altere o Status de "Ativo" para "Inativo"
  5. Clique em "Atualizar Método"
  6. O método ficará indisponível mas poderá ser reativado depois

5. Atualizar Limites Financeiros​

Situação: Você precisa aumentar o valor máximo permitido em um método de pagamento.

Como fazer:

  1. Acesse os detalhes do método
  2. Clique em "Atualizar"
  3. Modifique o campo "Valor Máximo" para o novo limite
  4. Revise as outras configurações
  5. Clique em "Atualizar Método"
  6. Verifique se os limites foram atualizados no card "Limites Financeiros"

Problemas Comuns e Soluções​

❌ "Nenhum método de pagamento cadastrado"​

Problema: A tabela está vazia e não há métodos cadastrados.

Soluções:

  • Se for seu primeiro acesso, crie métodos clicando em "Criar Método"
  • Se você aplicou filtros de busca, limpe o campo de busca e pressione Enter
  • Limpe o filtro de status clicando em "Limpar filtro"
  • Verifique se você tem permissão para visualizar métodos de pagamento

❌ "Nenhum método de pagamento encontrado com esse filtro"​

Problema: A busca não retornou resultados.

Soluções:

  • Verifique a ortografia do termo buscado
  • Tente termos mais genéricos (ex: "Bol" em vez de "Boleto 21 dias")
  • Limpe o filtro de busca para ver todos os métodos
  • Verifique o filtro de status aplicado
  • Certifique-se de que o método está realmente cadastrado

❌ Erro ao criar método​

Problema: O botão "Criar Método" está desabilitado ou apresenta erro.

Soluções:

  • Verifique se o campo Nome está preenchido (é obrigatório)
  • Verifique se o campo Status está selecionado (é obrigatório)
  • Certifique-se de que os valores numéricos estão no formato correto (use ponto para decimais)
  • Verifique se você tem permissão para criar métodos
  • Se usar valores, certifique-se de que são números válidos

❌ Taxa de juros não é aplicada corretamente​

Problema: A taxa de juros configurada não aparece ou está incorreta.

Possíveis causas e soluções:

  • Formato incorreto: Use ponto (.) para separar decimais, não vírgula
  • Valor não salvo: Certifique-se de clicar em "Criar Método" ou "Atualizar Método"
  • Cache do navegador: Recarregue a página (F5) para ver os valores atualizados

Como corrigir:

  1. Clique em "Atualizar"
  2. Digite a taxa corretamente (ex: 2.50 para 2,50%)
  3. Salve as alterações

❌ Não consigo editar um método​

Problema: O botão "Atualizar" não aparece ou está desabilitado.

Soluções:

  • Verifique se você tem permissão para editar métodos de pagamento
  • Certifique-se de que está na tela de detalhes do método
  • Recarregue a página e tente novamente
  • Entre em contato com o administrador do sistema para verificar suas permissões

❌ Erro ao excluir método​

Problema: A exclusão falha ou retorna erro.

Possíveis causas:

  • O método pode estar vinculado a pedidos existentes
  • Você pode não ter permissão para excluir métodos
  • Pode haver dependências no sistema

Soluções:

  • Primeiro, verifique se há pedidos usando este método
  • Em vez de excluir, considere desativar o método alterando o status para "Inativo"
  • Verifique suas permissões com o administrador
  • Entre em contato com o suporte técnico se o problema persistir

❌ Dias para vencimento não funciona como esperado​

Problema: O prazo de vencimento não é calculado corretamente.

Soluções:

  • Certifique-se de que digitou apenas números inteiros (ex: 21, não 21.5)
  • Para pagamento à vista, use 0 (zero)
  • Verifique se o valor foi salvo corretamente na tela de detalhes
  • O cálculo do vencimento é feito a partir da data da compra

Boas Práticas​

📝 Nomenclatura​

  1. Use nomes descritivos que incluam informações importantes
  2. Inclua o prazo no nome quando aplicável (ex: "Boleto 21 dias")
  3. Indique condições especiais (ex: "Dinheiro com 5% desconto")
  4. Seja consistente com a forma de escrever

Exemplos corretos:

  • ✅ Boleto 21 dias
  • ✅ Transferência bancária 7 dias
  • ✅ Dinheiro na entrega

Exemplos a evitar:

  • ❌ boleto (muito genérico)
  • ❌ Método 1 (não descritivo)
  • ❌ BOLETO 21 DIAS (tudo em maiúsculas)

💰 Configuração de Limites Financeiros​

  1. Defina limites realistas baseados nas políticas da empresa
  2. Configure valor mínimo para evitar transações muito pequenas
  3. Configure valor máximo para controlar riscos
  4. Revise periodicamente os limites conforme necessário

Recomendações:

  • Boleto: mínimo R$ 50,00 (custos de emissão)
  • Dinheiro: máximo R$ 5.000,00 (segurança)
  • Transferência: sem limite máximo ou alto valor

📊 Taxas de Juros​

  1. Use valores decimais com ponto (ex: 2.50 para 2,50%)
  2. Considere custos operacionais ao definir taxas
  3. Use valores negativos para representar descontos
  4. Seja transparente sobre as taxas nas descrições

Exemplos:

  • Taxa de 2,5% ao mês: 2.50
  • Desconto de 5%: -5.00
  • Sem taxa: 0 ou deixe em branco

📅 Prazos de Vencimento​

  1. Use 0 (zero) para pagamento à vista
  2. Configure prazos realistas de acordo com o método
  3. Considere dias úteis ao definir prazos
  4. Documente o prazo na descrição do método

Recomendações por tipo:

  • PIX: 0 (à vista)
  • Boleto: 21 ou 30 dias
  • Transferência: 3 a 7 dias
  • Dinheiro: 0 (na entrega)

🔄 Gerenciamento de Status​

  1. Desative em vez de excluir quando possível
  2. Mantenha métodos inativos para histórico
  3. Teste novos métodos como "Inativo" antes de ativar
  4. Comunique mudanças à equipe quando ativar/desativar

⚠️ Cuidados ao Editar​

  1. Cuidado ao alterar limites financeiros: pode afetar pedidos em andamento
  2. Teste mudanças de taxa antes de aplicar
  3. Comunique alterações importantes à equipe de vendas
  4. Documente as razões das mudanças internamente

Perguntas Frequentes (FAQ)​

Posso ter dois métodos com o mesmo nome?​

Tecnicamente sim, mas não é recomendado. Mantenha nomes únicos para evitar confusão ao processar pedidos e para facilitar a identificação pelos clientes.

O que acontece se eu excluir um método que está em uso?​

A exclusão pode afetar pedidos e clientes que utilizam este método. O sistema pode prevenir a exclusão se houver dependências. É recomendado desativar o método em vez de excluí-lo.

Quantos métodos de pagamento posso criar?​

Não há limite técnico, mas é recomendado criar apenas os métodos realmente necessários para manter a organização e facilitar a escolha pelos clientes.

Como funciona a taxa de juros negativa?​

Uma taxa negativa representa um desconto. Por exemplo, -5.00 significa 5% de desconto sobre o valor da compra. Isso é útil para incentivar pagamentos à vista ou em dinheiro.

Posso configurar parcelamento nos métodos de pagamento?​

Estes métodos são para pagamentos personalizados (boleto, dinheiro no ato da entrega, etc.). O parcelamento é configurado nas integrações com gateways de pagamento de cartão de crédito.

É obrigatório preencher todos os campos financeiros?​

Não. Apenas Nome e Status são obrigatórios. Os campos financeiros (valores mínimo/máximo, taxa, prazo) são opcionais e podem ser deixados em branco ou com valor 0.

O que significa "Dias para Vencimento"?​

É o prazo em dias que será adicionado à data da compra para calcular a data de vencimento do pagamento. Por exemplo, se configurar 21 dias, o vencimento será 21 dias após a data do pedido.

Posso reativar um método que foi desativado?​

Sim! Basta acessar os detalhes do método, clicar em "Atualizar", alterar o Status de "Inativo" para "Ativo" e salvar.

Como faço para criar um método de pagamento à vista?​

Configure o campo "Dias para Vencimento" como 0 (zero). Isso indica que o pagamento deve ser efetuado imediatamente (à vista).

A descrição do método é exibida para o cliente?​

Sim, as informações são exibidas no checkout do cliente.

Suporte​

Precisa de Ajuda?​

Se você encontrou algum problema ou tem dúvidas:

  1. Verifique este manual para soluções comuns
  2. Consulte a seção de Problemas Comuns acima
  3. Entre em contato com o suporte técnico com as seguintes informações:
    • Print da tela ou descrição do problema
    • Nome do método de pagamento (se aplicável)
    • Mensagens de erro exibidas
    • O que você estava tentando fazer

Informações Úteis ao Contatar o Suporte​

Tenha em mãos:

  • Seu nome de usuário
  • Nome do método de pagamento relacionado
  • Valores que está tentando configurar (limites, taxas, prazos)
  • Prints de tela do problema
  • Descrição detalhada do que você tentou fazer

Glossário​

TermoSignificado
Método de PagamentoForma de pagamento disponível para o cliente finalizar a compra
StatusIndica se o método está ativo (disponível) ou inativo (não disponível)
Taxa de JurosPercentual aplicado sobre o valor da transação (pode ser positivo ou negativo)
Valor MínimoMenor valor permitido para usar o método de pagamento
Valor MáximoMaior valor permitido para usar o método de pagamento
Dias para VencimentoPrazo em dias para efetuar o pagamento (0 = à vista)
À vistaPagamento imediato, sem prazo de vencimento
BadgeEtiqueta visual para identificação (ex: Ativo/Inativo)
AuditoriaRegistro de quem criou/modificou e quando
ModalJanela de diálogo que aparece sobre a tela principal
CardBloco visual que agrupa informações relacionadas
Gateway de PagamentoServiço que processa pagamentos online (cartões, etc.)

Próximos Passos​

Após dominar o gerenciamento de métodos de pagamento, você pode:

  • 🛒 Configurar métodos de pagamento no checkout da loja
  • 📊 Analisar quais métodos são mais utilizados
  • 🎯 Criar promoções específicas por método de pagamento
  • 📈 Acompanhar taxas de conversão por método

Bom uso da ferramenta de métodos de pagamento! 🚀