> ## 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.

# Gestión de Clientes

> Gestiona las relaciones con los clientes, rastrea el historial de compras y proporciona opciones de autoservicio a través del panel de control y la API de Dodo Payments.

## Descripción General

La función de Clientes en Dodo Payments ofrece un centro centralizado para gestionar todas tus relaciones con clientes. Rastrea cada interacción con el cliente, consulta el historial de compras, administra suscripciones, accede a los registros de transacciones de wallet y habilita opciones de autoservicio, todo desde un único panel.

<CardGroup cols={2}>
  <Card title="Customer Dashboard" icon="table-columns">
    Vea y gestione a todos los clientes en un solo lugar con opciones de búsqueda y filtrado.
  </Card>

  <Card title="Customer Wallets" icon="wallet">
    Gestiona saldos monetarios prepago, financia wallets y realiza el seguimiento del historial de transacciones.
  </Card>

  <Card title="Customer Portal" icon="id-card">
    Permita que los clientes gestionen por sí mismos sus suscripciones, facturas y claves de licencia.
  </Card>

  <Card title="API Management" icon="code">
    Cree, actualice y recupere programáticamente los datos de los clientes a través de la API.
  </Card>
</CardGroup>

## Accediendo a la Página de Clientes

<Steps>
  <Step title="Navigate to Customers">
    Desde el panel, haga clic en **Sales > Customers** en el menú de navegación.
  </Step>

  <Step title="View Customer List">
    La página de Clientes mostrará una lista de todos los clientes actuales y pasados que han interactuado con su empresa.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/dodopayments/IKECEhkZu9f1KFmK/images/customer/customers-list.png?fit=max&auto=format&n=IKECEhkZu9f1KFmK&q=85&s=d110d27ad8c3fa8e623241b62d47601c" alt="Página de lista de clientes mostrando todos los clientes con sus detalles" style={{ maxHeight: '500px', width: 'auto' }} width="1662" height="782" data-path="images/customer/customers-list.png" />
</Frame>

## Información del Cliente

En la **Página de Clientes**, puedes ver una visión general completa de toda tu base de clientes. La tabla muestra todos los clientes con la siguiente información:

### Columnas de la Lista de Clientes

* **Customer Name**: El nombre completo del cliente con un indicador de avatar.
* **Customer Id**: Un identificador único (por ejemplo, `cus_5fpsWAa...`) para cada cliente.
* **Email**: La dirección de correo electrónico del cliente para comunicaciones y acceso al portal.
* **Phone Number**: El número de teléfono del cliente (si se proporciona).
* **Created At (UTC)**: La fecha y hora en que se creó la cuenta del cliente.
* **Invite**: Botón de acción rápida para compartir invitaciones al Portal del Cliente.

### Características de la Página

* **Editar Columnas**: Personaliza qué columnas se muestran en la tabla de clientes.
* **Generar Informe**: Genera informes personalizados basados en tus datos de clientes.
* **Buscar**: Encuentra rápidamente clientes específicos por nombre, correo electrónico o ID de cliente.
* **Paginación**: Navega a través de tu lista de clientes con filas ajustables por página.

<Tip>
  Utilice la función "Editar columnas" para personalizar su vista y mostrar solo la información más relevante para su flujo de trabajo.
</Tip>

## Página de Detalles del Cliente

Haz clic en cualquier cliente para ver su página de información detallada, que incluye:

<Frame>
  <img src="https://mintcdn.com/dodopayments/IKECEhkZu9f1KFmK/images/customer/customer-details.png?fit=max&auto=format&n=IKECEhkZu9f1KFmK&q=85&s=4f1d97a2d31f5e64fb4a075dde6239ff" alt="Página de detalles del cliente mostrando la información del cliente y el historial de transacciones" style={{ maxHeight: '500px', width: 'auto' }} width="1657" height="931" data-path="images/customer/customer-details.png" />
</Frame>

### Sección Acerca de

La sección Acerca de muestra la información básica del cliente:

* **Nombre**: Nombre completo del cliente
* **Correo Electrónico**: Dirección de correo electrónico del cliente
* **ID del Cliente**: Identificador único para fines de API y seguimiento
* **Creado En**: Marca de tiempo de cuándo se creó la cuenta del cliente

### Pestañas de Actividad del Cliente

La página de detalles del cliente incluye tres pestañas para ver diferentes aspectos de la actividad del cliente:

<Tabs>
  <Tab title="Transactions History">
    Vea todas las transacciones de pago de este cliente, que incluyen:

    * **Payment ID**: Identificador único de transacción
    * **Status**: Estado del pago (Successful, Failed, Pending, Refunded)
    * **Amount**: Cantidad de la transacción
    * **Date (UTC)**: Fecha en que ocurrió la transacción
    * **Pricing Type**: Tipo de tarifa (compra única o suscripción)
    * **Payment Method**: Método de pago utilizado (Card, UPI, etc.)
    * **Customer Email**: Correo electrónico asociado con la transacción
    * **Refund**: Acción rápida para iniciar reembolsos
    * **Actions**: Opciones adicionales para gestionar la transacción
  </Tab>

  <Tab title="Active Subscriptions">
    Vea todas las suscripciones activas de este cliente:

    * Detalles del plan de suscripción
    * Ciclo de facturación y fecha de renovación siguiente
    * Estado de la suscripción
    * Opciones para gestionar o cancelar suscripciones
  </Tab>

  <Tab title="Wallet Ledger">
    Consulta el libro mayor de transacciones del wallet del cliente, que muestra:

    * Todas las adiciones y deducciones de fondos

    * Saldo actual del wallet en cada moneda (USD, INR)

    * Motivos y marcas de tiempo de las transacciones

    * Historial detallado de transacciones para conciliación
      Consulta el libro mayor de crédito del wallet del cliente, que muestra:

    * Todas las transacciones de crédito y débito

    * Saldo actual del wallet en cada moneda

    * Motivos y marcas de tiempo de las transacciones

    * Historial detallado de transacciones para conciliación
  </Tab>
</Tabs>

<Note>
  La pestaña Libro Mayor del Wallet ofrece total transparencia en las transacciones del wallet del cliente, lo que facilita el seguimiento de adiciones, deducciones de fondos y saldos monetarios actuales.
</Note>

## Portal del Cliente

El Portal del Cliente es un área segura hospedada de autoservicio donde tus clientes pueden gestionar sus suscripciones, ver el historial de facturación, acceder a claves de licencia y actualizar su perfil, sin contactar con soporte.

### Capacidades del Portal

Los clientes pueden acceder al portal para:

* **Ver historial de facturación**: Consulta todas las transacciones pasadas y descarga facturas.
* **Gestionar suscripciones**: Cancela o consulta detalles de suscripciones.
* **Recuperar claves de licencia**: Accede a todas las claves de licencia asociadas a sus compras.
* **Actualizar perfil**: Cambia nombre, correo electrónico o número de teléfono.

<Card title="Learn More About Customer Portal" icon="id-card" href="/features/customer-portal">
  Explora documentación detallada sobre las funciones del portal, métodos de acceso y ejemplos de integración.
</Card>

## Wallets de Clientes

Las Wallets de Clientes son cuentas de saldo monetario prepago para tus clientes. Cada cliente recibe automáticamente un wallet que puede contener fondos reales en múltiples monedas (USD e INR), que se pueden aplicar a facturas de suscripción, usar para saldos de reembolso o financiar con bonos promocionales.

### Características clave

* **Compatibilidad multimoneda**: Realiza el seguimiento de los saldos monetarios en USD e INR por separado.
* **Saldos prepago**: Los clientes pueden mantener fondos que se aplican a futuras facturas y pagos de suscripción.
* **Historial de transacciones**: Consulta el libro mayor completo de todas las adiciones y deducciones de fondos.
* **Diseño centrado en API**: Agrega, deduce y consulta saldos de wallet programáticamente.
* **Facturación basada en crédito**: Permite que los clientes compren créditos por adelantado y los gasten en tus servicios.
* **Historial de transacciones**: Consulta el libro mayor completo de todos los créditos y débitos.
* **Diseño centrado en API**: Agrega, elimina y consulta saldos de wallet programáticamente.

<Card title="Learn More About Customer Wallets" icon="wallet" href="/features/customer-wallet">
  Explora documentación detallada, ejemplos de código y mejores prácticas para gestionar los saldos de wallet de los clientes.
</Card>

## Gestión de API

## Gestión de API

Dodo Payments proporciona una API REST completa para la gestión programática de clientes. Puedes crear, recuperar, actualizar y administrar clientes completamente a través de la API.

### Endpoints de API disponibles

<CardGroup cols={2}>
  <Card title="Create Customer" icon="user-plus" href="/api-reference/customers/create-customer">
    Crea un nuevo cliente en tu cuenta de Dodo Payments con sus datos.
  </Card>

  <Card title="List Customers" icon="list" href="/api-reference/customers/get-customers">
    Recupera una lista paginada de todos los clientes asociados a tu cuenta.
  </Card>

  <Card title="Get Customer Details" icon="user" href="/api-reference/customers/get-customers-1">
    Obtén información detallada de un cliente específico mediante su ID.
  </Card>

  <Card title="Update Customer" icon="pen" href="/api-reference/customers/patch-customer">
    Actualiza la información de un cliente, como nombre, correo electrónico o metadatos.
  </Card>

  <Card title="Delete Payment Method" icon="trash" href="/api-reference/customers/delete-payment-method">
    Elimina un método de pago guardado de la cuenta de un cliente.
  </Card>

  <Card title="Create Portal Session" icon="arrow-up-right-from-square" href="/api-reference/customers/create-customer-portal-session">
    Genera un enlace de sesión seguro para el Portal del Cliente para un cliente específico.
  </Card>
</CardGroup>

<Note>
  Todos los endpoints de la API requieren autenticación usando tu clave de API. Siempre usa tu clave secreta del lado del servidor y nunca la expongas en código del lado del cliente.
</Note>
