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.

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 pueden hacer referencia al objeto relacionado con el ajuste (como una nota de crédito o un cliente), o incluso a metadatos para tu propia referencia.

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 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 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, 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.

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 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 habilitada.
• No puedes aplicar saldos de factura a facturas creadas anteriormente que aún estén abiertas. Sin embargo, al editar una factura abierta, 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 de 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. 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 creadas con la API o en el Dashboard tienen un valor de 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:

Modifica el saldo de facturación

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 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

API

Crea ajustes con la API Customer Balance como se muestra en el siguiente ejemplo de programación.

curl https://api.stripe.com/v1/customers/cus_4fdAW5ftNQow1a/balance_transactions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=-500 \
  -d currency=usd

Historial de transacciones del saldo de facturación

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, como un enlace a la factura que aplicó el saldo de la factura o la nota de crédito que acreditó el saldo.

API

Usa la Lista de saldo del cliente para recuperar una lista de todas las transacciones de un cliente.

curl https://api.stripe.com/v1/customers/cus_4fdAW5ftNQow1a/balance_transactions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

Saldos de caja del 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:

• No puedes crear un saldo de caja del cliente negativo, ya que representa dinero enviado desde el 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.

• No puedes eliminar el saldo disponible de un objeto Customer.