# Clientes

Saiba como usar o objeto Customer com o Stripe Billing.

O objeto *Customer* (Customer objects represent customers of your business. They let you reuse payment methods and give you the ability to track multiple payments) é uma entidade central na Stripe. Use-o para armazenar todas as informações de perfil, faturamento e impostos necessárias para cobrar um cliente por *subscriptions* (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) e *invoices* (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).

> #### Use a API Accounts v2 para representar clientes
> 
> Também é possível usar objetos `Account` configurados pelo cliente para representar seus clientes. Usar `Accounts` oferece uma forma unificada de representar seus usuários em todos os produtos da Stripe.
> 
> A API Accounts v2 está geralmente disponível para outros usuários do Connect e em prévia pública para outros usuários da Stripe. Saiba mais sobre [como modelar seus clientes como objetos Account configurada pelo cliente](https://docs.stripe.com/accounts-v2/use-accounts-as-customers.md), em vez de usar objetos `Customer`.

## Gestão de clientes

Crie um cliente para cada novo usuário ou empresa que você deseja faturar. Ao criar um novo cliente, defina um [perfil mínimo de cliente](https://docs.stripe.com/billing/customer.md#minimum-customer-profile) ao criar faturas e habilite o Smart Retries (cobrança). Após criar e configurar esse cliente, utilize-o para criar uma assinatura e emitir faturas avulsas.

#### Dashboard

Você pode criar e gerenciar clientes na [página Clientes](https://dashboard.stripe.com/customers) quando não quiser usar código para criar um cliente ou se quiser cobrar manualmente uma fatura avulsa do cliente. Você também pode criar um cliente no Dashboard durante a criação da fatura.

### Criar um cliente

Quando cria um cliente, você pode definir dados da conta e de faturamento, como **E-mail**, **Nome** e **País**, assim como o idioma preferido, a moeda e outros dados importantes do cliente.

Para criar um cliente:

1. Verifique se o cliente já não existe.

2. Clique em **Adicionar cliente** ou pressione **N** na página **Clientes**.

3. É obrigatório informar o **Nome** e o **E-mail da conta** do cliente.

4. Clique em **Adicionar cliente** no diálogo.

### Editar um cliente

Para editar o perfil de um cliente:

1. Encontre o cliente que deseja modificar e clique no nome na página **Clientes**.

2. Na página de informações da conta, selecione **Ações** > **Editar dados**.

3. Faça as alterações no perfil do cliente.

4. Clique em **Atualizar cliente**.

### Excluir um cliente

Para excluir um cliente:

1. Encontre o cliente que deseja excluir na página **Clientes**.

2. Clique na caixa de seleção ao lado do nome do cliente e depois em **Excluir**. Também é possível clicar na página de dados do cliente e selecionar **Ações** > **Excluir cliente**.

#### API

Antes de faturar um cliente, crie um objeto Customer que pode ser configurado com nome, e-mail e forma de pagamento. Saiba mais no [guia de integração](https://docs.stripe.com/billing/subscriptions/build-subscriptions.md). Confira um exemplo básico:

```curl
curl https://api.stripe.com/v1/customers \
  -u "<<YOUR_SECRET_KEY>>:" \
  --data-urlencode "email=jenny.rosen@example.com" \
  -d payment_method=pm_card_visa \
  -d "invoice_settings[default_payment_method]=pm_card_visa"
```

Veja como [criar um cliente](https://docs.stripe.com/api/customers/create.md) com a API para obter uma lista completa de parâmetros.

## Propriedades disponíveis e usos

O recurso Cliente possui diversas propriedades que podem ser configuradas para personalizar o faturamento. Esta seção explica as propriedades que podem ser armazenadas no Cliente e os efeitos de cada uma.

### Perfil do cliente

Utilize um perfil básico de cliente para geração de faturas e recibos. Ele pode, em geral, atuar como um sistema leve de gerenciamento de relacionamento com o cliente (CRM) para sua aplicação. Você também pode utilizar [aplicativos de afiliados e indicação da Stripe](https://marketplace.stripe.com/categories/affiliate_and_referrals) para configurar e gerenciar programas de indicação e afiliados com a Stripe, obter informações de clientes e automatizar ajustes de comissão a partir do Dashboard da Stripe.

#### Perfil mínimo do cliente

Quando criar um cliente, defina estas propriedades:

- E-mail
- Nome do cliente
- Metadados com referência ao ID interno do cliente do aplicativo

Um [e-mail](https://docs.stripe.com/api/customers/object.md#customer_object-email) permite que a Stripe notifique o cliente sobre pagamentos com falha ou quando a finalização de um pagamento exige outras ações no processo de [cobrança automática](https://docs.stripe.com/invoicing/automatic-collection.md).

Armazene o ID do cliente interno do seu aplicativo no atributo [metadados](https://docs.stripe.com/api/customers/object.md#customer_object-metadata). Como a maioria dos recursos da Stripe, o Customer inclui um hash do objeto [Metadata](https://docs.stripe.com/api/metadata.md) para armazenar com flexibilidade informações contextuais de chave-valor. Para ajudar na auditoria e no suporte, armazene seu ID de cliente interno como um par de chave-valor no recurso Customer. Isso permite pesquisar o cliente usando seu ID de referência interno. Por outro lado, recomendamos armazenar IDs de cliente da Stripe em relação ao modelo de cliente interno do seu aplicativo.

#### Endereços de cobrança e envio

Use as propriedades de endereço para definir um [endereço](https://docs.stripe.com/api/customers/object.md#customer_object-address) de cobrança (faturamento, notas de crédito etc.) e de [envio](https://docs.stripe.com/api/customers/object.md#customer_object-shipping) (para mercadorias físicas).

Embora o endereço de entrega seja mais relevante para empresas que entregam bens físicos, utilize o endereço de faturamento quando desejar que ele seja exibido em faturas, notas de crédito e recibos — um requisito comum para conformidade fiscal.

#### Localização do idioma de e-mails e PDFs

Defina a propriedade `preferred_locales` para localizar e-mails e PDFs gerados pela Stripe. Essa propriedade aceita uma lista de idiomas preferidos, ordenados por preferência. Esses valores de localidade preferida são baseados no memorando [RFC-4646](https://tools.ietf.org/html/rfc4646). Alguns exemplos são “en” para o inglês ou “fr-CA” para o francês canadense. Veja mais informações na página [Personalizar faturas](https://docs.stripe.com/invoicing/customize.md#customer-language).

#### Configurações de fatura por cliente

Para obter mais detalhes sobre a personalização de conteúdo de faturas por cliente, consulte a página [Personalizar faturas](https://docs.stripe.com/invoicing/customize.md). Ela explica os [campos personalizados](https://docs.stripe.com/invoicing/customize.md#custom-fields), o conteúdo do [rodapé das faturas](https://docs.stripe.com/invoicing/customize.md#footer-field) e como [personalizar o número da fatura](https://docs.stripe.com/invoicing/customize.md#invoice-numbering-schemes).

### Pagamento

Todos os pagamentos são cobrados de acordo com os dados de [pagamento](https://docs.stripe.com/payments.md) de um cliente. Cada cliente pode pagar de várias formas, incluindo:

- [Formas de pagamento](https://docs.stripe.com/payments/payment-methods.md)
- [Saldo de crédito do cliente](https://docs.stripe.com/billing/customer.md#customer-balance)

Os clientes têm uma [única moeda](https://docs.stripe.com/billing/customer.md#currency), ou seja, depois de você atribuir uma moeda, faturar o cliente ou [definir um saldo de crédito do cliente](https://docs.stripe.com/billing/customer.md#customer-balance), não pode alterar a moeda. Esse status bloqueado é indicado no Dashboard com um menu suspenso **Moeda** desativado.

Se você precisa faturar uma única entidade com várias moedas, crie um cliente para cada moeda.

### Faturamento

Todos os recursos relacionados ao faturamento estão associados ao cliente cobrado. Esses recursos incluem:

- [Itens de fatura pendentes](https://docs.stripe.com/billing/invoices/subscription.md#adding-draft-invoice-items)
- [Assinaturas](https://docs.stripe.com/billing/subscriptions/overview.md)
- [Faturas](https://docs.stripe.com/invoicing/overview.md)
- [Recibos](https://docs.stripe.com/receipts.md)
- [Configurações da fatura](https://docs.stripe.com/api/customers/create.md#create_customer-invoice_settings)

### Dados fiscais

Talvez seja necessário incluir números de ID fiscal do cliente e outros dados nas faturas para cumprir requisitos da jurisdição tributária. Em última análise, é sua responsabilidade garantir que as faturas do cliente contenham os dados corretos, como [IDs fiscais](https://docs.stripe.com/billing/customer/tax-ids.md), [status de isenção fiscal](https://docs.stripe.com/api/customers/create.md#create_customer-tax_exempt) e [endereços](https://docs.stripe.com/billing/customer.md#addresses).

Os IDs fiscais permitem armazenar e exibir um ou mais números de identificação fiscal em faturas. O status de isenção fiscal indica se a entidade está sujeita a tributação. Por padrão, o status `tax_exempt` de um cliente é definido como `none`, o que significa que é uma entidade faturável sujeita a impostos. No entanto, você pode indicar que o cliente é responsável pelo pagamento do imposto em uma fatura definindo a propriedade `tax_exempt` como `reverse`, ou indicar que ele é isento de impostos definindo o status como `exempt`. Você pode saber mais sobre o uso de `tax_exempt` e `reverse` na página de [Tax Rates](https://docs.stripe.com/tax/tax-rates.md#tax-exempt-and-reverse-charge).

## Tarefas comuns

Esta seção explica algumas tarefas comuns que podem ser executadas com o recurso Customer.

### Criar uma assinatura

Antes de criar uma assinatura, você precisa criar um cliente para fins de cobrança.

1. [Criar o cliente](https://docs.stripe.com/billing/customer.md#create-a-customer).
2. Defina seu catálogo de [produtos](https://docs.stripe.com/products-prices/manage-prices.md#create-product) e [preços](https://docs.stripe.com/products-prices/manage-prices.md#create-price).
3. [Crie uma assinatura](https://docs.stripe.com/billing/subscriptions/overview.md) usando o cliente criado na primeira etapa e um ou mais preços definidos na segunda etapa.

Após criar a assinatura, você pode continuar atualizando os dados do cliente até que uma fatura seja [finalizada](https://docs.stripe.com/invoicing.md). Todas as alterações serão aplicadas ao próximo período de cobrança, quando uma nova fatura é gerada usando o status mais recente do cliente para renderizar PDFs, e-mails e a página da fatura hospedada. Leia [Como funcionam as assinaturas](https://docs.stripe.com/billing/subscriptions/overview.md) para obter informações mais detalhadas.

### Enviar uma fatura isolada (manual) a um cliente

Diferentemente das faturas de assinatura, as faturas avulsas são emitidas manualmente e não seguem um cronograma automatizado. Utilize-as para faturamento de pedidos ou serviços pontuais, como tarifas de configuração e instalação, tarifas de consultoria ou pedidos únicos de bens físicos.

1. [Criar o cliente](https://docs.stripe.com/billing/customer.md#create-a-customer).
2. [Crie um rascunho de fatura](https://docs.stripe.com/invoicing/dashboard.md#create-invoice) adicionando os itens da fatura com descrição, quantidade, preço unitário e alíquota.
3. [Defina a forma de pagamento da fatura](https://docs.stripe.com/invoicing/dashboard.md#create-invoice). O pagamento de uma fatura pode ser recebido cobrando automaticamente a forma de pagamento cadastrada ou enviando a fatura por e-mail para o cliente.
4. Finalize a fatura.

Consulte a [documentação sobre faturas avulsas](https://docs.stripe.com/invoicing/dashboard.md#create-invoice) para ver todos os detalhes sobre como criar e receber pagamentos de faturas avulsas.

### Armazenar o saldo de crédito de um cliente

O recurso de [saldo de crédito do cliente](https://docs.stripe.com/billing/customer/balance.md) permite atribuir ajustes de crédito e débito a um cliente específico. O saldo resultante é aplicado a faturas futuras desse cliente.

### Adicionar e validar números de ID fiscal

A exibição do número de ID fiscal de um cliente nos documentos da fatura é um requisito comum. A Stripe permite adicionar um ou mais [IDs fiscais](https://docs.stripe.com/billing/customer/tax-ids.md) a um cliente. Os IDs fiscais do cliente são exibidos no cabeçalho dos PDFs da fatura e da nota de crédito. Consulte a página sobre [IDs fiscais](https://docs.stripe.com/billing/customer/tax-ids.md) para ver mais detalhes.

### Definir a moeda de um cliente

A propriedade `currency` é um [código ISO de três letras para a moeda](https://docs.stripe.com/currencies.md) na qual você cobra o cliente para fins de cobrança recorrente. Você pode definir a moeda no Dashboard acessando **Clientes** > **Detalhes** e clicando em **Atualizar detalhes**. Após definir a moeda, não é possível alterá-la. A criação de uma fatura, item de fatura ou saldo de crédito para o cliente também define permanentemente a moeda do cliente.