Catégories et types de rapports

Comprendre les catégories sur les objets BalanceTransaction et leurs distinctions.

En savoir plus sur le champ reporting_category des objets BalanceTransaction, et en quoi il diffère du champ type et d’autres catégorisations.

Le champ de catégorie de reporting

Le champ reporting_category de l’objet BalanceTransaction améliore le champ type en fournissant un regroupement plus utile pour la plupart des besoins en matière de finance et de reporting. Les sections suivantes décrivent les avantages du champ reporting-category.

Une décomposition plus détaillée de type=adjustment

L’attribut reporting_category sépare les transactions de solde de type=adjustment en plusieurs catégories différentes, y compris les litiges, les annulations de litiges et les remboursements échoués. De plus, il catégorise plusieurs types de frais et de remboursements de frais de plateforme Connect avec reporting_category=fee.

Une catégorie distincte pour les annulations de captures partielles

Si vous autorisez et capturez les paiements séparément, et que vous capturez un montant inférieur à l’autorisation initiale, vous verrez deux transactions de solde : une pour le montant total de l’autorisation, et une autre annulant la partie non capturée. (La somme des deux transactions de solde correspond à la partie capturée du paiement.)

La transaction de solde annulant la partie non capturée a pour type=refund, comme si vous aviez remboursé une partie d’une vente à un moment ultérieur. Pour permettre un traitement distinct de ces objets (par exemple, en les comptabilisant par rapport au montant de la vente initiale, plutôt que comme un remboursement distinct), nous les étiquetons avec la catégorie de reporting distincte partial_capture_reversal.

Consolidez plusieurs types dans des catégories communes

Si vous utilisez le champ type, les opérations sur solde résultant de paiements par carte sont identifiées avec type=charge, tandis que celles qui découlent d’autres moyens de paiement sont identifiées avec type=payment. De la même façon, les remboursements et échecs de paiement par carte, par rapport aux autres moyens de paiement, présentent des types distincts, à savoir refund et payment_refund.

L’attribut reporting_category simplifie ces groupes de types (et d’autres), comme suit :

Types d’opérations sur solde	Catégorie de reporting
`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`

Des noms de catégories plus descriptifs

Nous avons renommé plusieurs types de transactions de solde pour plus de clarté :

Type d’opération sur solde	Catégorie de reporting
`application_fee`	`platform_earning`
`application_fee_refund`	`platform_earning_refund`
`stripe_fee`	`fee`
`reserve_transaction`	`connect_reserved_funds`
`reserved_funds`	`risk_reserved_funds`

Référence des catégories de reporting

Cette référence couvre les groupes suivants de catégories de reporting :

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.

Type(s) d'opération sur solde :charge, payment, or validation
Section(s) du rapport mensuel :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 charge appear when the payment is created in a pending state. A charge_failure will appear if the pending payment later fails.

Type(s) d'opération sur solde :payment_failure_refund
Section(s) du rapport mensuel :Other Adjustments

dispute

When a customer disputes a charge, Stripe deducts the disputed amount from your balance.

Type(s) d'opération sur solde :adjustmentor adjusted_for_overdraft_transaction
Section(s) du rapport mensuel :Disputes

dispute_reversal

When you win a dispute, the disputed amount is returned to your balance.

Type(s) d'opération sur solde :adjustment
Section(s) du rapport mensuel :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 charge for the full authorization amount, and a partial_capture_reversal for the uncaptured portion.

Type(s) d'opération sur solde :refund
Section(s) du rapport mensuel :Payments (cards)

refund

Payments you’ve refunded to your customers. (Does not include charge failures or partial capture reversals, which are listed separately.)

Type(s) d'opération sur solde :refundor payment_refund
Section(s) du rapport mensuel :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).

Type(s) d'opération sur solde :refund_failure
Section(s) du rapport mensuel :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.

Type(s) d'opération sur solde :anticipation_repayment
Section(s) du rapport mensuel :Anticipation Repayments

climate_order_purchase

Funds used to purchase carbon removal units from Frontier Climate.

Type(s) d'opération sur solde :climate_order_purchaseor climate_reservation_purchase
Section(s) du rapport mensuel :Other Adjustments

climate_order_refund

Funds refunded to your balance when a Climate Order is canceled.

Type(s) d'opération sur solde :climate_order_refundor climate_reservation_refund
Section(s) du rapport mensuel :Other Adjustments

contribution

Funds contributed via Stripe to a cause (currently Stripe Climate).

Type(s) d'opération sur solde :contribution
Section(s) du rapport mensuel :Other Adjustments

currency_conversion

Adjustment to your Stripe balance related to currency conversion.

Type(s) d'opération sur solde :currency_conversion
Section(s) du rapport mensuel :Other Adjustments

fee

Fees for Stripe software and services (e.g., for Radar, Connect, Billing, and Identity).

Type(s) d'opération sur solde :stripe_fee
Section(s) du rapport mensuel :Other Adjustments

other_adjustment

Miscellaneous adjustments to your Stripe balance.

Type(s) d'opération sur solde :adjustment, obligation_outbound, or obligation_reversal_inbound
Section(s) du rapport mensuel :Other Adjustments

payment_network_reserve_hold

Funds that a payment network holds in reserve (e.g. to mitigate risk).

Type(s) d'opération sur solde :payment_network_reserve_hold
Section(s) du rapport mensuel :Other Adjustments

payment_network_reserve_release

Funds that a payment network releases from a reserve.

Type(s) d'opération sur solde :payment_network_reserve_release
Section(s) du rapport mensuel :Other Adjustments

payout

Payouts from your Stripe balance to your bank account.

Type(s) d'opération sur solde :payout
Section(s) du rapport mensuel :Payouts and Transfers

payout_minimum_balance_hold

Minimum balance held from a payout.

Type(s) d'opération sur solde :payout_minimum_balance_hold
Section(s) du rapport mensuel :Payout minimum balance hold

payout_minimum_balance_release

Minimum balance released after a payout.

Type(s) d'opération sur solde :payout_minimum_balance_release
Section(s) du rapport mensuel :Payout minimum balance release

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.

Type(s) d'opération sur solde :payout_cancelor payout_failure
Section(s) du rapport mensuel :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.

Type(s) d'opération sur solde :reserved_funds
Section(s) du rapport mensuel :Other Adjustments

stripe_balance_payment_debit

Created when a payment initiated by another Stripe account deducts funds from your account balance.

Type(s) d'opération sur solde :stripe_balance_payment_debit
Section(s) du rapport mensuel :Other Adjustments

stripe_balance_payment_debit_reversal

Created when a payment initiated by another Stripe account is refunded to your account balance.

Type(s) d'opération sur solde :stripe_balance_payment_debit_reversal
Section(s) du rapport mensuel :Other Adjustments

tax

Taxes collected by Stripe to be remitted to the appropriate local governments. Typically, this is a tax on Stripe fees.

Type(s) d'opération sur solde :tax_fee
Section(s) du rapport mensuel :Other Adjustments

topup

Funds you transferred into your Stripe balance from your bank account. Learn more.

Type(s) d'opération sur solde :topup
Section(s) du rapport mensuel :Other Adjustments

topup_reversal

If an initially successful top-up fails or is cancelled, the credit to your Stripe balance is reversed. Learn more.

Type(s) d'opération sur solde :topup_reversal
Section(s) du rapport mensuel :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.

Type(s) d'opération sur solde :transferred_to_balance_transaction
Section(s) du rapport mensuel :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_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 type issuing_authorization_hold.

Type(s) d'opération sur solde :issuing_authorization_hold
Section(s) du rapport mensuel :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_authorization_hold) are released with a issuing_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 type issuing_transaction.

Type(s) d'opération sur solde :issuing_authorization_release
Section(s) du rapport mensuel :Other Adjustments

issuing_disbursement

Credits to your balance for rewards, discounts, and other miscellaneous adjustments.

Type(s) d'opération sur solde :issuing_disbursement
Section(s) du rapport mensuel :Other Adjustments

issuing_dispute

When you dispute an Issuing transaction and funds return to your Stripe balance.

Type(s) d'opération sur solde :issuing_dispute
Section(s) du rapport mensuel :Other Adjustments

issuing_dispute_fraud_liability_debit

Funds deducted from your account to cover fraud loss liability

Type(s) d'opération sur solde :issuing_dispute_fraud_liability_debit
Section(s) du rapport mensuel :Other Adjustments

issuing_dispute_provisional_credit

Provisional Credit granted to Issuing balance

Type(s) d'opération sur solde :issuing_dispute_provisional_credit
Section(s) du rapport mensuel :Other Adjustments

issuing_dispute_provisional_credit_reversal

Previous Provisional Credit being reversed from Issuing balance

Type(s) d'opération sur solde :issuing_dispute_provisional_credit_reversal
Section(s) du rapport mensuel :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_transaction balance transaction.

Type(s) d'opération sur solde :issuing_transaction
Section(s) du rapport mensuel :Other Adjustments

Connect-related reporting categories

These reporting categories are related to using the Connect API and related APIs, such as instant payouts.

advance

Incrementing 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_on date and debited from the original available_on date to cover the difference.

Type(s) d'opération sur solde :advance
Section(s) du rapport mensuel :Other Adjustments

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_on date and debited from the original available_on date to cover the difference.

Type(s) d'opération sur solde :advance_funding
Section(s) du rapport mensuel :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.

Type(s) d'opération sur solde :connect_collection_transfer
Section(s) du rapport mensuel :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_transaction is created to release a corresponding portion of the funds held in reserve. Learn more.

Type(s) d'opération sur solde :reserve_transaction
Section(s) du rapport mensuel :Reflected in "Reserve" section

platform_earning

Earnings you’ve generated by collecting platform fees via Stripe Connect charges.

Type(s) d'opération sur solde :application_fee
Section(s) du rapport mensuel :Application Revenue

platform_earning_refund

Platform fees that you have returned to your connected accounts.

Type(s) d'opération sur solde :application_fee_refund
Section(s) du rapport mensuel :Application Revenue Returned

transfer

Funds sent from your balance to the balance of your connected accounts.

Type(s) d'opération sur solde :transferor recipient_transfer
Section(s) du rapport mensuel :Payouts and Transfers

transfer_reversal

Transfers to your connected accounts that have been cancelled.

Type(s) d'opération sur solde :transfer_cancel, transfer_refund, recipient_transfer_cancel, or recipient_transfer_failure
Section(s) du rapport mensuel :Payouts and Transfers: Failures and Refunds