# 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* (Invoices are statements of amounts owed by a customer. They track the status of payments from draft through paid or otherwise finalized. Subscriptions automatically generate invoices, or you can manually create a one-off invoice) futuras. É um conceito diferente dos saldos em dinheiro, que são relacionados à [forma de pagamento do saldo do cliente](https://docs.stripe.com/payments/bank-transfers.md). Para saber mais, consulte [Transferência bancária](https://docs.stripe.com/invoicing/bank-transfer.md). 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](https://docs.stripe.com/api/customer_balance_transactions/object.md) podem fazer referência ao objeto indicado no ajuste (como [nota de crédito](https://docs.stripe.com/invoicing/dashboard/credit-notes.md), fatura ou [metadados](https://docs.stripe.com/api/metadata.md)). Estes são alguns casos de uso comuns para os saldos de crédito do cliente: - [Emitir uma nota de crédito](https://docs.stripe.com/invoicing/dashboard/credit-notes.md#issuing) 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](https://docs.stripe.com/currencies.md#minimum-and-maximum-charge-amounts). Essa função só existe para usuários sem [cash balance](https://docs.stripe.com/invoicing/customer/balance.md#cash-balances). ## 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](https://docs.stripe.com/api/customers/object.md#customer_object-cash_balance) não podem manter um saldo positivo, ou seja, 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](https://docs.stripe.com/api/customer_balance_transactions/object.md). 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](https://docs.stripe.com/api/customer_balance_transactions/object.md) que você cria com a API ou no Dashboard tem um[ tipo](https://docs.stripe.com/api/customer_balance_transactions/object.md#customer_balance_transaction_object-type) de valor do`ajuste`. Um valor de tipo do`ajuste` representa um débito ou crédito que você criou manualmente para o cliente. A tabela a seguir descreve cada um dos`tipos` de valores: | 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](https://docs.stripe.com/invoicing/dashboard/credit-notes.md) e a fatura associada. | | `invoice_too_small` | Quando o valor devido em uma fatura é inferior ao [menor valor cobrável](https://docs.stripe.com/currencies.md#minimum-and-maximum-charge-amounts) 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](https://docs.stripe.com/currencies.md#minimum-and-maximum-charge-amounts) 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](https://docs.stripe.com/sources.md#flow-for-customer-action) 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. #### Dashboard Você pode modificar o saldo de crédito de um cliente na página [Clientes](https://dashboard.stripe.com/customers) do Dashboard criando um ajuste de [transação de saldo do cliente](https://docs.stripe.com/api/customer_balance_transactions/object.md). Na página **Clientes**, clique no cliente e, em seguida, clique em **Ajustar saldo** em **Saldo de crédito**. A partir daí, defina o **Tipo de ajuste**, a **Moeda** (disponível apenas para clientes sem uma moeda definida), o **Valor** e uma **nota interna**. > A **nota interna** é vista apenas pelos usuários do Dashboard. ![](https://b.stripecdn.com/docs-statics-srv/assets/2-Customer-balance.ed7d6df96ba2b8595461e1091e4da7a9.png) Adicionar um novo ajuste de transação de saldo do cliente #### API Para criar ajustes usando a [API Customer Balance](https://docs.stripe.com/api/customer_balance_transactions/create.md), use este código como referência: Se você representar seus clientes como [Accounts configuradas por clientes, em vez de Customers](https://docs.stripe.com/accounts-v2/use-accounts-as-customers.md), passe o ID de `Account` em vez do ID de `Customer` (por exemplo, `v1/customers/acct_xxxxx/balance_transactions`). ```curl curl https://api.stripe.com/v1/customers/cus_4fdAW5ftNQow1a/balance_transactions \ -u "<>:" \ -d amount=-500 \ -d currency=usd ``` ## Histórico de transações de saldo #### Dashboard 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. #### API ### Recuperar transações Use a [API Customer Balance List](https://docs.stripe.com/api/customer_balance_transactions/list.md) para acessar uma lista de todas as transações de um cliente. Se você representar seus clientes como [Accounts configuradas pelo cliente, em vez de Customers](https://docs.stripe.com/accounts-v2/use-accounts-as-customers.md), passe o ID de `Account` em vez do ID de `Customer` (por exemplo, `v1/customers/acct_xxxxx/balance_transactions`). ```curl curl https://api.stripe.com/v1/customers/cus_4fdAW5ftNQow1a/balance_transactions \ -u "<>:" ``` ## Saldos em dinheiro do cliente Clientes que usam a forma de pagamento [transferências bancárias](https://docs.stripe.com/payments/bank-transfers.md) têm um [objetivo de saldo em dinheiro](https://docs.stripe.com/api/customers/object.md#customer_object-cash_balance) com uma ou mais moedas no objeto `available`. Você pode usar os fundos para [fazer pagamentos](https://docs.stripe.com/payments/customer-balance.md#make-cash-payment) ou pagar faturas. > #### Gerenciar saldos em dinheiro para Accounts configuradas pelo cliente > > Se você usa [Accounts](https://docs.stripe.com/api/v2/core/accounts/object.md#v2_account_object-configuration-customer) configuradas pelo cliente para representar seus clientes, pode acessar o saldo em dinheiro de uma `Account` passando o ID correspondente em vez do ID de `Customer` (por exemplo, `v1/customers/acct_xxxxx/balance_transactions`). Clientes com saldos disponíveis têm 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](https://docs.stripe.com/currencies.md#minimum-and-maximum-charge-amounts). - 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`. ## See also - [Stripe data](https://docs.stripe.com/data.md)