Struct stripe::BalanceTransaction

pub struct BalanceTransaction {

    pub id: BalanceTransactionId,
    pub amount: i64,
    pub available_on: Timestamp,
    pub created: Timestamp,
    pub currency: Currency,
    pub description: Option<String>,
    pub exchange_rate: Option<f64>,
    pub fee: i64,
    pub fee_details: Vec<Fee>,
    pub net: i64,
    pub reporting_category: String,
    pub source: Option<Expandable<BalanceTransactionSourceUnion>>,
    pub status: BalanceTransactionStatus,
    pub type_: BalanceTransactionType,
}

The resource representing a Stripe “BalanceTransaction”.

For more details see https://stripe.com/docs/api/balance_transactions/object

Fields

id: BalanceTransactionId

Unique identifier for the object.

amount: i64

Gross amount of the transaction, in %s.

available_on: Timestamp

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

created: Timestamp

Time at which the object was created.

Measured in seconds since the Unix epoch.

currency: Currency

Three-letter ISO currency code, in lowercase.

Must be a supported currency.

description: Option<String>

An arbitrary string attached to the object.

Often useful for displaying to users.

exchange_rate: Option<f64>

The exchange rate used, if applicable, for this transaction.

Specifically, if money was converted from currency A to currency B, then the amount in currency A, times exchange_rate, would be the amount in currency B. For example, suppose you charged a customer 10.00 EUR. Then the PaymentIntent’s amount would be 1000 and currency would be eur. Suppose this was converted into 12.34 USD in your Stripe account. Then the BalanceTransaction’s amount would be 1234, currency would be usd, and exchange_rate would be 1.234.

fee: i64

Fees (in %s) paid for this transaction.

fee_details: Vec<Fee>

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

net: i64

Net amount of the transaction, in %s.

reporting_category: String

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

source: Option<Expandable<BalanceTransactionSourceUnion>>

The Stripe object to which this transaction is related.

status: BalanceTransactionStatus

If the transaction’s net funds are available in the Stripe balance yet.

Either available or pending.

type_: BalanceTransactionType

Transaction type: adjustment, advance, advance_funding, anticipation_repayment, application_fee, application_fee_refund, charge, connect_collection_transfer, contribution, issuing_authorization_hold, issuing_authorization_release, issuing_dispute, issuing_transaction, payment, payment_failure_refund, payment_refund, payout, payout_cancel, payout_failure, 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. If you are looking to classify transactions for accounting purposes, you might want to consider reporting_category instead.

Implementations

impl BalanceTransaction

pub fn list(
    client: &Client,
    params: &ListBalanceTransactions<'_>
) -> Response<List<BalanceTransaction>>

Returns a list of transactions that have contributed to the Stripe account balance (e.g., charges, transfers, and so forth).

The transactions are returned in sorted order, with the most recent transactions appearing first. Note that this endpoint was previously called “Balance history” and used the path /v1/balance/history.

pub fn retrieve(
    client: &Client,
    id: &BalanceTransactionId,
    expand: &[&str]
) -> Response<BalanceTransaction>

Retrieves the balance transaction with the given ID.

Note that this endpoint previously used the path /v1/balance/history/:id.

Trait Implementations

impl Clone for BalanceTransaction

fn clone(&self) -> BalanceTransaction

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for BalanceTransaction

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for BalanceTransaction

fn default() -> BalanceTransaction

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for BalanceTransaction

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
    __D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

impl Object for BalanceTransaction

type Id = BalanceTransactionId

The canonical id type for this object.

fn id(&self) -> Self::Id

The id of the object.

fn object(&self) -> &'static str

The object’s type, typically represented in wire format as the object property.

impl Serialize for BalanceTransaction

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error> where
    __S: Serializer, 

Serialize this value into the given Serde serializer.