The Balance Transaction object 

Attributes

• idstring

  Unique identifier for the object.

• amountinteger

  Gross amount of this transaction (in cents). A positive value represents funds charged to another party, and a negative value represents funds sent to another party.

• currencyenum

  Three-letter ISO currency code, in lowercase. Must be a supported currency.

• descriptionnullable string

  An arbitrary string attached to the object. Often useful for displaying to users.

• feeinteger

  Fees (in cents) paid for this transaction. Represented as a positive integer when assessed.

• fee_detailsarray of objects

  Detailed breakdown of fees (in cents) paid for this transaction.

  Hide child attributes

  • fee_details.amountinteger

    Amount of the fee, in cents.

  • fee_details.applicationnullable string

    ID of the Connect application that earned the fee.

  • fee_details.currencyenum

    Three-letter ISO currency code, in lowercase. Must be a supported currency.

  • fee_details.descriptionnullable string

    An arbitrary string attached to the object. Often useful for displaying to users.

  • fee_details.typestring

    Type of the fee, one of: application_fee, payment_method_passthrough_fee, stripe_fee or tax.

• netinteger

  Net impact to a Stripe balance (in cents). A positive value represents incrementing a Stripe balance, and a negative value decrementing a Stripe balance. You can calculate the net impact of a transaction on a balance by amount - fee

• sourcenullable stringExpandable

  This transaction relates to the Stripe object.

• statusstring

  The transaction’s net funds status in the Stripe balance, which are either available or pending.

• typeenum

  Transaction type: adjustment, advance, advance_funding, anticipation_repayment, application_fee, application_fee_refund, charge, climate_order_purchase, climate_order_refund, connect_collection_transfer, contribution, issuing_authorization_hold, issuing_authorization_release, issuing_dispute, issuing_transaction, obligation_outbound, obligation_reversal_inbound, payment, payment_failure_refund, payment_network_reserve_hold, payment_network_reserve_release, payment_refund, payment_reversal, payment_unreconciled, payout, payout_cancel, payout_failure, payout_minimum_balance_hold, payout_minimum_balance_release, refund, refund_failure, reserve_transaction, reserved_funds, stripe_fee, stripe_fx_fee, tax_fee, topup, topup_reversal, transfer, transfer_cancel, transfer_failure, or transfer_refund. Learn more about balance transaction types and what they represent. To classify transactions for accounting purposes, consider reporting_category instead.

  Possible enum values

  adjustment

  advance

  advance_funding

  anticipation_repayment

  application_fee

  application_fee_refund

  charge

  climate_order_purchase

  climate_order_refund

  connect_collection_transfer

  Show 32 more

More attributes

Collapse all

• objectstring

  String representing the object’s type. Objects of the same type share the same value.

• available_ontimestamp

  The date that the transaction’s net funds become available in the Stripe balance.

• createdtimestamp

  Time at which the object was created. Measured in seconds since the Unix epoch.

• exchange_ratenullable float

  If applicable, this transaction uses an exchange rate. If money converts from currency A to currency B, then the amount in currency A, multipled by the exchange_rate, equals the amount in currency B. For example, if you charge a customer 10.00 EUR, the PaymentIntent’s amount is 1000 and currency is eur. If this converts to 12.34 USD in your Stripe account, the BalanceTransaction’s amount is 1234, its currency is usd, and the exchange_rate is 1.234.

• reporting_categorystring

  Learn more about how reporting categories can help you understand balance transactions from an accounting perspective.