Customers

Aprende a utilizar el recurso Customer con Stripe Invoicing.

Crea un cliente por cada empresa o usuario nuevo al que le quieras facturar. Al crear un cliente nuevo, define un perfil básico de cliente que te ayude a generar facturas más útiles y habilita Smart Retries (si eres usuario de Invoicing Plus). Después de configurar el cliente, podrás emitir facturas únicas o crear suscripciones.

Precaución

Antes de crear un nuevo cliente, asegúrate de que el cliente no exista en el Dashboard. Si creas varias entradas de clientes para el mismo cliente, puedes tener problemas más adelante, por ejemplo, cuando necesites conciliar el historial de transacciones o coordinar los métodos de pago guardados.

Puedes crear y administrar clientes en la página Clientes cuando no quieras usar código para crear clientes o si quieres facturarle una factura puntual a un cliente manualmente.

Nota

También puedes crear un cliente en el Dashboard mientras generas una factura.

Crear un cliente

When you create a new customer, you can set their account and billing information, such as Email, Name, and Country. You can also set a customer’s preferred language, currency, and other important details.

To create a customer, complete these steps:

Verifica que el cliente no exista.
Click Add customer, or press N, on the Customers page.
Como mínimo, ingresa el nombre y el correo electrónico de la cuenta de tu cliente.
Click Add customer in the dialog.

Edit a customer

Para editar el perfil de un cliente, sigue estos pasos:

En la página Clientes, busca el cliente que quieras modificar y haz click en su nombre.
In the account information page, select Actions > Edit information.
Make your changes to the customer profile.
Haz click en Actualizar cliente.

Eliminar un cliente

Para eliminar un cliente, sigue estos pasos:

Find the customer you want to delete on the Customers page.
Click the checkbox next to your customer’s name followed by Delete. You can also click into the customer’s details page and select Actions > Delete customer.

Perfiles de clientes

Utiliza el perfil básico del cliente para la generación de facturas y recibos o como sistema ligero de gestión de la relación con el cliente (CRM) para tu aplicación. Para crear un perfil básico de cliente, debes definir las siguientes propiedades:

Email address.
Nombre del cliente.
Metadata with a reference to your application’s internal customer ID.

Stripe utiliza la dirección de correo electrónico de los clientes para notificarles los pagos fallidos. También utiliza esta dirección para notificarles cuándo deben llevar a cabo una acción para completar un pago.

Guarda el ID interno del cliente para tu aplicación en el atributo metadata. Como la mayoría de los recursos de Stripe, el recurso Customer incluye el hash del objeto Metadata para almacenar de forma 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. Te recomendamos almacenar los ID de clientes de Stripe en el modelo de cliente interno de tu aplicación.

Direcciones de facturación y envío

Usa los atributos de dirección para definir una dirección de facturación para generar facturas y notas de crédito. Para el envío de bienes físicos, debes agregar una dirección de envío.

Nota

Las facturas, las notas de crédito y los recibos muestran la dirección de facturación. Es un requisito habitual de cumplimiento de la normativa fiscal.

Email and PDF language localization

Al crear un cliente, usa el menú desplegable Idioma para definir su idioma de preferencia. (También puedes agregar o editar el idioma de preferencia en la página Datos del cliente o al crear una factura). Stripe utilizará este idioma para localizar las facturas que se envíen por correo electrónico y en PDF, los recibos que se envíen por correo electrónico y en PDF, y las notas de crédito en PDF.

Para actualizar el idioma en la API, usa el parámetro preferred_locales. Este parámetro acepta una lista de idiomas ordenados por preferencia. Estos valores de configuración regional preferidos se basan en la normativa RFC-4646, por ejemplo, “en” para inglés o “fr-CA” para francés canadiense. Para obtener más información, consulta la página Idiomas preferidos del cliente.

Propiedades de cliente

La siguiente tabla contiene propiedades de cliente adicionales:

Property	Description
Propiedades de pago	Stripe cobra los pagos usando los datos de pago asociados al cliente, y cada cliente puede tener varias modalidades de pago, entre las que se incluyen la API Payment Methods y el saldo acreedor del cliente. Los clientes tienen una sola moneda, lo que quiere decir que una vez que asignaste una moneda, facturaste o definiste un saldo acreedor de cliente, ya no puedes cambiar la moneda. Este bloqueo es visible en el Dashboard, en el menú desplegable Moneda, que estará desactivado. Si tienes que facturarle a una misma entidad en varias monedas, debes crear un nuevo cliente para cada moneda.
Invoicing properties	Todos los recursos relacionados con la facturación se asocian al cliente al que se le está facturando.
Tax properties	Para cumplir con los requisitos fiscales de cada jurisdicción, es posible que debas incluir en las facturas los números de identificación fiscal y otros datos del cliente. Eres responsable de que las facturas contengan la información correcta. Esto incluye las identificaciones fiscales, la condición de exención fiscal y las direcciones. Las identificaciones fiscales permiten guardar y procesar uno o más números de identificación fiscal en las facturas. La condición de exención fiscal indica si la entidad está sujeta a impuestos o no. El valor predeterminado del parámetro `tax_exempt` de un cliente es `none`, lo que significa que es una entidad con facturación sujeta a impuestos. Sin embargo, puedes definir `tax_exempt` en `reverse` para los clientes que deben pagar el impuesto de la factura. También puedes marcar al cliente como exento estableciendo el estado en `exempt`. Puedes obtener más información sobre el uso de `tax_exempt` y `reverse` en la página sobre Tasas impositivas.

Tareas habituales

Here are some of the common tasks you can perform with the Customer resource:

Enviar una factura a un cliente: después de crear el cliente, puedes enviarle una factura.
**Almacenar el saldo acreedor de un cliente **: la funcionalidad de saldo acreedor del cliente te permite asignar ajustes de crédito y débito a un cliente específico, y luego aplicar el saldo resultante a las facturas futuras de ese cliente.
Agregar y validar números de identificación fiscal: por lo general, se exige exhibir la identificación fiscal del cliente en las facturas. Con Stripe, puedes agregarle a un solo cliente varias identificaciones fiscales. Las identificaciones 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 Identificaciones fiscales de clientes.
Agregar un cupón a un cliente: un cupón contiene información sobre un porcentaje o un importe de descuento. Con Stripe Invoicing, puedes asociar un cupón a un cliente. El cupón aplica un descuento al importe adeudado de la factura, antes de los impuestos.
Configurar la moneda de un cliente: con el Dashboard, puedes configurar la moneda predeterminada para cobrar las facturas de un cliente. Para ello, navega a la página Clientes, selecciona a tu cliente y haz clic en Editar, que se encuentra junto a Detalles. Consulta la página Clientes en varias monedas para obtener más información sobre cómo facturar al mismo cliente con una moneda diferente a su moneda predeterminada.
Crear clientes de manera masiva: carga clientes de forma masiva mediante las Productivity Stripe Apps.