# Clientes

Saiba como usar o recurso Customer com o Stripe Billing.

Se a sua plataforma Connect utiliza [Contas configuradas pelo cliente](https://docs.stripe.com/api/v2/core/accounts/create.md#v2_create_accounts-configuration-customer), utilize o nosso [guia](https://docs.stripe.com/connect/use-accounts-as-customers.md) para substituir as referências a `Cliente` e eventos no seu código pelas referências equivalentes da API Accounts v2.

O recurso *Customer* (Customer objects represent customers of your business. They let you reuse payment methods and give you the ability to track multiple payments) é essencial na Stripe. Use-o para armazenar todos os dados de perfil, faturamento e impostos necessários para cobrar *assinaturas* (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 *faturas* (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) avulsas dos clientes.

## Gestão de clientes

Crie um cliente para cada novo usuário ou empresa que você deseja faturar. Na criação do cliente, defina um [perfil mínimo de cliente](https://docs.stripe.com/billing/customer.md#minimum-customer-profile) para ajudar a gerar faturas úteis e habilite o Smart Retries (cobrança). Depois de criado e configurado, o cliente pode ser usado para criar uma assinatura e emitir faturas isoladas.

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

> Também é possível 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.

A página **Clientes** também permite realizar estas atividades:

- Filtrar clientes
- Excluir clientes
- Ver todos os clientes
- Exportar uma lista de dados dos clientes

Para criar um cliente:

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

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

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

1. 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**.

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

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

1. Clique em **Atualizar cliente**.

### Excluir um cliente

Para excluir um cliente:

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

1. 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 Customer tem muitas propriedades úteis que podem ser definidas para personalizar o faturamento. Esta seção explica as propriedades que você pode armazenar no recurso Customer e os efeitos de cada uma delas.

### Perfil do cliente

Um perfil de cliente básico é útil para gerar faturas e recibos, e geralmente pode atuar como um sistema de gerenciamento de relacionamento com clientes (CRM) simples para o aplicativo. Você também pode usar [aplicativos da Stripe de afiliados e indicados](https://marketplace.stripe.com/categories/affiliate_and_referrals) para configurar e gerenciar programas de indicados e afiliados com a Stripe, obter dados de clientes e automatizar ajustes de comissão do Stripe Dashboard.

#### 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 um endereço de entrega seja mais importante para empresas que enviam mercadorias físicas, um endereço de cobrança é útil porque é exibido em faturas, notas de crédito e recibos, um requisito comum para a 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 processar um ou mais números de identificação fiscal nas faturas. O status da isenção fiscal indica se a entidade é tributável. Por padrão, o status `tax_exempt` de um cliente é definido como `none`, o que significa que é uma entidade de cobrança tributável. No entanto, você pode sinalizar um cliente como responsável pelo pagamento dos impostos em uma fatura definindo a propriedade `tax_exempt` como `reverse`. Também é possível sinalizá-lo como isento de impostos definindo o status como `exempt`. Saiba mais sobre como usar `tax_exempt` e `reverse` na página [Alíquotas](https://docs.stripe.com/billing/taxes/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. [Crie o cliente](https://docs.stripe.com/billing/customer.md#create).
1. 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).
1. [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

Ao contrário das faturas de assinaturas, as faturas avulsas são emitidas manualmente por você sem seguir um cronograma automático. Com essa característica, elas são úteis para faturar pedidos ou trabalhos independentes, como tarifas de instalação e configuração, tarifas de consultoria ou pedidos avulsos de mercadorias físicas.

1. [Crie o cliente](https://docs.stripe.com/billing/customer.md#create).
1. [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.
1. [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.
1. 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.