Categorías y tipos de presentación de informes
Comprender las categorías de los objetos de transacciones de saldo y sus distinciones.
Más información sobre el campo reporting_ activado en los objetos de BalanceTransaction y en qué se diferencia detype y otras categorizaciones.
El campo de categoría de informes
El objeto BalanceTransaction con el campo reporting_ mejora el campo type, ya que proporciona una agrupación más útil para la mayoría de los fines financieros y de informes. En las siguientes secciones se describen las ventajas del campo reporting-category.
Un desglose más detallado de tipo=ajuste
El atributo reporting_ separa las transacciones de saldo con type=adjustment en varias categorías diferentes, incluidas disputas, reversiones de disputas y reembolsos fallidos. Además, clasifica varios tipos de tarifas y Connect reembolsos de comisiones de la plataforma con reporting_.
Una categoría separada para anulaciones de capturas parciales
Si estás autorizando y capturando pagos por separado, y capturas un importe inferior a la autorización inicial, verás dos transacciones de saldo: una por el importe total de la autorización y otra que revierte la parte no capturada. (La suma de las dos transacciones de saldo produce la parte capturada del cargo).
La transacción de saldo que anula la parte no capturada tiene type=refund, como si hubieses rembolsado una parte de la compra con posterioridad. Para poder gestionar estos objetos por separado (quizás imputándolos al importe inicial de venta en lugar de como un rembolso separado), los rotulamos con la categoría diferenciada de informe partial_.
Consolidar varios tipos en categorías comunes
Si se usa el campo type, las transacciones de saldo derivadas de cargos con tarjeta se representan con type=charge, mientras que las transacciones realizadas con otros métodos de pago se representan con type=payment. Del mismo modo, los reembolsos y los pagos con tarjeta fallidos, en contraposición con otros métodos de pago, tienen los tipos diferenciados refund y payment_.
El atributo reporting_ simplifica estos (y otros) grupos de tipos, de la siguiente manera:
| Tipos de transacciones de saldo | Categoría de informes |
|---|---|
charge, payment | charge |
refund, payment_ | refund |
payout_, payout_ | payout_ |
transfer, recipient_ | transfer |
transfer_, transfer_, recipient_, recipient_ | transfer_ |
Nombres de categorías más descriptivos
Cambiamos el nombre de varios tipos de transacciones de saldo para mayor claridad:
| Tipo de transacciones de saldo | Categoría de informes |
|---|---|
application_ | platform_ |
application_ | platform_ |
stripe_ | fee |
reserve_ | connect_ |
reserved_ | risk_ |
Referencia sobre las categorías de informes
Esta referencia cubre los siguientes grupos de categorías de informes:
- 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.
- Tipos de transacciones de saldo:
charge,payment, orvalidation - Secciones del informe mensual: Payments (cards), Payments (other)
- Tipos de transacciones de saldo:
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 - Tipos de transacciones de saldo:
payment_failure_ refund - Secciones del informe mensual: Other Adjustments
- Tipos de transacciones de saldo:
disputeWhen a customer disputes a charge, Stripe deducts the disputed amount from your balance.
- Tipos de transacciones de saldo:
adjustmentoradjusted_for_ overdraft_ transaction - Secciones del informe mensual: Disputes
- Tipos de transacciones de saldo:
dispute_reversal When you win a dispute, the disputed amount is returned to your balance.
- Tipos de transacciones de saldo:
adjustment - Secciones del informe mensual: Dispute Reversals
- Tipos de transacciones de saldo:
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 - Tipos de transacciones de saldo:
refund - Secciones del informe mensual: Payments (cards)
- Tipos de transacciones de saldo:
refundPayments you’ve refunded to your customers. (Does not include charge failures or partial capture reversals, which are listed separately.)
- Tipos de transacciones de saldo:
refundorpayment_refund - Secciones del informe mensual: Refunds (cards), Refunds (other)
- Tipos de transacciones de saldo:
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).
- Tipos de transacciones de saldo:
refund_failure - Secciones del informe mensual: Other Adjustments
- Tipos de transacciones de saldo:
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.
- Tipos de transacciones de saldo:
anticipation_repayment - Secciones del informe mensual: Anticipation Repayments
- Tipos de transacciones de saldo:
climate_order_ purchase Funds used to purchase carbon removal units from Frontier Climate.
- Tipos de transacciones de saldo:
climate_ororder_ purchase climate_reservation_ purchase - Secciones del informe mensual: Other Adjustments
- Tipos de transacciones de saldo:
climate_order_ refund Funds refunded to your balance when a Climate Order is canceled.
- Tipos de transacciones de saldo:
climate_ororder_ refund climate_reservation_ refund - Secciones del informe mensual: Other Adjustments
- Tipos de transacciones de saldo:
contributionFunds contributed via Stripe to a cause (currently Stripe Climate).
- Tipos de transacciones de saldo:
contribution - Secciones del informe mensual: Other Adjustments
- Tipos de transacciones de saldo:
currency_conversion Adjustment to your Stripe balance related to currency conversion.
- Tipos de transacciones de saldo:
currency_conversion - Secciones del informe mensual: Other Adjustments
- Tipos de transacciones de saldo:
fee- Tipos de transacciones de saldo:
stripe_fee - Secciones del informe mensual: Other Adjustments
- Tipos de transacciones de saldo:
other_adjustment Miscellaneous adjustments to your Stripe balance.
- Tipos de transacciones de saldo:
adjustment,obligation_, oroutbound obligation_reversal_ inbound - Secciones del informe mensual: Other Adjustments
- Tipos de transacciones de saldo:
payment_network_ reserve_ hold Funds that a payment network holds in reserve (e.g. to mitigate risk).
- Tipos de transacciones de saldo:
payment_network_ reserve_ hold - Secciones del informe mensual: Other Adjustments
- Tipos de transacciones de saldo:
payment_network_ reserve_ release Funds that a payment network releases from a reserve.
- Tipos de transacciones de saldo:
payment_network_ reserve_ release - Secciones del informe mensual: Other Adjustments
- Tipos de transacciones de saldo:
payoutPayouts from your Stripe balance to your bank account.
- Tipos de transacciones de saldo:
payout - Secciones del informe mensual: Payouts and Transfers
- Tipos de transacciones de saldo:
payout_minimum_ balance_ hold Minimum balance held from a payout.
- Tipos de transacciones de saldo:
payout_minimum_ balance_ hold - Secciones del informe mensual: Payout minimum balance hold
- Tipos de transacciones de saldo:
payout_minimum_ balance_ release Minimum balance released after a payout.
- Tipos de transacciones de saldo:
payout_minimum_ balance_ release - Secciones del informe mensual: Payout minimum balance release
- Tipos de transacciones de saldo:
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.
- Tipos de transacciones de saldo:
payout_orcancel payout_failure - Secciones del informe mensual: Payouts and Transfers: Failures and Refunds
- Tipos de transacciones de saldo:
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.
- Tipos de transacciones de saldo:
reserved_funds - Secciones del informe mensual: Other Adjustments
- Tipos de transacciones de saldo:
stripe_balance_ payment_ debit Created when a payment initiated by another Stripe account deducts funds from your account balance.
- Tipos de transacciones de saldo:
stripe_balance_ payment_ debit - Secciones del informe mensual: Other Adjustments
- Tipos de transacciones de saldo:
stripe_balance_ payment_ debit_ reversal Created when a payment initiated by another Stripe account is refunded to your account balance.
- Tipos de transacciones de saldo:
stripe_balance_ payment_ debit_ reversal - Secciones del informe mensual: Other Adjustments
- Tipos de transacciones de saldo:
taxTaxes collected by Stripe to be remitted to the appropriate local governments. Typically, this is a tax on Stripe fees.
- Tipos de transacciones de saldo:
tax_fee - Secciones del informe mensual: Other Adjustments
- Tipos de transacciones de saldo:
topupFunds you transferred into your Stripe balance from your bank account. Learn more.
- Tipos de transacciones de saldo:
topup - Secciones del informe mensual: Other Adjustments
- Tipos de transacciones de saldo:
topup_reversal If an initially successful top-up fails or is cancelled, the credit to your Stripe balance is reversed. Learn more.
- Tipos de transacciones de saldo:
topup_reversal - Secciones del informe mensual: Other Adjustments
- Tipos de transacciones de saldo:
unreconciled_customer_ funds When a customer has unreconciled funds within Stripe for more than ninety days, Stripe transfers those funds to your balance.
- Tipos de transacciones de saldo:
transferred_to_ balance_ transaction - Secciones del informe mensual: Other Adjustments
- Tipos de transacciones de saldo:
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 - Tipos de transacciones de saldo:
issuing_authorization_ hold - Secciones del informe mensual: Other Adjustments
- Tipos de transacciones de saldo:
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 - Tipos de transacciones de saldo:
issuing_authorization_ release - Secciones del informe mensual: Other Adjustments
- Tipos de transacciones de saldo:
issuing_disbursement Credits to your balance for rewards, discounts, and other miscellaneous adjustments.
- Tipos de transacciones de saldo:
issuing_disbursement - Secciones del informe mensual: Other Adjustments
- Tipos de transacciones de saldo:
issuing_dispute When you dispute an Issuing transaction and funds return to your Stripe balance.
- Tipos de transacciones de saldo:
issuing_dispute - Secciones del informe mensual: Other Adjustments
- Tipos de transacciones de saldo:
issuing_dispute_ fraud_ liability_ debit Funds deducted from your account to cover fraud loss liability
- Tipos de transacciones de saldo:
issuing_dispute_ fraud_ liability_ debit - Secciones del informe mensual: Other Adjustments
- Tipos de transacciones de saldo:
issuing_dispute_ provisional_ credit Provisional Credit granted to Issuing balance
- Tipos de transacciones de saldo:
issuing_dispute_ provisional_ credit - Secciones del informe mensual: Other Adjustments
- Tipos de transacciones de saldo:
issuing_dispute_ provisional_ credit_ reversal Previous Provisional Credit being reversed from Issuing balance
- Tipos de transacciones de saldo:
issuing_dispute_ provisional_ credit_ reversal - Secciones del informe mensual: Other Adjustments
- Tipos de transacciones de saldo:
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 - Tipos de transacciones de saldo:
issuing_transaction - Secciones del informe mensual: Other Adjustments
- Tipos de transacciones de saldo:
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 - Tipos de transacciones de saldo:
advance - Secciones del informe mensual: Other Adjustments
- Tipos de transacciones de saldo:
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 - Tipos de transacciones de saldo:
advance_funding - Secciones del informe mensual: Other Adjustments
- Tipos de transacciones de saldo:
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.
- Tipos de transacciones de saldo:
connect_collection_ transfer - Secciones del informe mensual: Reflected in "Reserve" section
- Tipos de transacciones de saldo:
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 - Tipos de transacciones de saldo:
reserve_transaction - Secciones del informe mensual: Reflected in "Reserve" section
- Tipos de transacciones de saldo:
platform_earning Earnings you’ve generated by collecting platform fees via Stripe Connect charges.
- Tipos de transacciones de saldo:
application_fee - Secciones del informe mensual: Application Revenue
- Tipos de transacciones de saldo:
platform_earning_ refund Platform fees that you have returned to your connected accounts.
- Tipos de transacciones de saldo:
application_fee_ refund - Secciones del informe mensual: Application Revenue Returned
- Tipos de transacciones de saldo:
transferFunds sent from your balance to the balance of your connected accounts.
- Tipos de transacciones de saldo:
transferorrecipient_transfer - Secciones del informe mensual: Payouts and Transfers
- Tipos de transacciones de saldo:
transfer_reversal Transfers to your connected accounts that have been cancelled.
- Tipos de transacciones de saldo:
transfer_,cancel transfer_,refund recipient_, ortransfer_ cancel recipient_transfer_ failure - Secciones del informe mensual: Payouts and Transfers: Failures and Refunds
- Tipos de transacciones de saldo: