Attributes
- idstring
Unique identifier for the object.
- amountinteger
The amount of the transaction. A negative value is a credit for the customer’s balance, and a positive value is a debit to the customer’s
balance
. - currencyenum
Three-letter ISO currency code, in lowercase. Must be a supported currency.
- customerstringExpandable
The ID of the customer the transaction belongs to.
- descriptionnullable string
An arbitrary string attached to the object. Often useful for displaying to users.
- ending_
balanceinteger The customer’s
balance
after the transaction was applied. A negative value decreases the amount due on the customer’s next invoice. A positive value increases the amount due on the customer’s next invoice. - metadatanullable object
Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
- typeenum
Transaction type:
adjustment
,applied_
,to_ invoice credit_
,note initial
,invoice_
,overpaid invoice_
,too_ large invoice_
,too_ small unspent_
,receiver_ credit unapplied_
,from_ invoice checkout_
, orsession_ subscription_ payment checkout_
. See the Customer Balance page to learn more about transaction types.session_ subscription_ payment_ canceled Possible enum valuesadjustment
An explicitly created adjustment transaction to debit or credit the credit balance.
applied_
to_ invoice Traces the application of credit against a linked Invoice.
checkout_
session_ subscription_ payment Traces the customer balance applied to an Invoice to be created for the linked Checkout Session.
checkout_
session_ subscription_ payment_ canceled Traces the reversal of an applied balance by the linked Checkout Session. Paired with an earlier ‘checkout_session_subscription_payment‘ transaction.
credit_
note Traces the creation of credit to a Credit Note and its associated Invoice.
initial
The starting value of the customer’s credit balance.
invoice_
overpaid Credits to the credit balance when an invoice receives payments exceeding the amount due.
invoice_
too_ large Debits to the credit balance when the amount due on an invoice is greater than Stripe’s maximum chargeable amount and the customer does not have a cash balance.
invoice_
too_ small Debits to the credit balance when the amount due on an invoice is less than Stripe’s minimum chargeable amount and the customer does not have a cash balance.
migration
Funds migrated from the legacy customer credit balance.
Show 2 more
More attributes
- objectstring
String representing the object’s type. Objects of the same type share the same value.
- checkout_
sessionnullable stringExpandable The ID of the checkout session (if any) that created the transaction.
- createdtimestamp
Time at which the object was created. Measured in seconds since the Unix epoch.
- credit_
notenullable stringExpandable The ID of the credit note (if any) related to the transaction.
- invoicenullable stringExpandable
The ID of the invoice (if any) related to the transaction.
- livemodeboolean
Has the value
true
if the object exists in live mode or the valuefalse
if the object exists in test mode.
{ "id": "cbtxn_1MrU9qLkdIwHu7ixhdjxGBgI", "object": "customer_balance_transaction", "amount": -500, "created": 1680216086, "credit_note": null, "currency": "usd", "customer": "cus_NcjdgdwZyI9Rj7", "description": null, "ending_balance": -500, "invoice": null, "livemode": false, "metadata": {}, "type": "adjustment"}