# Clientes Saiba como usar o recurso Customer com o Stripe Invoicing. Se sua integração usar [customer-configured Accounts](https://docs.stripe.com/api/v2/core/accounts/create.md#v2_create_accounts-configuration-customer), substitua `Customer` e as referências a eventos nos exemplos de código pelas referências equivalentes da API Accounts v2. Para mais informações, consulte [Representar clientes com objetos Account](https://docs.stripe.com/connect/use-accounts-as-customers.md). Crie um cliente para cada novo usuário ou empresa que você deseja faturar. Na criação do cliente, configure um [perfil mínimo de cliente](https://docs.stripe.com/invoicing/customer.md#customer-profile) para ajudar a criar faturas mais úteis e habilite o Smart Retries (se você for usuário do [Invoicing Plus](https://stripe.com/invoicing/pricing)). Depois de configurar o cliente, você pode emitir faturas avulsas ou criar *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). > Antes de criar um cliente, verifique se ele ainda não existe no Dashboard. Criar várias entradas para o mesmo cliente pode causar problemas posteriormente, como quando você precisa reconciliar o histórico de transações ou coordenar formas de pagamento salvas. #### 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 criar um cliente, verifique se ele ainda não existe. Por exemplo, passe um endereço de e-mail para a API [listar todos os clientes](https://docs.stripe.com/api/customers/list.md). ```curl curl -G https://api.stripe.com/v1/customers \ -u "<>:" \ -d email={EMAIL_ADDRESS} ``` O exemplo a seguir mostra como criar um cliente com um e-mail e uma forma de pagamento padrão. Consulte [criar um cliente](https://docs.stripe.com/api/customers/create.md) para ver uma lista completa de argumentos que podem ser passados para API. ```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" ``` ## Perfis de clientes Use um perfil básico de cliente para gerar faturas e recibos ou como um sistema simples de gestão de relacionamento com clientes (CRM) para o aplicativo. Para criar perfis básicos de cliente, defina estas propriedades: - E-mail. - Nome do cliente. - Metadados com referência ao ID interno do cliente no aplicativo. A Stripe usa o [e-mail](https://docs.stripe.com/api/customers/object.md#customer_object-email) do cliente para notificar falhas de pagamento e usa e-mails para avisar os clientes quando é preciso executar uma ação para finalizar um pagamento. Armazene o ID interno do cliente para seu aplicativo no atributo [metadata](https://docs.stripe.com/api/customers/object.md#customer_object-metadata). Como a maioria dos recursos da Stripe, o recurso `Customer` inclui um hash de objeto [Metadata](https://docs.stripe.com/api/metadata.md) para armazenar com flexibilidade dados contextuais de chave-valor. Armazene o ID interno do cliente como par chave-valor no recurso `Customer` para ajudar em processos de auditoria e suporte. Dessa forma, você pode pesquisar o cliente usando o ID de referência interno. Recomendamos armazenar os IDs de cliente da Stripe no modelo de cliente interno do seu aplicativo. ### Endereços de cobrança e remessa Use os [atributos de endereço](https://docs.stripe.com/api/customers/object.md#customer_object-address) para definir um endereço de cobrança para faturas e notas de crédito. Para a entrega de mercadorias físicas, adicione um endereço de [remessa](https://docs.stripe.com/api/customers/object.md#customer_object-shipping). > Faturas, notas de crédito e recibos exibem um endereço de cobrança, um requisito comum para a conformidade fiscal. ### Localização do idioma de e-mails e PDFs Quando você cria um cliente, use o menu suspenso **Idioma** para adicionar o idioma preferencial (também é possível adicionar ou editar o idioma preferencial de um cliente na página **Detalhes do cliente** ou ao criar uma fatura). A Stripe usa o idioma escolhido para fazer a localização de e-mails e PDFs de faturas, e-mails e PDFs de recibos e PDFs de notas de crédito. Para atualizar o idioma com a API, use o parâmetro [preferred_locales](https://docs.stripe.com/api/customers/object.md#customer_object-preferred_locales). Esse parâmetro aceita uma lista ordenada de idiomas preferenciais organizada por preferência. Esses valores de localidades preferenciais são baseados em [RFC-4646](https://tools.ietf.org/html/rfc4646). Os exemplos incluem en para inglês ou fr-CA para francês canadense. Para saber mais, consulte [Idiomas preferenciais do cliente](https://docs.stripe.com/invoicing/customize.md#customer-language). ## Propriedades do cliente A tabela a seguir contém propriedades adicionais do cliente: | Propriedade | Descrição | | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Propriedades do pagamento | A Stripe usa os detalhes do [pagamento](https://docs.stripe.com/payments.md) associados a um cliente para coletar pagamentos. Um cliente pode ter várias maneiras de fazer um pagamento, incluindo a [API Payment Methods](https://docs.stripe.com/payments/payment-methods.md) e o [saldo de crédito](https://docs.stripe.com/invoicing/customer/balance.md). Os clientes têm uma só moeda. Em outras palavras, depois de você atribuir a moeda, faturar o cliente ou definir um saldo de crédito do cliente, não será mais possível alterá-la. Esse estado bloqueado é indicado no Dashboard com um menu suspenso **Moeda** desativado. Se for preciso cobrar uma única entidade usando várias moedas, crie um cliente para cada moeda. | | Propriedades do faturamento | Todos os [recursos relacionados a faturas](https://docs.stripe.com/api/customers/create.md#create_customer-invoice_settings) estão associados ao cliente faturado. | | Propriedades fiscais | Para cumprir requisitos fiscais da jurisdição, talvez seja preciso incluir os números de ID fiscal do cliente e outras informações relacionadas a impostos em suas faturas. É sua responsabilidade assegurar que as faturas do cliente contenham todas as informações corretas, como [IDs fiscais](https://docs.stripe.com/invoicing/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/invoicing/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`, indicando que é uma entidade de cobrança tributável. No entanto, você pode definir a propriedade `tax_exempt` como `reverse` para os clientes responsáveis pelo pagamento dos impostos da fatura. Também é possível sinalizar os clientes como isentos de impostos definindo o status como `exempt`. Para saber mais sobre como usar `tax_exempt` e `reverse`, consulte [Alíquotas](https://docs.stripe.com/billing/taxes/tax-rates.md#tax-exempt-and-reverse-charge). | ## Tarefas comuns Veja a seguir algumas tarefas comuns que podem ser executadas com o recurso `Customer`: - **Enviar uma fatura a um cliente**: depois de criar o cliente, você pode [enviar uma fatura](https://docs.stripe.com/invoicing/dashboard.md#create-invoice). - **Armazenar o saldo de crédito do cliente**: o recurso de saldo de crédito do cliente permite atribuir ajustes de crédito e débito a um cliente específico e aplicar o saldo resultante em faturas futuras desse cliente. - **Adicionar e validar números de ID fiscal**: a exibição do número de ID fiscal de um cliente em uma fatura é um requisito comum. A Stripe permite adicionar um ou mais IDs fiscais 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 de cliente](https://docs.stripe.com/invoicing/customer/tax-ids.md) para ver mais detalhes. - **Definir a moeda de um cliente**: é possível definir a moeda padrão para cobrar faturas de um cliente usando o Dashboard . Para isso, acesse a página **Clientes**, selecione seu cliente e clique em **Editar** ao lado de **Detalhes**. Consulte a página [Clientes em multimoedas](https://docs.stripe.com/invoicing/multi-currency-customers.md) para obter mais detalhes sobre o faturamento do mesmo cliente usando uma moeda diferente da moeda padrão. - **Criar clientes em lote**: faça upload de clientes em lote usando [Stripe Apps de produtividade](https://marketplace.stripe.com/categories/productivity).