# Saldo de facturación del cliente

Aprende a usar el saldo de facturación del cliente.

Cada cliente en Stripe Billing tiene un saldo de factura contra el cual puedes emitir ajustes de crédito y débito. Los ajustes en el saldo de la factura pueden ser un crédito (lo que significa que les debes dinero) o un débito (lo que significa que ellos te deben dinero). Estos ajustes se suman a un saldo sobre el cliente que puedes aplicar a futuras *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).

Dado que el saldo de la factura se calcula a partir de un libro de contabilidad (una lista inmutable de transacciones de débito y crédito), proporciona un registro de auditoría de las transacciones para el cliente. 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) o un [cliente](https://docs.stripe.com/invoicing/customer.md)), o incluso [a metadatos](https://docs.stripe.com/api/metadata.md) para tu propia referencia.

> #### Usa la API Accounts v2 para representar a los clientes
> 
> La API Accounts v2 suele estar disponible para usuarios Connect y en versión preliminar pública para otros usuarios de Stripe. Si eres parte de la versión preliminar Accounts v2, debes especificar una [versión preliminar](https://docs.stripe.com/api-v2-overview.md#sdk-and-api-versioning) en tu código.
> 
> Para solicitar el acceso a la versión preliminar Accounts v2, 
> 
> Para la mayoría de los casos de uso, te recomendamos que[modeles a tus clientes como objetos Account configurados por el cliente](https://docs.stripe.com/accounts-v2/use-accounts-as-customers.md) en lugar de usar objetos [Customer](https://docs.stripe.com/api/customers.md).

## Ejemplo de casos de uso

Algunos casos de uso comunes de los saldos de facturas de clientes incluyen:

- [Emisión de una nota de crédito](https://docs.stripe.com/invoicing/dashboard/credit-notes.md) para generar un crédito que reduzca el importe adeudado en la próxima factura.
- Los prorrateos por [cambiar a un plan de suscripción inferior](https://docs.stripe.com/billing/subscriptions/change-price.md) indirectamente pueden generar créditos para reducir el importe adeudado en la próxima factura.
- Cuando el importe adeudado en una factura es inferior al [importe mínimo cobrable](https://docs.stripe.com/currencies.md#minimum-and-maximum-charge-amounts), la factura se marca como pagada y el importe adeudado se traslada al saldo de la factura como débito. Esta funcionalidad solo se produce para los clientes que no tienen un [cash_balance](https://docs.stripe.com/billing/customer/balance.md#cash-balances).

## Detalles del saldo de la factura del cliente

Ten en cuenta los siguientes detalles cuando utilices los saldos de las facturas de los clientes:

- El saldo de la factura se aplica automáticamente a la siguiente factura finalizada para un cliente.
- No puedes elegir una factura específica para aplicar el saldo de la factura.
- No puedes elegir no aplicar el saldo de la factura a una factura.
- El saldo de la factura está expresado 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.
- El saldo de la factura no se aplica a las facturas creadas por las sesiones de Checkout con la opción [`invoice_creation`](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-invoice_creation) habilitada.
- No puedes aplicar saldos de factura a facturas creadas anteriormente que aún estén abiertas. Sin embargo, al [editar una factura abierta](https://docs.stripe.com/invoicing/invoice-edits.md), se aplica cualquier saldo de factura a la revisión de la factura.

## Débitos y créditos

Los **valores negativos** son tratados como *crédito* (una reducción en el importe adeudado por el cliente) que puedes aplicar a la próxima factura.

Los **valores positivos** son tratados como *débito* (un incremento en la cantidad que te debe el cliente) que puedes aplicar a la próxima factura.

## Transacciones

Todas las modificaciones en el saldo de la factura se registran como [Transacciones](https://docs.stripe.com/api/customer_balance_transactions/object.md). Una vez creada, solo puede actualizar su `description` o `metadata`, no puedes editar otras propiedades ni borrar una transacción.

### Deshacer una transacción

Solo puedes deshacer una transacción mediante la creación de una transacción inversa correspondiente. Por ejemplo, si le acreditas al cliente 10 USD, debes debitarle al cliente 10 USD en una nueva transacción. De este modo, esta transacción cancela la anterior.

### Tipos de transacción

Todas las [transacciones](https://docs.stripe.com/api/customer_balance_transactions/object.md) creadas con la API o en el Dashboard tienen un valor de [type](https://docs.stripe.com/api/customer_balance_transactions/object.md#customer_balance_transaction_object-type) de `adjustment`, que representa un débito o crédito que creaste manualmente para el cliente.

La propiedad `type` tiene muchos otros valores posibles que representan la fuente de creación y el motivo de la transacción. La siguiente tabla resume y describe cada uno de estos valores `type`:

| Tipo                      | Descripción                                                                                                                                                                                                                                                                                                                                                                             |
| ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `adjustment`              | Una transacción de ajuste creada explícitamente para debitar o acreditar el saldo de la factura. Este es el único tipo de transacción que puedes crear con las integraciones de la API y el Dashboard.                                                                                                                                                                                  |
| `applied_to_invoice`      | Rastrea la aplicación de un crédito hasta la [factura](https://docs.stripe.com/invoicing/overview.md) 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 la [factura](https://docs.stripe.com/invoicing/overview.md) asociada.                                                                                                                                                                                         |
| `invoice_too_small`       | Cuando el importe adeudado de una factura es inferior a nuestro [importe mínimo cobrable](https://docs.stripe.com/currencies.md#minimum-and-maximum-charge-amounts) y el cliente no tiene saldo de caja, debitamos la factura al saldo de la factura y lo sumamos al importe adeudado de la próxima factura emitida.                                                                    |
| `invoice_too_large`       | Cuando el importe adeudado de una factura es superior a nuestro [importe máximo cobrable](https://docs.stripe.com/currencies.md#minimum-and-maximum-charge-amounts) y el cliente no tiene saldo de caja, debitamos la factura del saldo de la factura y la sumamos al importe adeudado de la próxima factura emitida.                                                                   |
| `unapplied_from_invoice`  | Realiza un seguimiento de la reversión del saldo de facturación aplicado desde una [factura](https://docs.stripe.com/invoicing.md) vinculada. Se asocia con una transacción anterior `applied_to_invoice`.                                                                                                                                                                              |
| `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 de la factura del cliente cuando se crea un cliente con la API con un saldo de factura distinto de cero.                                                                                                                                                                                                                                          |

## Modifica el saldo de facturación

#### Dashboard

Puedes modificar el saldo de la factura de un cliente en el Dashboard al crear un nuevo ajuste de [transacción de saldo del cliente](https://docs.stripe.com/api/customer_balance_transactions/object.md) desde la página de detalles del cliente.

En **Saldo de la facturación del cliente**, haz clic en **Ajustar saldo** para mostrar el cuadro modal **Ajuste del saldo de crédito**.

Puedes establecer información sobre el ajuste, como:

- **Tipo de ajuste**: elige crédito o débito
- **Moneda**: disponible solo si el cliente no tiene una moneda establecida.
- **Importe**
- **Nota interna**: Visible para los usuarios del Dashboard, pero no para el cliente
![Cómo ajustar el saldo de la suscripción de un cliente.](https://b.stripecdn.com/docs-statics-srv/assets/2-Customer-balance.ed7d6df96ba2b8595461e1091e4da7a9.png)

#### API

Crea ajustes con la [API Customer Balance](https://docs.stripe.com/api/customer_balance_transactions/create.md) como se muestra en el siguiente ejemplo de programación.

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 "<<YOUR_SECRET_KEY>>:" \
  -d amount=-500 \
  -d currency=usd
```

## Historial de transacciones del saldo de facturación

#### Dashboard

Audita los ajustes al saldo de la factura de un cliente en el Dashboard, en la página de detalles del cliente, en **Saldo de la factura del cliente**.

Esta sección muestra el valor actual del saldo de facturación. Haz clic en **Ver detalles** para ver el historial de transacciones utilizado para calcular ese valor. Cada línea de transacción muestra información relevante para el [tipo de transacción](https://docs.stripe.com/billing/customer/balance.md#types), como un enlace a la factura que aplicó el saldo de la factura o la nota de crédito que acreditó el saldo.
![Visualización del historial de transacciones del saldo de facturación](https://b.stripecdn.com/docs-statics-srv/assets/3-Balance-history.446845092bb178c7924a9cbee2538f94.png)

#### API

Usa la [Lista de saldo del cliente](https://docs.stripe.com/api/customer_balance_transactions/list.md) para recuperar una lista de todas las transacciones de un cliente.

Si representas a tus clientes como [cuentas configuradas por el cliente en lugar de como clientes](https://docs.stripe.com/accounts-v2/use-accounts-as-customers.md), pasa el ID de la `cuenta` en lugar del ID del `cliente` (por ejemplo, `v1/customers/acct_xxxxx/balance_transactions`).

```curl
curl https://api.stripe.com/v1/customers/cus_4fdAW5ftNQow1a/balance_transactions \
  -u "<<YOUR_SECRET_KEY>>:"
```


## 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&nbsp;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`.