HandyCafe Docs
owner

Metodos de Pagamento

Os Metodos de Pagamento definem as formas como os clientes podem pagar por sessoes, pedidos e outras transacoes no HandyCafe. Cada metodo pode ter uma taxa de comissao e tarifa fixa, que afetam a receita liquida reportada nos seus resumos financeiros.

Criando um Metodo de Pagamento

Para adicionar um novo metodo de pagamento, forneca os seguintes detalhes:

  • Nome -- Um rotulo descritivo para o metodo (por exemplo, Dinheiro, Cartao de Credito, PIX, Crypto, Pagamento Digital).
  • Taxa de Comissao -- A taxa de comissao como porcentagem. Por exemplo, 1% ou 2,5%. Normalmente usada para contabilizar taxas de processadores de pagamento.
  • Tarifa Fixa por Transacao -- Uma tarifa fixa cobrada em cada transacao usando este metodo, independente do valor da transacao. Cobre custos fixos de processamento que alguns provedores de pagamento cobram.

Como as Comissoes Funcionam

Quando uma sessao, pedido ou recarga de carteira e pago usando um metodo que tem comissao configurada, a comissao e calculada da seguinte forma:

valor_comissao = (valor_cobrado * taxa_comissao / 100) + tarifa_fixa

Exemplo

Um metodo de pagamento esta configurado com:

  • Taxa de comissao: 5%
  • Tarifa fixa: R$ 0,50

Um cliente paga R$ 20,00 por uma sessao:

  • Comissao percentual: R$ 20,00 * 5% = R$ 1,00
  • Tarifa fixa: R$ 0,50
  • Comissao total: R$ 1,50
  • Receita liquida: R$ 20,00 - R$ 1,50 = R$ 18,50

Esse calculo garante que seus relatorios reflitam com precisao a receita real retida apos custos de processamento de pagamento.

Pagamentos em Dinheiro

O dinheiro normalmente e configurado com 0% de comissao e sem tarifa fixa, ja que nao ha custos de processamento. No entanto, voce pode atribuir uma comissao ao dinheiro se seu modelo de negocio exigir (por exemplo, para contabilizar custos de manuseio de dinheiro).

Onde os Metodos de Pagamento Aparecem

Os metodos de pagamento configurados estao disponiveis em todo o sistema:

  • Caixas de pagamento de sessao -- Ao encerrar uma sessao, o operador seleciona um metodo de pagamento para registrar como o cliente pagou.
  • Caixas de fechamento de pedido -- Ao concluir um pedido, o operador especifica o metodo de pagamento usado.
  • Recargas de carteira de membro -- Ao adicionar saldo a carteira de um membro, a transacao de recarga registra qual metodo de pagamento foi usado.

O metodo de pagamento selecionado e armazenado com cada registro de transacao, permitindo relatorios financeiros e reconciliacao precisos.

Permissoes

Gerenciar metodos de pagamento requer as seguintes permissoes:

Permissao Descricao
PAYMENT_MANAGE Acesso geral ao gerenciamento de metodos de pagamento
PAYMENT_ADD Criar novos metodos de pagamento
PAYMENT_DELETE Remover metodos de pagamento existentes
PAYMENT_UPDATE Modificar configuracoes de metodos de pagamento existentes

Operadores sem essas permissoes podem usar metodos de pagamento durante transacoes mas nao podem cria-los, modifica-los ou exclui-los.