# Saldo acreedor del cliente Aprende a trabajar con el saldo acreedor del cliente. > #### Tipos de saldo del cliente > > Esta página analiza los saldos acreedores de los clientes, es decir, los ajustes que puedes emitir a clientes y aplicar a *facturas* (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. Los saldos acreedores son diferentes de los saldos de caja, ya que estos últimos están conectados con el [método de pago de saldo del cliente](https://docs.stripe.com/payments/bank-transfers.md). Para obtener más información, consulta la sección [Transferencias bancarias](https://docs.stripe.com/invoicing/bank-transfer.md). Como se explica a continuación, algunas funciones se comportan de manera diferente para los clientes con saldo de caja. Cada cliente tiene un saldo acreedor. Puedes usarlo para emitir: - **Ajuste de crédito**: le debes dinero al cliente. - **Ajuste de débito**: el cliente te debe dinero. Estos ajustes se suman al saldo acreedor que puedes aplicar a facturas futuras. Puesto que Stripe calcula el saldo acreedor a partir del libro mayor —una lista inalterable de las transacciones de débito y crédito—, le proporciona al cliente una pista de auditoría de las transacciones. Estas [transacciones de saldo del cliente](https://docs.stripe.com/api/customer_balance_transactions/object.md) pueden hacer referencia al objeto relacionado con el ajuste, como una [nota de crédito](https://docs.stripe.com/invoicing/dashboard/credit-notes.md), una factura o [metadatos](https://docs.stripe.com/api/metadata.md). Estos son algunos casos comunes donde se usan saldos acreedores de un cliente: - [Cómo emitir una nota de crédito](https://docs.stripe.com/invoicing/dashboard/credit-notes.md#issuing) para generar un crédito que reduzca el importe adeudado en la próxima factura. - La factura se marca como pagada y el importe adeudado pasa al saldo acreedor como un débito. Esto sucede cuando el importe adeudado de una factura es menor que el [importe mínimo cobrable](https://docs.stripe.com/currencies.md#minimum-and-maximum-charge-amounts). Esta funcionalidad solo está disponible para los clientes sin [saldo de caja](https://docs.stripe.com/invoicing/customer/balance.md#cash-balances). ## Saldos acreedores Cuando trabajes con saldos acreedores, ten en cuenta lo siguiente: - El saldo acreedor se aplica automáticamente a la próxima factura finalizada de un cliente. - No puedes elegir una factura específica a la cual aplicar el saldo acreedor. - El saldo acreedor se expresa en la moneda del cliente. - Los clientes con un atributo [cash balance](https://docs.stripe.com/api/customers/object.md#customer_object-cash_balance) no pueden mantener un saldo positivo. En otras palabras, no pueden incrementar el importe por pagar de la próxima factura. ## Créditos y débitos Los créditos son valores negativos (una reducción del importe que debe el cliente) que puedes aplicar a la próxima factura. Por otra parte, los débitos son valores positivos (un aumento en el importe que debe el cliente) que puedes aplicar a la siguiente factura. ## Transacciones Todas las modificaciones al saldo acreedor se registran como [transacciones](https://docs.stripe.com/api/customer_balance_transactions/object.md). Después de haber creado la transacción, solo puedes actualizar `description` o `metadata` (no puedes eliminar ni editar otras propiedades). ### Tipos de transacciones Todas las [transacciones](https://docs.stripe.com/api/customer_balance_transactions/object.md) que creas con la API o en el Dashboard tienen un valor [tipo](https://docs.stripe.com/api/customer_balance_transactions/object.md#customer_balance_transaction_object-type) de `ajuste`. Un valor tipo de `ajuste` representa un débito o crédito que creaste manualmente para el cliente. La siguiente tabla describe cada uno de los valores `tipo`: | Tipo | Descripción | | ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `adjustment` | Una transacción de ajuste creada expresamente para hacer un débito o un crédito en el saldo acreedor. Es el único tipo de transacción que puedes crear usando las integraciones de API y el Dashboard. | | `applied_to_invoice` | Rastrea la aplicación de un crédito hasta la factura vinculada. | | `credit_note` | Rastrea la creación del crédito hasta la [nota de crédito](https://docs.stripe.com/invoicing/dashboard/credit-notes.md) y su factura asociada. | | `invoice_too_small` | Cuando el importe adeudado en una factura es menor que el [importe mínimo cobrable](https://docs.stripe.com/currencies.md#minimum-and-maximum-charge-amounts) de Stripe y el cliente no tiene saldo de caja, la factura se debita del saldo acreedor y se suma al importe adeudado de la próxima factura. | | `invoice_too_large` | Cuando el importe adeudado en una factura es mayor que el [importe máximo cobrable](https://docs.stripe.com/currencies.md#minimum-and-maximum-charge-amounts) de Stripe y el cliente no tiene saldo de caja, la factura se debita del saldo acreedor y se suma al importe adeudado de la próxima factura. | | `unapplied_from_invoice` | Rastrea la revocación de la aplicación de un saldo acreedor desde una factura vinculada. Se asocia a una transacción ‘applied_to_invoice’ anterior. | | `unspent_receiver_credit` | Cuando los fondos no utilizados en [Sources de destinatario](https://docs.stripe.com/sources.md#flow-for-customer-action), asociados a un cliente sin saldo de caja, no se cobran en su totalidad después de 60 días, Stripe automáticamente los cobra en tu nombre y los acredita en tu saldo. Cuando esto sucede, Stripe también crea la transacción de crédito correspondiente. | | `initial` | Representa el valor inicial del saldo acreedor cuando se crea un cliente mediante la API con un saldo acreedor distinto de cero. | ### Deshacer una transacción Una transacción solo se puede deshacer creando otra transacción equivalente de anulación. Por ejemplo, si le acreditas al cliente USD 10 en una transacción, tienes que debitarle USD 10 en una nueva transacción, cada una de las cuales anula a la otra. ## Modificar el saldo acreedor Puedes modificar el saldo acreedor de un cliente a través del Dashboard y la API. #### Dashboard Puedes modificar el saldo acreedor de un cliente a través de la [página de clientes](https://dashboard.stripe.com/customers) en el Dashboard creando un nuevo ajuste de [transacción de saldo del cliente](https://docs.stripe.com/api/customer_balance_transactions/object.md). En la página **Clientes**, haz clic en **Ajustar saldo** bajo **Saldo acreedor**. Desde allí, define el **Tipo de ajuste**, la **Moneda** (solo si el cliente no tiene definida una moneda), el **Importe** y una **nota interna**. > La **nota interna** solo es visible para los usuarios del Dashboard. ![](https://b.stripecdn.com/docs-statics-srv/assets/2-Customer-balance.ed7d6df96ba2b8595461e1091e4da7a9.png) Agregar un nuevo ajuste de transacción de saldo del cliente #### API Para crear un ajuste con la [API Customer Balance](https://docs.stripe.com/api/customer_balance_transactions/create.md), utiliza el siguiente código como referencia: If you represent your customers as [customer-configured Accounts instead of Customers](https://docs.stripe.com/accounts-v2/use-accounts-as-customers.md), pass the `Account` ID instead of the `Customer` ID (for example, `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 ``` ## Historial de transacciones de saldos #### Dashboard Puedes auditar los ajustes de saldo de un cliente en la página de **Clientes**, desplazándote hacia abajo hasta la sección **Saldo acreedor**. En esta sección se ve el valor actual del saldo acreedor del cliente. #### API ### Recuperar transacciones Usa la [API Customer Balance List](https://docs.stripe.com/api/customer_balance_transactions/list.md) para recuperar una lista de todas las transacciones de un cliente. If you represent your customers as [customer-configured Accounts instead of Customers](https://docs.stripe.com/accounts-v2/use-accounts-as-customers.md), pass the `Account` ID instead of the `Customer` ID (for example, `v1/customers/acct_xxxxx/balance_transactions`). ```curl curl https://api.stripe.com/v1/customers/cus_4fdAW5ftNQow1a/balance_transactions \ -u "<>:" ``` ## Saldos de caja del cliente Los clientes que usan el método de pago [transferencias bancarias](https://docs.stripe.com/payments/bank-transfers.md) tienen un [objeto cash balance](https://docs.stripe.com/api/customers/object.md#customer_object-cash_balance) con una o más monedas en el objeto `available`. Puedes usar los fondos para [realizar pagos](https://docs.stripe.com/payments/customer-balance.md#make-cash-payment) o pagar facturas. > #### Gestiona los saldos de caja de las cuentas configuradas por el cliente > > Si usas [cuentas](https://docs.stripe.com/api/v2/core/accounts/object.md#v2_account_object-configuration-customer) configuradas por el cliente para representar a tus clientes, puedes acceder al saldo de caja de una `cuenta` si indicas su ID en lugar del ID del `cliente` (por ejemplo, `v1/customers/acct_xxxxx/balance_transactions`). Los clientes con saldos disponibles presentan el siguiente comportamiento: - No puedes crear un saldo de caja del cliente negativo, ya que representa dinero enviado desde el `Customer`. - No puedes finalizar una factura demasiado pequeña o demasiado grande con el saldo de caja (por ejemplo, creando una suscripción por USD 0.01). Más información sobre [importes mínimos y máximos](https://docs.stripe.com/currencies.md#minimum-and-maximum-charge-amounts). - Puedes eliminar `Customers` que tengan saldo de caja, pero solo si su saldo de caja es 0. - No puedes eliminar el saldo disponible de un objeto `Customer`. ## See also - [Datos de Stripe](https://docs.stripe.com/stripe-data.md)