Clientes

Saiba como usar o recurso Customer com o Stripe Billing.

O recurso Customer é essencial na Stripe. Use-o para armazenar todos os dados de perfil, faturamento e impostos necessários para cobrar assinaturas e faturas 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 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.

Você pode criar e gerenciar clientes na página Clientes quando não quiser usar código para criar um cliente ou se quiser cobrar manualmente uma fatura avulsa do cliente.

Observação

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.

Para criar um cliente:

Verifique se o cliente já não existe.
Clique em Adicionar cliente ou pressione N na página Clientes.
É obrigatório informar o Nome e o E-mail da conta do cliente.
Clique em Adicionar cliente no diálogo.

Editar um cliente

Para editar o perfil de um cliente:

Encontre o cliente que deseja modificar e clique no nome na página Clientes.
Na página de informações da conta, selecione Ações > Editar dados.
Faça as alterações no perfil do cliente.
Clique em Atualizar cliente.

Excluir um cliente

Para excluir um cliente:

Encontre o cliente que deseja excluir na página Clientes.
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.

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 Stripe Apps de afiliados e de indicados para configurar e gerenciar programas de indicados e afiliados com a Stripe, obter dados de clientes e automatizar ajustes de comissão no 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 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.

Armazene o ID do cliente interno do seu aplicativo no atributo metadados. Como a maioria dos recursos da Stripe, o Customer inclui um hash do objeto Metadata 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 de cobrança (faturamento, notas de crédito etc.) e de envio (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. 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.

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. Ela explica os campos personalizados, o conteúdo do rodapé das faturas e como personalizar o número da fatura.

Pagamento

Todos os pagamentos são cobrados de acordo com os dados de pagamento de um cliente. Cada cliente pode pagar de várias formas, incluindo:

Os clientes têm uma única moeda, ou seja, depois de você atribuir uma moeda, faturar o cliente ou definir um saldo de crédito do cliente, não pode alterar a moeda. Esse estado 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:

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, status de isenção fiscal e endereços.

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.

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.

Crie o cliente.
Defina seu catálogo de produtos e preços.
Crie uma assinatura 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. Todas as alterações serão aplicadas ao próximo ciclo de faturamento, quando uma nova fatura é gerada usando o estado mais recente do cliente para renderizar PDFs, e-mails e a página da fatura hospedada. Leia Como funcionam as assinaturas 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.

Crie o cliente.
Crie um rascunho de fatura adicionando os itens da fatura com descrição, quantidade, preço unitário e alíquota.
Defina a forma de pagamento da fatura. 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.
Finalize a fatura.

Consulte a documentação sobre faturas avulsas 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 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 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 para ver mais detalhes.

Definir a moeda de um cliente

A propriedade currency é um código ISO de moeda de três letras que especifica a moeda usada para fazer cobranças recorrentes de um cliente. Para definir a moeda no Dashboard, acesse a página Clientes > Detalhes e clique em Atualizar detalhes. Após definir a moeda, não é possível alterá-la. Criar uma fatura ou saldo de crédito para o cliente também define permanentemente a moeda do cliente.