Berichtskategorien und -typen
Verstehen Sie die Kategorien der BalanceTransaction-Objekte und ihre Unterscheidungen.
Erfahren Sie mehr über das Feld reporting_ auf BalanceTransaction Objekten und wie es sich von type und anderen Kategorisierungen unterscheidet.
Das Feld Meldekategorie
Das Feld reporting_ des BalanceTransaction Objekts verbessert das Feld type, indem es eine nützlichere Gruppierung für die meisten Finanz- und Berichtszwecke bietet. In den folgenden Abschnitten werden die Vorteile des Feldes reporting-category beschrieben.
A Genauere Aufschlüsselung von type=adjustment
Das Attribut reporting_ unterteilt Saldo-Transaktionen mit type=adjustment in verschiedene Kategorien, darunter Streitfälle, Stornierungen von Streitfällen und fehlgeschlagene Rückerstattungen. Außerdem kateogriert es verschiedene Arten von Transaktionsgebühren und Connect Plattformgebühren-Rückerstattungen mit reporting_.
Separate Kategorie für Rückbuchungen teilweise erfasster Zahlungen
Wenn Sie unter Zahlungen separat autorisieren und erfassen ( ) und einen Betrag erfassen, der unter der ursprünglichen Autorisierung liegt, werden zwei Saldo-Transaktionen angezeigt: eine für den vollen Betrag der Autorisierung und eine weitere, die den nicht erfassten Teil storniert. (Die Summe der beiden Saldo-Transaktionen ergibt den erfassten Teil der Zahlung.)
Die Saldo-Transaktion, die den nicht erfassten Teil rückgängig macht, hat den Typ type=refund, genau so, als ob Sie einen Teil eines Verkaufs zu einem späteren Zeitpunkt erstattet hätten. Um eine getrennte Behandlung dieser Objekte zu ermöglichen – z. B. die Anrechnung auf den ursprünglichen Verkaufsbetrag statt einer separaten Rückerstattung – kennzeichnen wir diese mit der eigenen Berichtskategorie partial_.
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_ auf.
Das Attribut reporting_ vereinfacht diese (und andere) Gruppen von Typen, wie folgt:
| Arten von Saldo-Transaktionen | Berichtskategorie |
|---|---|
charge, payment | charge |
refund, payment_ | refund |
payout_, payout_ | payout_ |
transfer, recipient_ | transfer |
transfer_, transfer_, recipient_, recipient_ | transfer_ |
Eindeutigere Kategoriebezeichnungen
Wir haben mehrere Arten von Saldo-Transaktionen umbenannt, um mehr Klarheit zu schaffen:
| Art von Saldo-Transaktion | Berichtskategorie |
|---|---|
application_ | platform_ |
application_ | platform_ |
stripe_ | fee |
reserve_ | connect_ |
reserved_ | risk_ |
Referenz für Berichtskategorien
Diese Referenz umfasst die folgenden 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.
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.
- 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
chargeappear when the payment is created in a pending state. Acharge_will appear if the pending payment later fails.failure - Saldo-Transaktionsart(en):
payment_failure_ refund - Abschnitt(e) im Monatsbericht: Other Adjustments
- Saldo-Transaktionsart(en):
disputeWhen a customer disputes a charge, Stripe deducts the disputed amount from your balance.
- Saldo-Transaktionsart(en):
adjustmentoradjusted_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
chargefor the full authorization amount, and apartial_for the uncaptured portion.capture_ reversal - Saldo-Transaktionsart(en):
refund - Abschnitt(e) im Monatsbericht: Payments (cards)
- Saldo-Transaktionsart(en):
refundPayments you’ve refunded to your customers. (Does not include charge failures or partial capture reversals, which are listed separately.)
- Saldo-Transaktionsart(en):
refundorpayment_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_ororder_ purchase climate_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_ororder_ refund climate_reservation_ refund - Abschnitt(e) im Monatsbericht: Other Adjustments
- Saldo-Transaktionsart(en):
contributionFunds contributed via Stripe to a cause (currently Stripe Climate).
- Saldo-Transaktionsart(en):
contribution - Abschnitt(e) im Monatsbericht: Other Adjustments
- Saldo-Transaktionsart(en):
currency_conversion Adjustment to your Stripe balance related to currency conversion.
- Saldo-Transaktionsart(en):
currency_conversion - 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_, oroutbound obligation_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):
payoutPayouts from your Stripe balance to your bank account.
- Saldo-Transaktionsart(en):
payout - Abschnitt(e) im Monatsbericht: Payouts and Transfers
- Saldo-Transaktionsart(en):
payout_minimum_ balance_ hold Minimum balance held from a payout.
- Saldo-Transaktionsart(en):
payout_minimum_ balance_ hold - Abschnitt(e) im Monatsbericht: Payout minimum balance hold
- Saldo-Transaktionsart(en):
payout_minimum_ balance_ release Minimum balance released after a payout.
- Saldo-Transaktionsart(en):
payout_minimum_ balance_ release - Abschnitt(e) im Monatsbericht: Payout minimum balance release
- 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_orcancel payout_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):
stripe_balance_ payment_ debit Created when a payment initiated by another Stripe account deducts funds from your account balance.
- Saldo-Transaktionsart(en):
stripe_balance_ payment_ debit - Abschnitt(e) im Monatsbericht: Other Adjustments
- Saldo-Transaktionsart(en):
stripe_balance_ payment_ debit_ reversal Created when a payment initiated by another Stripe account is refunded to your account balance.
- Saldo-Transaktionsart(en):
stripe_balance_ payment_ debit_ reversal - Abschnitt(e) im Monatsbericht: Other Adjustments
- Saldo-Transaktionsart(en):
taxTaxes 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):
topupFunds 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_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 - 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_) 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 - 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_dispute_ fraud_ liability_ debit Funds deducted from your account to cover fraud loss liability
- Saldo-Transaktionsart(en):
issuing_dispute_ fraud_ liability_ debit - Abschnitt(e) im Monatsbericht: Other Adjustments
- Saldo-Transaktionsart(en):
issuing_dispute_ provisional_ credit Provisional Credit granted to Issuing balance
- Saldo-Transaktionsart(en):
issuing_dispute_ provisional_ credit - Abschnitt(e) im Monatsbericht: Other Adjustments
- Saldo-Transaktionsart(en):
issuing_dispute_ provisional_ credit_ reversal Previous Provisional Credit being reversed from Issuing balance
- Saldo-Transaktionsart(en):
issuing_dispute_ provisional_ credit_ reversal - 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_balance transaction.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.
advanceIncrementing funds as part of an advance operation to change the date that funds settle to your balance. For example, this can occur when you create an instant payout and the requested payout amount is greater than your available balance. Funds are credited to a new
available_date and debited from the originalon available_date to cover the difference.on - Saldo-Transaktionsart(en):
advance - Abschnitt(e) im Monatsbericht: Other Adjustments
- Saldo-Transaktionsart(en):
advance_funding Decrementing funds as part of an advance operation to change the date that funds settle to your balance. For example, this can occur when you create an instant payout and the requested payout amount is greater than your available balance. Funds are credited to a new
available_date and debited from the originalon available_date to cover the difference.on - 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_is created to release a corresponding portion of the funds held in reserve. Learn more.transaction - 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):
transferFunds sent from your balance to the balance of your connected accounts.
- Saldo-Transaktionsart(en):
transferorrecipient_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_, ortransfer_ cancel recipient_transfer_ failure - Abschnitt(e) im Monatsbericht: Payouts and Transfers: Failures and Refunds
- Saldo-Transaktionsart(en):