> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Customer Management
> Manage customer relationships, track purchase history, and provide self-service options through the Dodo Payments dashboard and API.
## Overview
O recurso Customers no Dodo Payments fornece um hub centralizado para gerenciar todos os seus relacionamentos com clientes. Acompanhe cada interação do cliente, visualize o histórico de compras, gerencie assinaturas, acesse livros-razão de transações da carteira e habilite opções de autoatendimento — tudo a partir de um único painel.
View and manage all customers in one place with search and filtering capabilities.
Gerencie saldos monetários pré-pagos, financie carteiras e acompanhe o histórico de transações.
Empower customers to self-manage subscriptions, invoices, and license keys.
Programmatically create, update, and retrieve customer data via API.
## Accessing the Customers Page
From the dashboard, click on **Sales > Customers** in the navigation menu.
The Customers Page will display a list of all current and past customers who have interacted with your business.
## Customer Information
On the **Customers Page**, you can see a comprehensive overview of your entire customer base. The table displays all customers with the following information:
### Customer List Columns
* **Customer Name**: The full name of the customer with an avatar indicator.
* **Customer Id**: A unique identifier (e.g., `cus_5fpsWAa...`) for each customer.
* **Email**: The customer's email address for communication and portal access.
* **Phone Number**: The customer's phone number (if provided).
* **Created At (UTC)**: The date and time when the customer account was created.
* **Invite**: Quick action button to share Customer Portal invites.
### Page Features
* **Edit Columns**: Customize which columns are displayed in the customer table.
* **Build Report**: Generate custom reports based on your customer data.
* **Search**: Quickly find specific customers by name, email, or customer ID.
* **Pagination**: Navigate through your customer list with adjustable rows per page.
Use the "Edit Columns" feature to customize your view and show only the information most relevant to your workflow.
## Customer Details Page
Click on any customer to view their detailed information page, which includes:
### About Section
The About section displays core customer information:
* **Name**: Customer's full name
* **Email**: Customer's email address
* **Customer ID**: Unique identifier for API and tracking purposes
* **Created At**: Timestamp of when the customer account was created
### Customer Activity Tabs
The customer details page includes three tabs for viewing different aspects of customer activity:
View all payment transactions for this customer including:
* **Payment ID**: Unique transaction identifier
* **Status**: Payment status (Successful, Failed, Pending, Refunded)
* **Amount**: Transaction amount
* **Date (UTC)**: When the transaction occurred
* **Pricing Type**: Whether it's a one-time purchase or subscription
* **Payment Method**: Payment method used (Card, UPI, etc.)
* **Customer Email**: Email associated with the transaction
* **Refund**: Quick action to initiate refunds
* **Actions**: Additional options for managing the transaction
View all active subscriptions for this customer:
* Subscription plan details
* Billing cycle and next renewal date
* Subscription status
* Options to manage or cancel subscriptions
Visualize o livro-razão de transações da carteira do cliente exibindo:
* Todas as adições e deduções de fundos
* Saldo atual da carteira em cada moeda (USD, INR)
* Motivos das transações e carimbos de data/hora
* Histórico detalhado de transações para conciliação
Visualize o livro-razão de crédito da carteira do cliente exibindo:
* Todas as transações de crédito e débito
* Saldo atual da carteira em cada moeda
* Motivos das transações e carimbos de data/hora
* Histórico detalhado de transações para conciliação
A aba Wallet Ledger fornece transparência completa nas transações da carteira do cliente, facilitando o rastreamento de adições, deduções e saldos monetários atuais.
## Portal do Cliente
O Customer Portal é uma área segura e hospedada de autoatendimento onde seus clientes podem gerenciar assinaturas, visualizar histórico de faturamento, acessar chaves de licença e atualizar o perfil — sem precisar contatar o suporte.
### Capacidades do Portal
Os clientes podem acessar o portal para:
* **Visualizar Histórico de Faturamento**: Ver todas as transações passadas e baixar faturas.
* **Gerenciar Assinaturas**: Cancelar ou visualizar detalhes da assinatura.
* **Recuperar Chaves de Licença**: Acessar todas as chaves de licença vinculadas às compras.
* **Atualizar Perfil**: Alterar nome, e-mail ou número de telefone.
Explore documentação detalhada sobre recursos do portal, métodos de acesso e exemplos de integração.
## Carteiras dos Clientes
As Carteiras dos Clientes são contas de saldo monetário pré-pago para seus clientes. Cada cliente recebe automaticamente uma carteira que pode conter fundos reais em múltiplas moedas (USD e INR), que podem ser aplicados às faturas de assinatura, usados para saldos de reembolso ou financiados com bônus promocionais.
### Recursos Principais
* **Suporte a Múltiplas Moedas**: Acompanhe saldos monetários em USD e INR separadamente.
* **Saldos Pré-pagos**: Os clientes podem manter fundos que serão aplicados a futuras faturas e pagamentos de assinatura.
* **Histórico de Transações**: Visualize o livro-razão completo de todas as adições e deduções de fundos.
* **Design API-First**: Adicione, deduza e verifique saldos de carteira programaticamente.
* **Cobrança Baseada em Créditos**: Permita que os clientes comprem créditos antecipadamente e os utilizem em seus serviços.
* **Histórico de Transações**: Visualize o livro-razão completo de todos os créditos e débitos.
* **Design API-First**: Adicione, remova e verifique saldos de carteira programaticamente.
Explore documentação detalhada, exemplos de código e melhores práticas para gerenciar saldos da carteira do cliente.
## Gerenciamento de API
O Dodo Payments fornece uma API REST abrangente para o gerenciamento programático de clientes. Você pode criar, recuperar, atualizar e gerenciar clientes inteiramente por meio da API.
### Endpoints de API Disponíveis
Crie um novo cliente em sua conta Dodo Payments com os detalhes dele.
Recupere uma lista paginada de todos os clientes associados à sua conta.
Obtenha informações detalhadas sobre um cliente específico pelo ID dele.
Atualize as informações de um cliente, como nome, e-mail ou metadados.
Remova um método de pagamento salvo da conta de um cliente.
Gere um link de sessão seguro do Portal do Cliente para um cliente específico.
Todos os endpoints da API requerem autenticação usando sua chave de API. Sempre use sua chave secreta no lado do servidor e nunca a exponha no código do lado do cliente.