> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

# Resource: Balances

# Type: Balance Record Object

# Link: https://dev.wix.com/docs/api-reference/business-management/payments/wix-payments-provider/balances/balance-record-object.md

## Description: A balance record is 1 entry on a Wix Payments account ledger, representing 1 financial
operation on the account: a payment, a refund, a chargeback, a refund or chargeback
reversal, a reserve hold or release, a top-up, a Wix Capital cash advance, a Wix Capital
remittance, or an adjustment.

Each record belongs to an account and to one of the account's profiles. Reserve, payment,
payout, and book transfer details are populated based on the record's type. On every
record, `net` equals `amount - fee`. Records are immutable: `amount`, `fee`, and `net`
never change after creation.

In certain cases a balance record can be virtual: a record that hasn't been persisted but
is projected to occur in the future. Virtual records are returned only for the
`ESTIMATED_RESERVE_HOLD` and `ESTIMATED_RESERVE_RELEASE` tags and have no `id` and no
`appliedDate`.

## Schema:

```json
 Type: Balance Record Object | type: BalanceRecord
 Description: A balance record is 1 entry on a Wix Payments account ledger, representing 1 financial
operation on the account: a payment, a refund, a chargeback, a refund or chargeback
reversal, a reserve hold or release, a top-up, a Wix Capital cash advance, a Wix Capital
remittance, or an adjustment.

Each record belongs to an account and to one of the account's profiles. Reserve, payment,
payout, and book transfer details are populated based on the record's type. On every
record, `net` equals `amount - fee`. Records are immutable: `amount`, `fee`, and `net`
never change after creation.

In certain cases a balance record can be virtual: a record that hasn't been persisted but
is projected to occur in the future. Virtual records are returned only for the
`ESTIMATED_RESERVE_HOLD` and `ESTIMATED_RESERVE_RELEASE` tags and have no `id` and no
`appliedDate`.
       - name: id  | type: string | description: Balance record ID.  Not returned for virtual records produced by `ESTIMATED_RESERVE_HOLD` or `ESTIMATED_RESERVE_RELEASE` tags.
           - name: value  | type: string | description: 
       - name: accountId  | type: string | description: ID of the Wix Payments account this balance record belongs to.
       - name: accountProfileId  | type: string | description: ID of the Wix Payments account profile this balance record belongs to.
       - name: amount  | type: Money | description: Gross amount of the balance record, including fees.  Positive for credits to the account, negative for deductions.
           - name: value  | type: string | description: Monetary amount. Decimal string with a period as a decimal separator (e.g., 3.99). Optionally, a single (-), to indicate that the amount is negative.
           - name: currency  | type: string | description: Currency code. Must be valid ISO 4217 currency code (e.g., USD).
           - name: formattedValue  | type: string | description: Monetary amount. Decimal string in local format (e.g., 1 000,30). Optionally, a single (-), to indicate that the amount is negative.
       - name: fee  | type: Money | description: Fee that Wix Payments collected on this balance record.
       - name: net  | type: Money | description: Net amount of the balance record after subtracting `fee`.
       - name: recordType  | type: string | description: Type of the balance record. Describes what kind of money movement this record represents.
           enum: UNKNOWN, CREDIT, REFUND, CHARGEBACK, REFUND_REVERSAL, CHARGEBACK_REVERSAL, RESERVE_HOLD, RESERVE_RELEASE, TOPUP, CREDIT_FAILED, CHARGEBACK_FEE, CHARGEBACK_FEE_REVERSAL, CAPITAL_CASH_ADVANCE, CAPITAL_AUTOMATIC_REMITTANCE, CAPITAL_ADJUSTMENT
       - name: recordStatus  | type: string | description: Current effect of this record on the account balance.  The value depends on the record's `recordType`, whether it has a `payoutInfo` or `bookTransferInfo`, and its `payoutAvailabilityDate`. This field is returned on responses only and can't be passed as a filter on list or query requests. To filter by effect on the balance, use `tags` instead.
           enum: UNKNOWN, PENDING_CREDIT, CREDITED, RESERVED, PENDING_DEBIT, DEBITED, PAID_OUT, DEDUCTED_FROM_PAYOUT, PAYOUT_REVERSED
       - name: appliedDate  | type: string | description: Date and time the balance record was applied to the account balance.  Not returned for virtual records.
           - name: seconds  | type: string | description: 
           - name: nanos  | type: number | description: 
       - name: payoutAvailabilityDate  | type: string | description: Date the balance record becomes available for payout, in `YYYY-MM-DD` format.
       - name: createdDate  | type: string | description: Date and time the balance record was created.
       - name: updatedDate  | type: string | description: Date and time the balance record was last updated.
       - name: paymentInfo  | type: PaymentInfo | description: Information about the payment that produced this balance record.  Returned for records related to a payment, refund, or chargeback.
           - name: transactionId  | type: string | description: ID of the Wix Payments transaction that produced this balance record.
           - name: createdDate  | type: string | description: Date and time the underlying payment was created.
           - name: externalTransactionId  | type: string | description: External transaction ID supplied by the merchant's order system, if any.
           - name: externalOrderId  | type: string | description: External order ID supplied by the merchant's order system, if any.
           - name: externalDisplayOrderId  | type: string | description: Display-friendly external order ID, suitable for showing in a UI.
           - name: externalOrderLink  | type: string | description: Link to the order in the merchant's external order management system.
           - name: customerName  | type: string | description: Customer's name as captured by the payment flow.
           - name: cardHolderName  | type: string | description: Cardholder's name as captured at payment time.
           - name: paymentMethodType  | type: string | description: Payment method used for the underlying transaction.  Deprecated. Use `paymentMethodTypeId` instead.
               enum: UNKNOWN, CARD, CARD_READER, ACH, APPLE_PAY, BOLETO, GIROPAY, IDEAL, PIX, SEPA, SOFORT, PAY_PAL, TAP_TO_PAY, GOOGLE_PAY, AFFIRM, AFTERPAY, KLARNA, RAZORPAY, ALIPAY, BANCONTACT, US_BANK_ACCOUNT, BANKFUL_CRYPTO, BANKFUL, TWINT
       - name: payoutInfo  | type: PayoutInfo | description: Information about the payout that includes this balance record.  Returned only after the record has been included in a payout. The presence of `payoutInfo` (versus `bookTransferInfo`) distinguishes a regular payout from an Instant Access book transfer.
           - name: payoutId  | type: string | description: ID of the payout that this balance record belongs to.
           - name: createdDate  | type: string | description: Date and time the payout was created.  Returned only for payouts that have already occurred, not those that are scheduled.
       - name: reserveInfo  | type: ReserveInfo | description: Reserve details for this balance record.  Returned for records with `recordType` `RESERVE_HOLD` or `RESERVE_RELEASE`.
           - name: hold  | type: PayoutInfo | description: Payout details for the hold portion of the reserve, where funds are removed from the available balance.
           - name: release  | type: PayoutInfo | description: Payout details for the release portion of the reserve, where funds are returned to the available balance.
           - name: reserveHistoryItems  | type: Array<ReserveHistoryItem> | description: History of changes applied to this reserve, ordered by event time.
               - name: releaseDate  | type: string | description: Date the reserve was scheduled to be released, in `YYYY-MM-DD` format.
               - name: createdDate  | type: string | description: Date and time the reserve was created.
           - name: reserveType  | type: string | description: Reserve type that determines how the reserve was created.
               enum: ONE_TIME, ROLLING
       - name: bookTransferInfo  | type: BookTransferInfo | description: Book transfer details for this balance record.  Returned for records funded through a Wix Checking book transfer (Instant Access) rather than a payout. Funds backed by a book transfer are immediately available in the merchant's Wix Checking account.
           - name: bookTransferId  | type: string | description: ID of the book transfer that funded this balance record.
           - name: transactionReference  | type: string | description: External reference for the book transfer transaction.
           - name: createdDate  | type: string | description: Date and time the funds became instantly available through the book transfer.

```