# Clientes Cómo usar el «Customer Object» con Stripe Billing. El objeto *Cliente* (Customer objects represent customers of your business. They let you reuse payment methods and give you the ability to track multiple payments) es una entidad central dentro de Stripe. Úsalo para almacenar toda la información de perfil, facturación e impuestos necesaria a fin de facturar a un cliente por *suscripciones* (A Subscription represents the product details associated with the plan that your customer subscribes to. Allows you to charge the customer on a recurring basis) y *facturas* (Invoices are statements of amounts owed by a customer. They track the status of payments from draft through paid or otherwise finalized. Subscriptions automatically generate invoices, or you can manually create a one-off invoice). > #### Usa la API Accounts v2 para representar a los clientes > > También puedes usar objetos `Cuenta` configurados por el cliente para representar a tus clientes. El uso de `Cuentas` te ofrece una forma Unificada de representar a tus usuarios en todos los productos de Stripe. > > La API Accounts v2 está disponible de forma general para los usuarios de Connect, y en versión preliminar pública para otros usuarios de Stripe. Obtén más información sobre [cómo modelar a tus clientes como objetos Account configurados por el cliente](https://docs.stripe.com/accounts-v2/use-accounts-as-customers.md) en lugar de usar objetos `Customer`. ## Gestiona los clientes Crea un cliente para cada nuevo usuario o empresa que quieras facturar. Al crear un nuevo cliente, establece un [perfil mínimo de cliente](https://docs.stripe.com/billing/customer.md#minimum-customer-profile) para ayudar a crear facturas útiles y habilitar Smart Retries (reclamación de pagos). Después de crear y configurar este cliente, utilízalo para crear una suscripción y emitir facturas únicas. #### Dashboard Puedes crear y administrar clientes en la [página Clientes](https://dashboard.stripe.com/customers) cuando no quieras usar código para crear clientes o si quieres facturarle a un cliente de forma manual con una factura por única vez. También puedes crear un cliente en el Dashboard cuando se crea la factura. ### Crear un cliente Cuando creas un cliente nuevo, puedes definir los datos de facturación y de la cuenta, como el **correo electrónico**, el **nombre** y el **país**. También puedes establecer la moneda y el idioma preferidos del cliente, además de cualquier otro dato relevante. Para crear un cliente, sigue estos pasos: 1. Verifica que el cliente no exista. 1. En la página **Clientes**, haz click en **Agregar cliente** o presiona la tecla **N**. 1. Como mínimo, ingresa el **nombre** y el **correo electrónico de la cuenta** de tu cliente. 1. En el cuadro de diálogo, haz click en **Agregar cliente**. ### Editar un cliente Para editar el perfil de un cliente, sigue estos pasos: 1. En la página **Clientes**, busca el cliente que quieras modificar y haz click en su nombre. 1. En la página de datos de la cuenta, haz click en **Acciones** > **Editar información**. 1. Modifica el perfil del cliente. 1. Haz click en **Actualizar cliente**. ### Eliminar un cliente Para eliminar un cliente, sigue estos pasos: 1. En la página **Clientes**, busca el cliente que quieras eliminar. 1. Haz click en la casilla que se encuentra al lado del nombre del cliente y luego en **Eliminar**. También puedes ir a la página de datos del cliente y seleccionar **Acciones** > **Eliminar cliente**. #### API Antes de facturarle al cliente, tienes que crear un objeto Customer que puedes configurar con el nombre, el correo electrónico y el método de pago. Encontrarás más información sobre este tema en la [guía de integración](https://docs.stripe.com/billing/subscriptions/build-subscriptions.md), pero veamos un ejemplo simple: ```curl curl https://api.stripe.com/v1/customers \ -u "<>:" \ --data-urlencode "email=jenny.rosen@example.com" \ -d payment_method=pm_card_visa \ -d "invoice_settings[default_payment_method]=pm_card_visa" ``` Consulta cómo [crear un cliente](https://docs.stripe.com/api/customers/create.md) con la API para obtener una lista completa de parámetros. ## Propiedades y usos disponibles El recurso Cliente tiene muchas propiedades útiles que puedes configurar para personalizar la experiencia de pago. En esta sección, se explican las propiedades que puedes guardar en el cliente y los efectos de cada una. ### Perfil del cliente El perfil básico de un cliente es útil para la generación de facturas y recibos, y puede funcionar como un sistema ligero de administración de relaciones con el cliente (CRM) para tu aplicación. También puedes usar [aplicaciones de Stripe de afiliación y recomendación](https://marketplace.stripe.com/categories/affiliate_and_referrals) para configurar y administrar programas de recomendación y afiliación con Stripe, obtener información de los clientes y automatizar los ajustes de las comisiones del Dashboard de Stripe. #### Perfil básico del cliente Al crear un cliente, establece estas propiedades: - Correo electrónico - Nombre del cliente - Metadatos con una referencia al ID interno del cliente de tu aplicación Con una [dirección de correo electrónico](https://docs.stripe.com/api/customers/object.md#customer_object-email), Stripe puede notificar al cliente si falla un pago o si un pago requiere una acción adicional para completarse, como parte del proceso de [cobro automático](https://docs.stripe.com/invoicing/automatic-collection.md). Guarda el ID interno del cliente de tu aplicación en el atributo [metadata](https://docs.stripe.com/api/customers/object.md#customer_object-metadata). Como muchos recursos de Stripe, el recurso Customer incluye el hash del objeto [Metadata](https://docs.stripe.com/api/metadata.md) para guardar de manera flexible información contextual de clave-valor. Para ayudar en el proceso de auditoría y soporte, guarda el ID interno del cliente como par clave-valor en el recurso Customer. Esto te permite buscar a un cliente usando su ID interno de referencia. En cambio, recomendamos guardar los ID de clientes de Stripe en el modelo interno de cliente de tu aplicación. #### Direcciones de facturación y envío Usa las propiedades de dirección para establecer una [dirección](https://docs.stripe.com/api/customers/object.md#customer_object-address) de facturación (facturas, notas de crédito, etc.) y una dirección de [envío](https://docs.stripe.com/api/customers/object.md#customer_object-shipping) (para bienes tangibles). Mientras que la dirección de envío es muy importante para las empresas que entregan bienes tangibles, la dirección de facturación es útil porque aparece en las facturas, notas de crédito y recibos, un requisito habitual en materia fiscal. #### Localización de idioma en los correos electrónicos y los PDF Localiza los correos electrónicos generados por Stripe y los PDF estableciendo la propiedad `preferred_locales`. Esta propiedad acepta una lista de idiomas ordenados por preferencia. Estos valores de la configuración regional de preferencia se basan en la normativa [RFC-4646](https://tools.ietf.org/html/rfc4646). Dos ejemplos son “en” para inglés o “fr-CA” para francés canadiense. Para obtener más información, consulta la página [Cómo personalizar facturas](https://docs.stripe.com/invoicing/customize.md#customer-language). #### Configuración de facturas por cliente Para obtener más detalles sobre cómo personalizar el contenido de las facturas por cliente, consulta la página [Cómo personalizar facturas](https://docs.stripe.com/invoicing/customize.md). Allí se explica el contenido de los [campos personalizados](https://docs.stripe.com/invoicing/customize.md#custom-fields) y del [pie de la factura](https://docs.stripe.com/invoicing/customize.md#footer-field), y cómo [personalizar el número de factura](https://docs.stripe.com/invoicing/customize.md#invoice-numbering-schemes). ### Pago Todos los pagos se cobran usando los datos de [pago](https://docs.stripe.com/payments.md) asociados con el cliente, y cada cliente puede tener diferentes formas para hacer el pago, entre las que se incluyen: - [Métodos de pago](https://docs.stripe.com/payments/payment-methods.md) - [Saldo acreedor del cliente](https://docs.stripe.com/billing/customer.md#customer-balance) Los clientes tienen [una sola moneda](https://docs.stripe.com/billing/customer.md#currency), es decir, que una vez que les asignas una moneda, les facturas o [estableces un saldo acreedor de cliente](https://docs.stripe.com/billing/customer.md#customer-balance), ya no puedes cambiar la moneda. Este estado bloqueado es visible en el Dashboard en el menú desplegable **Moneda** desactivado. Si necesitas facturar a una sola entidad en varias monedas, crea un cliente nuevo para cada moneda. ### Facturación Todos los recursos relacionados con la facturación se asocian con el cliente al que se le está facturando. Estos recursos incluyen: - [Ítems de factura pendientes](https://docs.stripe.com/billing/invoices/subscription.md#adding-draft-invoice-items) - [Suscripciones](https://docs.stripe.com/billing/subscriptions/overview.md) - [Facturas](https://docs.stripe.com/invoicing/overview.md) - [Recibos](https://docs.stripe.com/receipts.md) - [Configuración de factura](https://docs.stripe.com/api/customers/create.md#create_customer-invoice_settings) ### Datos fiscales Para cumplir con los requisitos fiscales de cada jurisdicción, es posible que debas incluir en las facturas los números de ID fiscal y otros datos del cliente. Tú eres, en última instancia, el responsable de que las facturas contengan la información correcta. Esto incluye las [ID fiscales](https://docs.stripe.com/billing/customer/tax-ids.md), la [condición de cliente exento](https://docs.stripe.com/api/customers/create.md#create_customer-tax_exempt) y las [direcciones](https://docs.stripe.com/billing/customer.md#addresses). Los identificadores fiscales permiten almacenar y mostrar uno o más números de identificación fiscal en las facturas. El estado de exención fiscal indica si la entidad está sujeta a impuestos. De forma predeterminada, el estado `tax_exempt` de un cliente se establece en `none`, lo que significa que es una entidad de facturación sujeta a impuestos. Sin embargo, puedes indicar que un cliente es responsable de pagar el impuesto de una factura si estableces la propiedad `tax_exempt`en `reverse`, o marcarlo como exento de impuestos si configuras el estado en `exempt`. Puedes obtener más información sobre cómo usar `tax_exempt` y `reverse` en la página de [tasas impositivas](https://docs.stripe.com/tax/tax-rates.md#tax-exempt-and-reverse-charge). ## Tareas habituales En esta sección, se explican algunas de las tareas habituales que puedes llevar a cabo con el recurso Cliente. ### Crear una suscripción Antes de crear una nueva suscripción, debes crear un cliente a efectos de la facturación. 1. [Crea el cliente](https://docs.stripe.com/billing/customer.md#create-a-customer). 1. Define el catálogo de [productos](https://docs.stripe.com/products-prices/manage-prices.md#create-product) y los [precios](https://docs.stripe.com/products-prices/manage-prices.md#create-price). 1. [Crea una suscripción](https://docs.stripe.com/billing/subscriptions/overview.md) usando el cliente creado en el paso uno y un precio (o varios) del paso dos. Puedes seguir actualizando la información del cliente después de crear la suscripción hasta que [finalice](https://docs.stripe.com/invoicing.md) la factura. Cualquier cambio se aplicará en el siguiente período de facturación, cuando se genere una nueva factura utilizando el estado más reciente del cliente para mostrarlo en los archivos PDF, los correos electrónicos y la página de facturas alojadas. Consulta la página [Cómo funcionan las suscripciones](https://docs.stripe.com/billing/subscriptions/overview.md) para obtener información más detallada. ### Enviar una factura puntual (manual) a un cliente A diferencia de las facturas de suscripciones, emites una factura manual por única vez que no sigue un calendario automático. Por ello, son útiles para facturar pedidos o trabajos puntuales, como el costo de instalación y configuración, las comisiones por asesoramiento o los pedidos puntuales de bienes tangibles. 1. [Crea el cliente](https://docs.stripe.com/billing/customer.md#create-a-customer). 1. [Crea una nueva factura en borrador](https://docs.stripe.com/invoicing/dashboard.md#create-invoice) agregando ítems de factura con una descripción, la cantidad, el precio por unidad y la tasa impositiva. 1. [Define el método de pago de la factura](https://docs.stripe.com/invoicing/dashboard.md#create-invoice). Puedes cobrar el importe de una factura haciendo el cargo automáticamente en el método de pago guardado o enviando la factura al cliente por correo electrónico. 1. Finaliza la factura. Consulta la [documentación sobre facturas por compras puntuales](https://docs.stripe.com/invoicing/dashboard.md#create-invoice) para aprender en detalle a crear y cobrar pagos de facturas por compras puntuales. ### Almacenar el saldo acreedor de un cliente La función de [saldo acreedor del cliente](https://docs.stripe.com/billing/customer/balance.md) te permite asignar ajustes de crédito y débito a un cliente específico. El saldo resultante se aplica a las futuras facturas de ese cliente. ### Agregar y validar los números de identificación fiscal Generalmente, se exige exhibir el número de ID fiscal del cliente en la documentación de facturación. Con Stripe, puedes agregarle una o varias [ID fiscales](https://docs.stripe.com/billing/customer/tax-ids.md) a un cliente. Las ID fiscales de un cliente aparecen en el encabezado de las facturas y las notas de crédito en PDF. Para obtener más información, consulta la página de [ID fiscales](https://docs.stripe.com/billing/customer/tax-ids.md). ### Definir la moneda de un cliente La propiedad `moneda` es un [código ISO](https://docs.stripe.com/currencies.md) de tres letras que identifica la moneda en la que se cobra al cliente para fines de facturación recurrente. Puedes configurar la moneda en el Dashboard a través de la página **Clientes** > **Información**, haciendo clic en **Actualizar información**. Una vez establecida la moneda, no se puede cambiar. Cuando se crea una factura, una partida de factura o un saldo acreedor para el cliente, también se establece de forma permanente la moneda del cliente.