Clientes
Saiba como usar o recurso Customer com o Stripe Invoicing.
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 para ajudar a criar faturas mais úteis e habilite o Smart Retries (se você for usuário do Invoicing Plus). Depois de configurar o cliente, você pode emitir faturas avulsas ou criar assinaturas.
Cuidado
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.
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 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. Como a maioria dos recursos da Stripe, o recurso Customer inclui um hash de objeto Metadata 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 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.
Observação
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. 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. Os exemplos incluem en para inglês ou fr-CA para francês canadense. Para saber mais, consulte Idiomas preferenciais do cliente.
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 associados a um cliente para coletar pagamentos. Um cliente pode ter várias maneiras de fazer um pagamento, incluindo a API Payment Methods e o saldo de crédito. 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 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, 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_ de um cliente é definido como none, indicando que é uma entidade de cobrança tributável. No entanto, você pode definir a propriedade tax_ 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_ e reverse, consulte Alíquotas. |
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.
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 para ver mais detalhes.
Adicionar um cupom a um cliente: um cupom contém informações sobre um desconto de porcentagem ou valor. O Stripe Invoicing permite associar um cupom a um cliente. Os cupons aplicam um desconto no valor devido (sem impostos inclusos) da fatura.
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 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.