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:

Tipo	Descrição
`adjustment`	Uma 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_invoice`	Rastreia a aplicação de crédito a uma fatura vinculada.
`credit_note`	Rastreia a criação de crédito para uma nota de crédito e a fatura associada.
`invoice_too_small`	Quando 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_large`	Quando 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_invoice`	Rastreia 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_credit`	Quando 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.
`initial`	Representa 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

Customers using the bank transfers payment method have a cash balance object with one or more currencies in the available object. You can use the funds to make payments or pay invoices. Customers with available balances have the following behavior:

Não é possível criar um saldo negativo de cliente, pois isso representa dinheiro enviado do Customer.
You can’t finalize a too-small or too-large invoice with the cash balance (for example, creating a subscription for 0.01 USD). Learn more about minimum and maximum amounts.
You can delete Customers that have a cash balance, but only if their cash balance is 0.
Não é possível remover o saldo em dinheiro de um Customer.

Veja também

Dados da Stripe