Defines the object schema located at components.schemas.customer_balance_transaction in the specification.
Each customer has a `balance` value, which denotes a debit or credit that's automatically applied to their next invoice upon finalization. You may modify the value directly by using the update customer API, or by creating a Customer Balance Transaction, which increments or decrements the customer's `balance` by the specified `amount`.
Related guide: Customer Balance to learn more.
Constructors
CustomerBalanceTransactioncustomerBalanceTransactionAmount :: Intamount: 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`.
customerBalanceTransactionCreated :: Intcreated: Time at which the object was created. Measured in seconds since the Unix epoch.
customerBalanceTransactionCreditNote :: Maybe (Nullable CustomerBalanceTransactionCreditNote'NonNullableVariants)credit_note: The ID of the credit note (if any) related to the transaction.
customerBalanceTransactionCurrency :: Textcurrency: Three-letter ISO currency code, in lowercase. Must be a supported currency.
customerBalanceTransactionCustomer :: CustomerBalanceTransactionCustomer'Variantscustomer: The ID of the customer the transaction belongs to.
customerBalanceTransactionDescription :: Maybe (Nullable Text)description: An arbitrary string attached to the object. Often useful for displaying to users.
Constraints:
Maximum length of 5000
customerBalanceTransactionEndingBalance :: Intending_balance: 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.
customerBalanceTransactionId :: Textid: Unique identifier for the object.
Constraints:
Maximum length of 5000
customerBalanceTransactionInvoice :: Maybe (Nullable CustomerBalanceTransactionInvoice'NonNullableVariants)invoice: The ID of the invoice (if any) related to the transaction.
customerBalanceTransactionLivemode :: Boollivemode: Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
customerBalanceTransactionMetadata :: Maybe (Nullable Object)metadata: 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.
customerBalanceTransactionType :: CustomerBalanceTransactionType'type: Transaction type: `adjustment`, `applied_to_invoice`, `credit_note`, `initial`, `invoice_too_large`, `invoice_too_small`, `unspent_receiver_credit`, or `unapplied_from_invoice`. See the Customer Balance page to learn more about transaction types.
Instances4Eq, Show, FromJSON, ToJSON
Eq CustomerBalanceTransactionDefined in stripeapi-3.0.0.0 · StripeAPI.Types.CustomerBalanceTransactionShow CustomerBalanceTransactionDefined in stripeapi-3.0.0.0 · StripeAPI.Types.CustomerBalanceTransactionFromJSON CustomerBalanceTransactionDefined in stripeapi-3.0.0.0 · StripeAPI.Types.CustomerBalanceTransactionToJSON CustomerBalanceTransactionDefined in stripeapi-3.0.0.0 · StripeAPI.Types.CustomerBalanceTransaction