Berichtskategorien und -typen
Erfahren Sie mehr über das Feld reporting_category
in BalanceTransaction
-Objekten und wie es sich von type
und anderen Kategorisierungen unterscheidet. Dieses Thema behandelt:
Wozu eine neue Kategorisierung?
Das Feld reporting_category
des Objekts BalanceTransaction
wird durch das Feld type
präzisiert. Damit ermöglicht es eine sinnvollere Gruppierung für die meisten Finanz- und Berichtszwecke. Die Vorteile des neuen Felds werden in den folgenden Abschnitten verdeutlicht.
Detailliertere Aufgliederung von type=adjustment
Das Attribut reporting_category
unterteilt Saldo-Transaktionen mit type=adjustment
in verschiedene Kategorien, wie Angefochtene Zahlungen, Rückbuchungen angefochtener Zahlungen und Fehlgeschlagene Rückerstattungen. Darüber hinaus werden mehrere Arten von Gebühren und Rückerstattungen von Connect-Plattformgebühren jetzt explizit mit reporting_category=fee
kategorisiert.
Separate Kategorie für Rückbuchungen teilweise erfasster Zahlungen
Wenn Sie bei separater Autorisierung und Erfassung von Zahlungen einen Betrag erfassen, der kleiner ist als die ursprüngliche Autorisierung, sehen Sie zwei Saldo-Transaktionen: eine für den vollständigen Betrag der Autorisierung und eine für die Rückbuchung des nicht erfassten Teils. (Die Summe dieser beiden Saldo-Transaktionen ergibt den erfassten Teil der Zahlung.)
Die Saldo-Transaktion, mit der der nicht erfasste Teil der Zahlung zurückgebucht wird, hat den type=refund
, ähnlich wie bei einer nachträglichen Teilrückerstattung. Um diese Objekte separat handhaben zu können, beispielsweise als Teil des ursprünglichen Zahlungsbetrags und nicht als separate Rückerstattung, kennzeichnen wir sie mit der eigenen Berichtskategorie partial_capture_reversal
.
Mehrere Arten in gemeinsame Kategorien unterteilen
Wenn Sie das Feld type
verwenden, werden Saldo-Transaktionen aus kartenbasierten Zahlungen mit type=charge
dargestellt, während Saldo-Transaktionen mit anderen Zahlungsmethoden mit type=payment
dargestellt werden. Ebenso weisen Rückerstattungen und Zahlungsfehlschläge bei kartenbasierten bzw. alternativen Zahlungsmethoden die separaten Typen refund
und payment_refund
auf.
Wir haben festgestellt, dass diese Unterscheidungen viele allgemeine Berichtsvorgänge unnötig verkomplizieren, weshalb reporting_category
diese (und andere) Gruppen von Arten wie folgt vereinfachen soll:
Arten von Saldo-Transaktionen | Berichtskategorie |
---|---|
charge , payment | charge |
refund , payment_refund | refund |
payout_cancel , payout_failure | payout_reversal |
transfer , recipient_transfer | transfer |
transfer_cancel , transfer_failure , recipient_transfer_cancel , recipient_transfer_failure | transfer_reversal |
Eindeutigere Kategoriebezeichnungen
Wir haben mehrere Arten von Saldo-Transaktionen umbenannt, um mehr Klarheit zu schaffen:
Art von Saldo-Transaktion | Berichtskategorie |
---|---|
application_fee | platform_earning |
application_fee_refund | platform_earning_refund |
stripe_fee | fee |
reserve_transaction | connect_reserved_funds |
reserved_funds | risk_reserved_funds |
Referenz für Berichtskategorien
Diese Referenz umfasst vier Gruppen von Berichtskategorien:
- 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.
charge
Charges 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.
- Saldo-Transaktionsart(en):
charge
,payment
, orvalidation
- Abschnitt(e) im Monatsbericht: Payments (cards), Payments (other)
- Saldo-Transaktionsart(en):
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
charge
appear when the payment is created in a pending state. Acharge_failure
will appear if the pending payment later fails.- Saldo-Transaktionsart(en):
payment_failure_refund
- Abschnitt(e) im Monatsbericht: Other Adjustments
- Saldo-Transaktionsart(en):
dispute
When a customer disputes a charge, Stripe deducts the disputed amount from your balance.
- Saldo-Transaktionsart(en):
adjustment
oradjusted_for_overdraft_transaction
- Abschnitt(e) im Monatsbericht: Disputes
- Saldo-Transaktionsart(en):
dispute_reversal
When you win a dispute, the disputed amount is returned to your balance.
- Saldo-Transaktionsart(en):
adjustment
- Abschnitt(e) im Monatsbericht: Dispute Reversals
- Saldo-Transaktionsart(en):
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
charge
for the full authorization amount, and apartial_capture_reversal
for the uncaptured portion.- Saldo-Transaktionsart(en):
refund
- Abschnitt(e) im Monatsbericht: Payments (cards)
- Saldo-Transaktionsart(en):
refund
Payments you’ve refunded to your customers. (Does not include charge failures or partial capture reversals, which are listed separately.)
- Saldo-Transaktionsart(en):
refund
orpayment_refund
- Abschnitt(e) im Monatsbericht: Refunds (cards), Refunds (other)
- Saldo-Transaktionsart(en):
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).
- Saldo-Transaktionsart(en):
refund_failure
- Abschnitt(e) im Monatsbericht: Other Adjustments
- Saldo-Transaktionsart(en):
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.
- Saldo-Transaktionsart(en):
anticipation_repayment
- Abschnitt(e) im Monatsbericht: Anticipation Repayments
- Saldo-Transaktionsart(en):
climate_order_purchase
Funds used to purchase carbon removal units from Frontier Climate.
- Saldo-Transaktionsart(en):
climate_order_purchase
orclimate_reservation_purchase
- Abschnitt(e) im Monatsbericht: Other Adjustments
- Saldo-Transaktionsart(en):
climate_order_refund
Funds refunded to your balance when a Climate Order is canceled.
- Saldo-Transaktionsart(en):
climate_order_refund
orclimate_reservation_refund
- Abschnitt(e) im Monatsbericht: Other Adjustments
- Saldo-Transaktionsart(en):
contribution
Funds contributed via Stripe to a cause (currently Stripe Climate).
- Saldo-Transaktionsart(en):
contribution
- Abschnitt(e) im Monatsbericht: Other Adjustments
- Saldo-Transaktionsart(en):
fee
- Saldo-Transaktionsart(en):
stripe_fee
- Abschnitt(e) im Monatsbericht: Other Adjustments
- Saldo-Transaktionsart(en):
other_adjustment
Miscellaneous adjustments to your Stripe balance.
- Saldo-Transaktionsart(en):
adjustment
,obligation_outbound
, orobligation_reversal_inbound
- Abschnitt(e) im Monatsbericht: Other Adjustments
- Saldo-Transaktionsart(en):
payment_network_reserve_hold
Funds that a payment network holds in reserve (e.g. to mitigate risk).
- Saldo-Transaktionsart(en):
payment_network_reserve_hold
- Abschnitt(e) im Monatsbericht: Other Adjustments
- Saldo-Transaktionsart(en):
payment_network_reserve_release
Funds that a payment network releases from a reserve.
- Saldo-Transaktionsart(en):
payment_network_reserve_release
- Abschnitt(e) im Monatsbericht: Other Adjustments
- Saldo-Transaktionsart(en):
payout
Payouts from your Stripe balance to your bank account.
- Saldo-Transaktionsart(en):
payout
- Abschnitt(e) im Monatsbericht: Payouts and Transfers
- Saldo-Transaktionsart(en):
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.
- Saldo-Transaktionsart(en):
payout_cancel
orpayout_failure
- Abschnitt(e) im Monatsbericht: Payouts and Transfers: Failures and Refunds
- Saldo-Transaktionsart(en):
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.
- Saldo-Transaktionsart(en):
reserved_funds
- Abschnitt(e) im Monatsbericht: Other Adjustments
- Saldo-Transaktionsart(en):
tax
Taxes collected by Stripe to be remitted to the appropriate local governments. Typically, this is a tax on Stripe fees.
- Saldo-Transaktionsart(en):
tax_fee
- Abschnitt(e) im Monatsbericht: Other Adjustments
- Saldo-Transaktionsart(en):
topup
Funds you transferred into your Stripe balance from your bank account. Learn more.
- Saldo-Transaktionsart(en):
topup
- Abschnitt(e) im Monatsbericht: Other Adjustments
- Saldo-Transaktionsart(en):
topup_reversal
If an initially successful top-up fails or is cancelled, the credit to your Stripe balance is reversed. Learn more.
- Saldo-Transaktionsart(en):
topup_reversal
- Abschnitt(e) im Monatsbericht: Other Adjustments
- Saldo-Transaktionsart(en):
unreconciled_customer_funds
When a customer has unreconciled funds within Stripe for more than ninety days, Stripe transfers those funds to your balance.
- Saldo-Transaktionsart(en):
transferred_to_balance_transaction
- Abschnitt(e) im Monatsbericht: Other Adjustments
- Saldo-Transaktionsart(en):
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_authorization_hold
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 typeissuing_authorization_hold
.- Saldo-Transaktionsart(en):
issuing_authorization_hold
- Abschnitt(e) im Monatsbericht: Other Adjustments
- Saldo-Transaktionsart(en):
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_authorization_hold
) are released with aissuing_authorization_release
balance transaction. Simultaneously, an issuing transaction is created, and the purchase amount is deducted from your Stripe balance in another balance transaction with the typeissuing_transaction
.- Saldo-Transaktionsart(en):
issuing_authorization_release
- Abschnitt(e) im Monatsbericht: Other Adjustments
- Saldo-Transaktionsart(en):
issuing_disbursement
Credits to your balance for rewards, discounts, and other miscellaneous adjustments.
- Saldo-Transaktionsart(en):
issuing_disbursement
- Abschnitt(e) im Monatsbericht: Other Adjustments
- Saldo-Transaktionsart(en):
issuing_dispute
When you dispute an Issuing transaction and funds return to your Stripe balance.
- Saldo-Transaktionsart(en):
issuing_dispute
- Abschnitt(e) im Monatsbericht: Other Adjustments
- Saldo-Transaktionsart(en):
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_transaction
balance transaction.- Saldo-Transaktionsart(en):
issuing_transaction
- Abschnitt(e) im Monatsbericht: Other Adjustments
- Saldo-Transaktionsart(en):
Connect-related reporting categories
These reporting categories are related to using the Connect API and related APIs, such as instant payouts.
advance
Incrementing 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.
- Saldo-Transaktionsart(en):
advance
- Abschnitt(e) im Monatsbericht: Other Adjustments
- Saldo-Transaktionsart(en):
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.
- Saldo-Transaktionsart(en):
advance_funding
- Abschnitt(e) im Monatsbericht: Other Adjustments
- Saldo-Transaktionsart(en):
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.
- Saldo-Transaktionsart(en):
connect_collection_transfer
- Abschnitt(e) im Monatsbericht: Reflected in "Reserve" section
- Saldo-Transaktionsart(en):
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_transaction
is created to release a corresponding portion of the funds held in reserve. Learn more.- Saldo-Transaktionsart(en):
reserve_transaction
- Abschnitt(e) im Monatsbericht: Reflected in "Reserve" section
- Saldo-Transaktionsart(en):
platform_earning
Earnings you’ve generated by collecting platform fees via Stripe Connect charges.
- Saldo-Transaktionsart(en):
application_fee
- Abschnitt(e) im Monatsbericht: Application Revenue
- Saldo-Transaktionsart(en):
platform_earning_refund
Platform fees that you have returned to your connected accounts.
- Saldo-Transaktionsart(en):
application_fee_refund
- Abschnitt(e) im Monatsbericht: Application Revenue Returned
- Saldo-Transaktionsart(en):
transfer
Funds sent from your balance to the balance of your connected accounts.
- Saldo-Transaktionsart(en):
transfer
orrecipient_transfer
- Abschnitt(e) im Monatsbericht: Payouts and Transfers
- Saldo-Transaktionsart(en):
transfer_reversal
Transfers to your connected accounts that have been cancelled.
- Saldo-Transaktionsart(en):
transfer_cancel
,transfer_refund
,recipient_transfer_cancel
, orrecipient_transfer_failure
- Abschnitt(e) im Monatsbericht: Payouts and Transfers: Failures and Refunds
- Saldo-Transaktionsart(en):