Pular para o conteúdo
Criar conta
ou
Entrar
O logotipo da documentação da Stripe
/
Pergunte à IA
Criar conta
Login
Comece já
Pagamentos
Receita
Plataformas e marketplaces
Gestão de valores
Recursos para desenvolvedores
Visão geral
Billing
Visão geralSobre as APIs do Billing
Assinaturas
Invoicing
    Visão geral
    Como o faturamento funciona
    Início rápido de API
    Integrar com a API
    Faturamento sem código
    Ciclo de vida da fatura
    Visualizar faturas
    Editar faturas
    Programar finalização de fatura
    Transições de status e finalização
    Enviar e-mails aos clientes
    Gerar notas de crédito
    Faturar clientes
    Clientes
    Saldo de crédito do cliente
    IDs fiscais dos clientes
    Pagamentos por fatura
    Página da fatura hospedada
    Criar planos de pagamento de fatura
    Aceitar pagamentos parciais
    Formas de pagamento para faturas
    Cobranças automáticas
    Personalização de faturas
    Personalizar faturas
    Modelos de renderização de fatura
    Agrupar itens de linha de fatura
    Resumir itens de linha
    Faturamento global
    Práticas recomendadas
    Clientes multimoedas
    Outros recursos de faturamento
    Produtos e preços
    Gerenciar itens de linha de faturas em lote
    Impostos
Cobrança por uso
Cotações
Gerenciamento de clientes
Cobrança com outros produtos
Recuperação de receitas
Automações
Teste sua integração
Tributos
Visão geral
Usar Stripe Tax
Gerenciar conformidade
Relatórios
Visão geral
Selecionar um relatório
Configurar relatórios
API de relatórios
Relatórios para várias contas
Reconhecimento de receitas
Dados
Visão geralEsquema
Relatórios personalizados
Data Pipeline
Gerenciamento de dados
Página inicialReceitaInvoicing

Saldo de crédito do cliente

Saiba como trabalhar com os saldos de crédito dos clientes.

Tipos de saldo de cliente

Esta página descreve os saldos de crédito dos clientes, que são ajustes emitidos para os clientes e aplicados a faturas futuras. É um conceito diferente dos saldos em dinheiro, que são relacionados à forma de pagamento do saldo do cliente. Para saber mais, consulte Transferência bancária. Como explicamos a seguir, alguns recursos funcionam de forma diferente para clientes com saldo em dinheiro.

Cada cliente tem um saldo de crédito, que pode ser usado para emitir:

  • Ajuste de crédito: você deve dinheiro ao cliente.
  • Ajuste de débito: o cliente deve dinheiro a você.

Esses ajustes são agregados a um saldo de crédito, que pode ser aplicado às próximas faturas. Como a Stripe calcula o saldo de crédito a partir de um livro-razão (uma lista imutável de transações de débito e crédito), isso proporciona uma trilha de auditoria das transações do cliente. Essas transações de saldo do cliente podem fazer referência ao objeto indicado no ajuste (como nota de crédito, fatura ou metadados).

Estes são alguns casos de uso comuns para os saldos de crédito do cliente:

  • Emitir uma nota de crédito para criar um crédito que reduz o valor devido na próxima fatura.
  • Marca uma fatura como paga e movimenta o valor devido para o saldo de crédito como débito. Isso ocorre quando o valor devido em uma fatura é inferior ao menor valor cobrável. Essa função só existe para usuários sem cash balance.

Saldos de crédito

Quando trabalhar com saldos de crédito, lembre-se:

  • O saldo de crédito é aplicado automaticamente à próxima fatura finalizada de um cliente.
  • Não é possível escolher uma fatura específica para aplicação do saldo de crédito.
  • O saldo de crédito está na moeda do cliente.
  • Clientes com saldo em dinheiro não podem manter um saldo positivo. Em outras palavras, não podem aumentar o valor devido na próxima fatura.

Créditos e débitos

Créditos são valores negativos (uma redução no valor devido pelo cliente) que você pode aplicar à próxima fatura. Por outro lado, débitos são valores positivos (um aumento no valor devido pelo cliente) que você pode aplicar à próxima fatura.

Transações

Todas as modificações no saldo de crédito são tratadas como transações. Após a criação de uma transação, somente as propriedades description ou metadata podem ser alteradas. Não é possível editar outras propriedades ou excluir uma transação.

Tipos de transação

Todas as transações criadas com a API ou no Dashboard são do tipo adjustment e representam um débito ou crédito que você aplica manualmente ao cliente. Esta tabela descreve os valores de type:

TipoDescrição
adjustmentUma transação de ajuste criada especificamente para debitar ou creditar o saldo de crédito. Esse é o único tipo de transação que você pode criar usando integrações com a API e o Dashboard.
applied_to_invoiceRastreia a aplicação de crédito a uma fatura vinculada.
credit_noteRastreia a criação de crédito para uma nota de crédito e a fatura associada.
invoice_too_smallQuando o valor devido em uma fatura é inferior ao menor valor cobrável da Stripe, e o cliente não tem saldo em dinheiro, a fatura é debitada do saldo de crédito e adicionada ao valor devido na próxima fatura.
invoice_too_largeQuando o valor devido em uma fatura é superior ao maior valor cobrável da Stripe, e o cliente não tem saldo em dinheiro, a fatura é debitada do saldo de crédito e adicionada ao valor devido na próxima fatura.
unapplied_from_invoiceRastreia a anulação de um saldo de crédito aplicado de uma fatura vinculada. Associado a uma transação ‘applied_to_invoice’ anterior.
unspent_receiver_creditQuando fundos não gastos em fontes do favorecido associados a um cliente sem saldo em dinheiro não são cobrados integralmente depois de 60 dias, a Stripe cobra automaticamente esses fundos em seu nome e credita o seu saldo. Quando isso ocorre, a Stripe também cria uma transação de crédito correspondente.
initialRepresenta o valor inicial do saldo de crédito quando o cliente é criado usando a API com um balanço de crédito diferente de zero.

Desfazer uma transação

A única forma de desfazer uma transação é revertê-la com uma nova transação. Por exemplo, se você creditou US$ 10 para um cliente, precisa debitar o mesmo valor do cliente em uma nova transação para que uma cancele a outra.

Modificar o saldo de crédito

Você pode modificar o saldo de crédito de um cliente usando o Dashboard ou a API.

Você pode modificar o saldo de crédito de um cliente na página Clientes do Dashboard criando um ajuste de transação de saldo do cliente.

Na página Clientes, clique no cliente e em Ajustar saldo em Saldo de crédito. Defina Tipo de ajuste, Moeda (disponível apenas para clientes sem uma moeda definida), Valor e uma nota interna.

Observação

A nota interna é vista apenas pelos usuários do Dashboard.

Adicionar um novo ajuste de transação de saldo do cliente

Histórico de transações de saldo

Para auditar os ajustes de saldo de um cliente, acesse a página Clientes e role até a seção Saldo de crédito, que exibe o valor atual do saldo de crédito do cliente.

Saldos em dinheiro do cliente

Os clientes que usam a forma de pagamento transferências bancárias têm um objeto cash balance com uma ou mais moedas no objeto available. Você pode usar os fundos para fazer pagamentos ou pagar faturas. Clientes com saldos disponíveis apresentam o seguinte comportamento:

  • Não é possível criar um saldo negativo de cliente, pois isso representa dinheiro enviado do Customer.

  • Não é possível finalizar uma fatura muito pequena ou muito grande com o saldo em dinheiro (por exemplo, criando uma assinatura de 0,01 USD). Saiba mais sobre valores mínimos e máximos.

  • Você pode excluir Customers que têm um saldo em dinheiro, mas somente se o saldo em dinheiro for 0.

  • Não é possível remover o saldo em dinheiro de um Customer.

Veja também

  • Dados da Stripe
Esta página foi útil?
SimNão
Precisa de ajuda? Fale com o suporte.
Participe do nosso programa de acesso antecipado.
Confira nosso changelog.
Dúvidas? Fale com a equipe de vendas.
LLM? Read llms.txt.
Powered by Markdoc