Get Customer Wallets
Consulte os saldos monetários dos clientes em diferentes moedas.
Create Ledger Entry
Adicione ou deduza fundos das carteiras dos clientes.
List Ledger Entries
Consulte o histórico completo de transações com paginação.
O que são carteiras de clientes?
As carteiras de clientes são contas de saldo monetário que mantêm fundos reais para seus usuários. Cada cliente recebe uma automaticamente quando você cria sua conta. Você pode usar essas carteiras para:- Armazenar fundos pré-pagos para futuros pagamentos de assinaturas
- Processar reembolsos como saldo da carteira em vez de reembolsos no cartão
- Emitir saldos promocionais como bônus de boas-vindas ou recompensas de fidelidade
- Aplicar fundos da carteira às faturas automaticamente durante o faturamento
- Acompanhar transações monetárias com um histórico detalhado no livro-razão
Todo cliente recebe automaticamente uma carteira quando você cria a conta dele. As carteiras são compatíveis com as moedas USD, EUR e GBP, com saldos monetários separados para cada uma.

Como funciona
As carteiras de clientes mantêm fundos que os clientes podem aplicar em suas compras. Quando um cliente tem uma fatura ou uma cobrança recorrente de assinatura, o saldo da carteira é verificado primeiro. Todos os fundos disponíveis são aplicados automaticamente à fatura antes da cobrança do método de pagamento principal.Configuração automática
Quando você cria um novo cliente, Dodo Payments cria automaticamente uma carteira com saldo zero. Ela está pronta para receber fundos imediatamente por meio da nossa API.Suporte a várias moedas
Cada carteira pode manter saldos em diferentes moedas:integer
Saldo em dólares americanos (armazenado em centavos)
integer
Saldo em euros (armazenado em centavos)
integer
Saldo em libras esterlinas (armazenado em pence)
Atualmente, apenas os saldos em USD, EUR e GBP estão disponíveis. A carteira nativa em INR foi descontinuada — consulte Estrutura de pagamentos. O INR continua sendo compatível como moeda de transação para assinaturas UPI, RuPay e cartões indianos.
Trabalhando com carteiras
Verificar saldos dos clientes
Veja quanto um cliente tem em todas as moedas. Isso é útil para verificar o saldo disponível antes de processar uma compra ou exibir o saldo na interface do usuário da sua aplicação.Get Customer Wallet Balances
Verifique os saldos monetários da carteira de um cliente em todas as moedas compatíveis.
Adicionar ou deduzir fundos
Adicione fundos às carteiras dos clientes (como bônus de boas-vindas ou saldos de reembolso) ou deduza fundos (como cobranças de assinaturas). Você pode fornecer motivos para cada transação a fim de manter um registro de auditoria claro.O campo
entry_type usa 'credit' para adicionar fundos à carteira e 'debit' para subtrair fundos da carteira.Create Customer Wallet Ledger Entry
Adicione ou deduza fundos da carteira de um cliente.
Ver histórico de transações
Veja todas as transações de crédito e débito de um cliente. Esse registro detalhado ajuda a reconciliar as contas e oferece transparência aos seus clientes.List Customer Wallet Ledger Entries
Veja todas as transações monetárias de um cliente.
Exemplos do mundo real
Reembolso para a carteira
Quando um cliente solicita um reembolso, você pode adicionar o valor ao saldo da carteira dele em vez de realizar um reembolso tradicional no cartão. Isso mantém os fundos no seu ecossistema para compras futuras.Bônus de boas-vindas / Saldo promocional
Ofereça aos novos clientes um bônus monetário de boas-vindas para incentivar a primeira compra.Pagamento de assinatura a partir da carteira
Deduza fundos de uma carteira para cobrir uma cobrança de assinatura ou uma compra manual.Sistema de cobrança pré-paga
Permita que os clientes financiem suas contas antecipadamente e consumam esse saldo ao longo do tempo.1
Add Initial Funds
Adicione fundos à carteira do cliente quando ele fizer um depósito.
2
Apply Balance to Purchases
Deduza o saldo à medida que o cliente usa seus serviços ou renova assinaturas.
3
Monitor Balances
Verifique se os clientes estão ficando sem fundos para solicitar uma recarga.
Suporte a várias moedas
Gerencie saldos monetários separados para clientes em diferentes regiões.US Customers
US Customers
Gerencie fundos em USD para clientes baseados nos EUA.
European Customers
European Customers
Gerencie fundos em EUR para clientes baseados na Europa.
UK Customers
UK Customers
Gerencie fundos em GBP para clientes baseados no Reino Unido.
Práticas recomendadas
Evitar transações duplicadas
Use chaves de idempotência para garantir que você não adicione nem deduza fundos acidentalmente duas vezes para o mesmo evento.Verificar saldos antes de cobrar
Verifique se os clientes têm fundos suficientes antes de tentar processar transações de alto valor a partir da carteira.O que vem a seguir
- Expiração do saldo: defina um prazo para a expiração dos fundos
- Melhores análises: relatórios detalhados de gastos e tendências de saldo
- Mais Webhooks: notificações em tempo real sobre alterações de saldo e alertas de saldo baixo