报告类别和类型
理解 BalanceTransaction 对象的类别及其区别。
了解 BalanceTransaction 对象上的 reporting_ 字段的更多信息，以及它与 type 及其他分类的区别。本主题涵盖了：
为什么要引入新的分类？
BalanceTransaction 对象的 reporting_ 字段在 type 字段做了改进，为多数财务和报告目的提供了更有用的分组。下面的部分总结了新字段的优点。
type=adjustment 的进一步细分
reporting_ 属性将具有 type=adjustment 的余额交易分为几个不同的类别，包括争议、争议撤销和失败的退款。此外，多个类型的费用和 Connect 平台费用退款现已明确分到 reporting_ 此类别。
为部分捕获撤销单设一个类别
如果您要单独授权并捕获付款，且捕获的金额小于最初授权的金额，则您会看到两个余额交易：一个是完整的授权金额，另一个是撤销的未捕获金额。（将这两笔余额交易相加，就得到捕获部分的收款。）
撤销未捕获部分的余额交易具有 type=refund，好比是您之后退还了销售额的一部分。为了能够单独处理这些对象——或是将它们算入初始销售金额中，而不是视为单独的退款——我们用独特的报告类别 partial_ 来标记这些对象。
将多个类型合并为常用类别
使用 type 字段，来自银行卡收款的余额交易由 type=charge 表示，而来自于其他支付方式的余额交易用 type=payment表示。与之类似，银行卡与替代支付方式的退款及失败分别用 refund 和 payment_ 表示。
我们发现这些区别让许多常见的报告任务变得相当笨拙，因此 reporting_ 简化了如下这些类型组：
| 余额交易类型 | 报告类别 |
|---|---|
charge, payment | charge |
refund, payment_ | refund |
payout_, payout_ | payout_ |
transfer, recipient_ | transfer |
transfer_, transfer_, recipient_, recipient_ | transfer_ |
更具描述性的类别名称
为了表述更清晰，我们重命名了几个余额交易类型：
| 余额交易类型 | 报告类别 |
|---|---|
application_ | platform_ |
application_ | platform_ |
stripe_ | fee |
reserve_ | connect_ |
reserved_ | risk_ |
报告类别参考
本参考资料包含四组报告类别：
- Payments-related reporting categories
- Balance-related reporting categories
- Issuing-related reporting categories
- Connect-related reporting categories
Payments-related reporting categories
These reporting categories are related to creating and refunding charges as part of processing payments.
chargeCharges include payments from cards and from other payment methods. If you are separately authorizing and capturing payments, only the captured charges will be included here.
- 余额交易类型：
charge,payment, orvalidation - 月度报告中的部分：Payments (cards), Payments (other)
- 余额交易类型：
charge_failure ACH, direct debit, and other asynchronous payment methods remain in a pending state until they either succeed or fail. You will see a pending balance transaction with the reporting category
chargeappear when the payment is created in a pending state. Acharge_will appear if the pending payment later fails.failure - 余额交易类型：
payment_failure_ refund - 月度报告中的部分：Other Adjustments
- 余额交易类型：
disputeWhen a customer disputes a charge, Stripe deducts the disputed amount from your balance.
- 余额交易类型：
adjustmentoradjusted_for_ overdraft_ transaction - 月度报告中的部分：Disputes
- 余额交易类型：
dispute_reversal When you win a dispute, the disputed amount is returned to your balance.
- 余额交易类型：
adjustment - 月度报告中的部分：Dispute Reversals
- 余额交易类型：
partial_capture_ reversal If you are separately authorizing and capturing payments, and you capture an amount less than the initial authorization, you will see a
chargefor the full authorization amount, and apartial_for the uncaptured portion.capture_ reversal - 余额交易类型：
refund - 月度报告中的部分：Payments (cards)
- 余额交易类型：
refundPayments you’ve refunded to your customers. (Does not include charge failures or partial capture reversals, which are listed separately.)
- 余额交易类型：
refundorpayment_refund - 月度报告中的部分：Refunds (cards), Refunds (other)
- 余额交易类型：
refund_failure Created when a credit card charge refund fails, and Stripe returns the funds to your balance.
This may occur if your customer’s bank or card issuer is unable to correctly process a refund (e.g., due to a closed bank account or a problem with the card).
- 余额交易类型：
refund_failure - 月度报告中的部分：Other Adjustments
- 余额交易类型：
Balance-related reporting categories
These reporting categories are related to changes that affect your Stripe balance, such as payouts, fees, and top-ups.
anticipation_repayment Repayments made to service an anticipation loan in Brazil. These repayments go to the financial institution to whom you have sold your receivables.
- 余额交易类型：
anticipation_repayment - 月度报告中的部分：Anticipation Repayments
- 余额交易类型：
climate_order_ purchase Funds used to purchase carbon removal units from Frontier Climate.
- 余额交易类型：
climate_ororder_ purchase climate_reservation_ purchase - 月度报告中的部分：Other Adjustments
- 余额交易类型：
climate_order_ refund Funds refunded to your balance when a Climate Order is canceled.
- 余额交易类型：
climate_ororder_ refund climate_reservation_ refund - 月度报告中的部分：Other Adjustments
- 余额交易类型：
contributionFunds contributed via Stripe to a cause (currently Stripe Climate).
- 余额交易类型：
contribution - 月度报告中的部分：Other Adjustments
- 余额交易类型：
fee- 余额交易类型：
stripe_fee - 月度报告中的部分：Other Adjustments
- 余额交易类型：
other_adjustment Miscellaneous adjustments to your Stripe balance.
- 余额交易类型：
adjustment,obligation_, oroutbound obligation_reversal_ inbound - 月度报告中的部分：Other Adjustments
- 余额交易类型：
payment_network_ reserve_ hold Funds that a payment network holds in reserve (e.g. to mitigate risk).
- 余额交易类型：
payment_network_ reserve_ hold - 月度报告中的部分：Other Adjustments
- 余额交易类型：
payment_network_ reserve_ release Funds that a payment network releases from a reserve.
- 余额交易类型：
payment_network_ reserve_ release - 月度报告中的部分：Other Adjustments
- 余额交易类型：
payoutPayouts from your Stripe balance to your bank account.
- 余额交易类型：
payout - 月度报告中的部分：Payouts and Transfers
- 余额交易类型：
payout_reversal Funds returned to your balance if a payout fails after it is initially created (e.g., due to an invalid account number or a cancellation). Learn more.
- 余额交易类型：
payout_orcancel payout_failure - 月度报告中的部分：Payouts and Transfers: Failures and Refunds
- 余额交易类型：
risk_reserved_ funds When Stripe holds your funds in reserve to mitigate risk, two balance transactions are created: one to debit the funds from your balance, and a second to credit the funds back to your balance at the end of the reserve period.
- 余额交易类型：
reserved_funds - 月度报告中的部分：Other Adjustments
- 余额交易类型：
taxTaxes collected by Stripe to be remitted to the appropriate local governments. Typically, this is a tax on Stripe fees.
- 余额交易类型：
tax_fee - 月度报告中的部分：Other Adjustments
- 余额交易类型：
topupFunds you transferred into your Stripe balance from your bank account. Learn more.
- 余额交易类型：
topup - 月度报告中的部分：Other Adjustments
- 余额交易类型：
topup_reversal If an initially successful top-up fails or is cancelled, the credit to your Stripe balance is reversed. Learn more.
- 余额交易类型：
topup_reversal - 月度报告中的部分：Other Adjustments
- 余额交易类型：
unreconciled_customer_ funds When a customer has unreconciled funds within Stripe for more than ninety days, Stripe transfers those funds to your balance.
- 余额交易类型：
transferred_to_ balance_ transaction - 月度报告中的部分：Other Adjustments
- 余额交易类型：
Issuing-related reporting categories
These reporting categories are created as part of using the Issuing API.
issuing_authorization_ hold When an issued card is used to make a purchase, an authorization is created. If the authorization is approved, a balance transaction is created with the type
issuing_to hold the authorized amount in reserve from your account balance, until the authorization is either captured or voided. Some merchants can also update an authorization to request an additional amount (e.g., to extend a hotel booking or add a tip), and this is also represented as a balance transaction with the typeauthorization_ hold issuing_.authorization_ hold - 余额交易类型：
issuing_authorization_ hold - 月度报告中的部分：Other Adjustments
- 余额交易类型：
issuing_authorization_ release When an authorized purchase, made with an issued card, is captured by the merchant, the funds previously held for the authorization (
issuing_) are released with aauthorization_ hold issuing_balance transaction. Simultaneously, an issuing transaction is created, and the purchase amount is deducted from your Stripe balance in another balance transaction with the typeauthorization_ release issuing_.transaction - 余额交易类型：
issuing_authorization_ release - 月度报告中的部分：Other Adjustments
- 余额交易类型：
issuing_disbursement Credits to your balance for rewards, discounts, and other miscellaneous adjustments.
- 余额交易类型：
issuing_disbursement - 月度报告中的部分：Other Adjustments
- 余额交易类型：
issuing_dispute When you dispute an Issuing transaction and funds return to your Stripe balance.
- 余额交易类型：
issuing_dispute - 月度报告中的部分：Other Adjustments
- 余额交易类型：
issuing_dispute_ fraud_ liability_ debit Funds deducted from your account to cover fraud loss liability
- 余额交易类型：
issuing_dispute_ fraud_ liability_ debit - 月度报告中的部分：Other Adjustments
- 余额交易类型：
issuing_dispute_ provisional_ credit Provisional Credit granted to Issuing balance
- 余额交易类型：
issuing_dispute_ provisional_ credit - 月度报告中的部分：Other Adjustments
- 余额交易类型：
issuing_dispute_ provisional_ credit_ reversal Previous Provisional Credit being reversed from Issuing balance
- 余额交易类型：
issuing_dispute_ provisional_ credit_ reversal - 月度报告中的部分：Other Adjustments
- 余额交易类型：
issuing_transaction When an authorized purchase, made with an issued card, has been authorized and captured by the merchant, an issuing transaction is created, and the purchase amount is deducted from your Stripe balance with a
issuing_balance transaction.transaction - 余额交易类型：
issuing_transaction - 月度报告中的部分：Other Adjustments
- 余额交易类型：
Connect-related reporting categories
These reporting categories are related to using the Connect API and related APIs, such as instant payouts.
advanceIncrementing available funds for instant payouts. This occurs when you create an instant payout and the requested payout amount is greater than your connected account’s available balance. Funds are added to your available balance and removed from your pending balance to cover the difference.
- 余额交易类型：
advance - 月度报告中的部分：Other Adjustments
- 余额交易类型：
advance_funding Decrementing pending funds for instant payouts. This occurs when you create an instant payout and the requested payout amount is greater than your connected account’s available balance. Funds are added to your available balance and removed from your pending balance to cover the difference.
- 余额交易类型：
advance_funding - 月度报告中的部分：Other Adjustments
- 余额交易类型：
connect_collection_ transfer If one of your connected accounts has a negative balance for 180 days, Stripe transfers a portion of your balance, to zero out that account’s balance. Learn more.
- 余额交易类型：
connect_collection_ transfer - 月度报告中的部分：Reflected in "Reserve" section
- 余额交易类型：
connect_reserved_ funds If one of your connected accounts’ balances becomes negative, Stripe temporarily reserves a portion of your balance to ensure that funds can be covered.
If one of your connected accounts’ previously negative balance becomes less negative due to activity on account, another
reserve_is created to release a corresponding portion of the funds held in reserve. Learn more.transaction - 余额交易类型：
reserve_transaction - 月度报告中的部分：Reflected in "Reserve" section
- 余额交易类型：
platform_earning Earnings you’ve generated by collecting platform fees via Stripe Connect charges.
- 余额交易类型：
application_fee - 月度报告中的部分：Application Revenue
- 余额交易类型：
platform_earning_ refund Platform fees that you have returned to your connected accounts.
- 余额交易类型：
application_fee_ refund - 月度报告中的部分：Application Revenue Returned
- 余额交易类型：
transferFunds sent from your balance to the balance of your connected accounts.
- 余额交易类型：
transferorrecipient_transfer - 月度报告中的部分：Payouts and Transfers
- 余额交易类型：
transfer_reversal Transfers to your connected accounts that have been cancelled.
- 余额交易类型：
transfer_,cancel transfer_,refund recipient_, ortransfer_ cancel recipient_transfer_ failure - 月度报告中的部分：Payouts and Transfers: Failures and Refunds
- 余额交易类型：