Overview
A página Customers lista todas as pessoas que compraram da sua empresa. Na página de um cliente, você pode consultar os pagamentos e as assinaturas, verificar e ajustar os saldos da carteira, enviar um link do Customer Portal e bloqueá-lo. Os mesmos registros de clientes estão disponíveis pela API.Customer Dashboard
Veja todos os clientes em uma única lista, filtre por nome ou e-mail e abra os detalhes de qualquer cliente.
Customer Wallets
Mantenha saldos pré-pagos que o Dodo Payments aplica às cobranças de assinaturas.
Customer Portal
Permita que os clientes gerenciem suas assinaturas, faturas e chaves de licença por conta própria.
API Management
Crie, atualize e consulte clientes pela API.
Accessing the Customers Page
1
Navigate to Customers
No dashboard, acesse Sales → Customers.
2
View Customer List
A página lista todos os clientes atuais e antigos da sua empresa.
Customer Information
A tabela de clientes mostra uma linha por cliente, com as colunas abaixo.Customer List Columns
- Customer Name: O nome completo do cliente, com um avatar.
- Customer Id: O identificador exclusivo, que começa com
cus_. Use-o nas chamadas de API. - Email: O endereço de e-mail do cliente. O cliente usa esse endereço para fazer login no Customer Portal.
- Phone Number: O número de telefone do cliente, se informado.
- Created At: Quando o registro do cliente foi criado. Passe o cursor sobre o valor para ver o horário em UTC.
- Invite: Um botão Share Invite que abre os links do Customer Portal desse cliente.
Page Features
- Column visibility: Escolha quais colunas a tabela exibe.
- Filters: Encontre clientes por Name ou Email Address.
- Pagination: Navegue pela lista e defina o número de Rows per page.
Customer Details Page
Clique em um cliente para abrir a página Customer Information:
About Section
A parte superior da página mostra os dados principais do cliente:- Name: O nome completo do cliente.
- Email: O endereço de e-mail do cliente.
- Customer ID: O identificador a ser usado na API e em solicitações de suporte.
- Created At: Quando o registro do cliente foi criado.
Abas de atividade do cliente
As abas abaixo dos detalhes mostram a atividade do cliente. As principais são descritas aqui. A página também tem as abas Credits, Entitlements e Sent Emails; consulte Customer Email Logs para ver Sent Emails.- Transactions History
- Active Subscriptions
- Wallets
Os pagamentos, reembolsos e disputas do cliente. A tabela de pagamentos mostra:
- Payment ID: O identificador do pagamento, que começa com
pay_. - Status: O status do pagamento, por exemplo Successful, Failed ou Refunded.
- Amount: O valor do pagamento.
- Date: Quando o pagamento foi criado.
- Pricing Type: Avulso ou assinatura.
- Payment Method: O método de pagamento usado, como cartão ou UPI.
- Customer Email: O endereço de e-mail associado ao pagamento.
- Refund: Um botão Initiate Refund.
- Actions: Mais opções para o pagamento.
A aba Wallets mostra todas as alterações na carteira de um cliente, para que você possa rastrear como o saldo atual foi alcançado.
Bloqueando um cliente
Bloqueie um cliente que cometa fraude ou abuse de reembolsos para impedir que ele faça novas compras com você. O bloqueio cancela as assinaturas ativas do cliente e torna o Customer Portal somente leitura. A página de um cliente bloqueado mostra um selo Blocked, um botão Unblock Customer e um Activity Log com observações que explicam o bloqueio. Gerencie todos os bloqueios em Settings → Blocklist.Customer Blocklist
O que um bloqueio faz, como os e-mails são associados e como bloquear pelo dashboard ou pela API.
Customer Portal
O Customer Portal é um site hospedado de autoatendimento onde seus clientes gerenciam assinaturas, consultam o histórico de cobranças e recuperam chaves de licença sem entrar em contato com o suporte.Recursos do portal
No portal, os clientes podem:- View Billing History: Ver pagamentos anteriores e baixar faturas.
- Manage Subscriptions: Ver detalhes, mudar de plano, pausar ou cancelar, dependendo das suas configurações.
- Retrieve License Keys: Ver as chaves de licença associadas às compras.
- Update Billing Details: Alterar o nome, o endereço de cobrança e o método de pagamento de uma assinatura. O endereço de e-mail e o número de telefone são exibidos, mas não podem ser editados no portal.
Learn More About Customer Portal
Recursos do portal, métodos de acesso e exemplos de integração.
Carteiras de clientes
As Customer Wallets mantêm dinheiro pré-pago para um cliente, com um saldo por moeda. O Dodo Payments aplica o saldo da carteira às cobranças de assinatura do cliente antes de cobrar o método de pagamento. Você adiciona ou deduz fundos com um registro no ledger, por exemplo, para emitir um reembolso como saldo da carteira ou um bônus promocional.Principais recursos
- Multi-Currency Support: Cada moeda tem seu próprio saldo.
- Prepaid Balances: Os fundos são aplicados a futuras renovações de assinatura e cobranças por alteração de plano.
- Transaction History: O ledger registra cada adição e dedução de fundos.
- API-First Design: Consulte saldos e adicione ou deduza fundos pela API ou pela aba Wallets.
Learn More About Customer Wallets
Moedas compatíveis, exemplos de código e práticas recomendadas para saldos de Customer Wallets.
Gerenciamento pela API
A Customers API permite criar, consultar e atualizar clientes, listá-los com filtros e gerenciar seus métodos de pagamento salvos.Endpoints de API disponíveis
Create Customer
Crie um cliente.
name e email são obrigatórios. phone_number e metadata são opcionais.List Customers
Liste os clientes página por página. Filtre por
email, por name (correspondência parcial) ou pela data de criação.Get Customer Details
Consulte um cliente pelo ID.
Update Customer
Atualize o
name, o email, o phone_number ou o metadata de um cliente.Delete Payment Method
Remova um método de pagamento salvo. A solicitação falha com
409 se uma assinatura ativa o utilizar.Create Portal Session
Crie um link do Customer Portal para um cliente, válido por 24 horas.
Todo endpoint exige sua API key. Faça chamadas à API pelo seu servidor e nunca exponha a chave em código do lado do cliente.