Carteira e Créditos (Wallet)
Gerencie a carteira de créditos dos seus clientes. O sistema de carteira permite que os clientes recarreguem saldo com antecedência e usem os créditos para pagar pedidos, com bônus configurável para incentivar recargas maiores.
Pré-requisitos
- Ter uma conta de Dono ativa no DTFPro
- Carteira habilitada em Configurações → Carteira
- Estar logado no painel administrativo em
admin.dtfpro.com.br
Como Funciona a Carteira
Cada cliente possui uma carteira digital individual (pessoa física) ou compartilhada por empresa (pessoa jurídica). O funcionamento é simples:
- O cliente solicita uma recarga de créditos no portal
- O cliente faz o pagamento (Pix) e envia o comprovante
- Você valida a recarga no painel financeiro
- O saldo é creditado na carteira do cliente, já com o bônus aplicado
- O cliente usa o saldo para pagar pedidos diretamente no checkout
Acessar as Carteiras
No menu lateral, clique em Carteira (ou Wallet). Você verá a lista de carteiras com:
- Nome do cliente ou empresa
- Tipo: PF (pessoa física) ou PJ (pessoa jurídica)
- Saldo atual em R$
- Total creditado historicamente
- Total utilizado em pedidos
Consultar Saldo e Extrato de um Cliente
- Na lista de carteiras, clique na carteira do cliente
- Você verá o resumo do saldo atual
- Abaixo, o extrato de transações mostra todas as movimentações (paginado):
- Crédito — recarga validada (valor + bônus)
- Débito — valor utilizado para pagar um pedido
- Data e hora de cada transação
- Referência do pedido (para débitos)
Creditar Manualmente (Sem Recarga pelo Cliente)
Como dono, você pode adicionar créditos diretamente na carteira de um cliente sem passar pelo fluxo de recarga:
- Na lista de carteiras, clique na carteira desejada
- Clique em Adicionar Créditos
- Preencha:
- Valor (R$) — valor a ser creditado
- Observação — motivo do crédito manual (ex: "Bônus de indicação", "Compensação de pedido #PH-0042")
- Clique em Confirmar
O saldo é adicionado imediatamente. Esta operação é registrada no extrato como Crédito Manual.
Atenção
Créditos adicionados manualmente não passam pelo fluxo de comprovante. Use apenas para ajustes, bônus ou compensações.
Validação de Recargas pelo Cliente
Quando um cliente solicita recarga pelo portal, o fluxo passa pelo módulo Financeiro:
- O cliente cria uma solicitação de recarga no portal
- O cliente efetua o pagamento (Pix) e faz upload do comprovante
- A solicitação aparece em Financeiro → Recargas Pendentes
- Você valida ou rejeita a recarga (veja detalhes em Financeiro)
- Ao validar, o crédito é aplicado automaticamente com o bônus
Bônus de Recarga
O bônus incentiva os clientes a recarregarem valores maiores. Configure o percentual em Configurações → Carteira → Percentual de Bônus.
Exemplo com 10% de bônus:
- Cliente recarrega R$ 500,00
- Bônus aplicado: R$ 50,00 (10%)
- Saldo creditado: R$ 550,00
O bônus é aplicado automaticamente ao validar a recarga, sem nenhuma ação adicional.
Carteiras de Empresas (PJ)
Clientes cadastrados como Pessoa Jurídica (empresa) possuem uma carteira compartilhada entre todos os membros da empresa:
- Todos os membros da empresa podem usar o saldo para fazer pedidos
- O administrador da empresa é responsável por gerenciar as recargas
- O extrato mostra quais pedidos consumiram o saldo e qual membro realizou cada pedido
Como o Cliente Usa os Créditos
No checkout do portal ({sua-loja}.dtfpro.com.br), quando a carteira está habilitada:
- O cliente vê o saldo disponível na tela de pagamento
- O cliente escolhe Pagar com Carteira
- O sistema verifica se o saldo é suficiente
- Se o saldo cobrir o pedido inteiro: pagamento concluído sem comprovante
- Se o saldo for parcial: o cliente pode complementar com outro método (Pix, etc.)
Dicas
- Bônus como ferramenta de fidelização — clientes com saldo na carteira têm mais incentivo para fazer novos pedidos
- Carteiras PJ para clientes corporativos — empresas com pedidos recorrentes aproveitam bem o sistema de carteira compartilhada
- Créditos não expiram — por padrão, os créditos não têm data de validade
- Transparência — o cliente pode ver o extrato completo da carteira no portal deles
Problemas Comuns
"O cliente quer usar créditos mas o saldo aparece zerado"
Verifique se a carteira está habilitada em Configurações → Carteira. Verifique também se os créditos foram adicionados na carteira correta — um cliente PF e um cliente PJ (empresa) têm carteiras separadas.
"Adicionei créditos no valor errado"
Não é possível editar ou estornar créditos já adicionados diretamente. Adicione um novo crédito com uma observação explicando o ajuste (ex: "Compensação de crédito em excesso - #PH-0042").
"O cliente diz que o saldo não foi descontado após o pedido"
Verifique no extrato da carteira se há um débito no momento do pedido. Se não houver, o pedido pode ter sido pago por outro método. Consulte o histórico do pedido em Pedidos.
"A recarga foi validada mas o saldo não apareceu"
O saldo é creditado automaticamente ao validar a recarga. Peça ao cliente para atualizar a página do portal. Se ainda não aparecer, entre em contato com o suporte.
"Como desabilito a carteira sem perder os saldos?"
Ao desabilitar a carteira em Configurações → Carteira, a opção de pagamento por carteira é removida do checkout, mas os saldos existentes são preservados. Ao reabilitar, os saldos voltam a estar disponíveis.