Attributes
- idstring
Unique identifier for the object.
- amountinteger
Disputed amount in the card’s currency and in the smallest currency unit. Usually the amount of the
transaction
, but can differ (usually because of currency fluctuation). - balance_
transactionsnullable array of objectsExpandable List of balance transactions associated with the dispute.
- balance_transactions.
idstring Unique identifier for the object.
- balance_transactions.
objectstring String representing the object’s type. Objects of the same type share the same value.
- balance_transactions.
amountinteger Gross amount of this transaction (in cents). A positive value represents funds charged to another party, and a negative value represents funds sent to another party.
- balance_transactions.
available_ ontimestamp The date that the transaction’s net funds become available in the Stripe balance.
- balance_transactions.
balance_ typeenumPreview feature The balance that this transaction impacts.
Possible enum valuesissuing
Balance Transactions that affect your Issuing balance
payments
Balance Transactions that affect your Payments balance
refund_
and_ dispute_ prefunding Balance Transactions that affect your Refund and Dispute Prefunding balance
- balance_transactions.
createdtimestamp Time at which the object was created. Measured in seconds since the Unix epoch.
- balance_transactions.
currencyenum Three-letter ISO currency code, in lowercase. Must be a supported currency.
- balance_transactions.
descriptionnullable string An arbitrary string attached to the object. Often useful for displaying to users.
- balance_transactions.
exchange_ ratenullable float If applicable, this transaction uses an exchange rate. If money converts from currency A to currency B, then the
amount
in currency A, multipled by theexchange_
, equals therate amount
in currency B. For example, if you charge a customer 10.00 EUR, the PaymentIntent’samount
is1000
andcurrency
iseur
. If this converts to 12.34 USD in your Stripe account, the BalanceTransaction’samount
is1234
, itscurrency
isusd
, and theexchange_
israte 1.
.234 - balance_transactions.
feeinteger Fees (in cents) paid for this transaction. Represented as a positive integer when assessed.
- balance_transactions.
fee_ detailsarray of objects Detailed breakdown of fees (in cents) paid for this transaction.
- balance_transactions.
fee_details. amountinteger Amount of the fee, in cents.
- balance_transactions.
fee_details. applicationnullable string ID of the Connect application that earned the fee.
- balance_transactions.
fee_details. currencyenum Three-letter ISO currency code, in lowercase. Must be a supported currency.
- balance_transactions.
fee_details. descriptionnullable string An arbitrary string attached to the object. Often useful for displaying to users.
- balance_transactions.
fee_details. typestring Type of the fee, one of:
application_
,fee payment_
,method_ passthrough_ fee stripe_
orfee tax
.
- balance_transactions.
netinteger Net impact to a Stripe balance (in cents). A positive value represents incrementing a Stripe balance, and a negative value decrementing a Stripe balance. You can calculate the net impact of a transaction on a balance by
amount
-fee
- balance_transactions.
reporting_ categorystring Learn more about how reporting categories can help you understand balance transactions from an accounting perspective.
- balance_transactions.
sourcenullable stringExpandable This transaction relates to the Stripe object.
- balance_transactions.
statusstring The transaction’s net funds status in the Stripe balance, which are either
available
orpending
. - balance_transactions.
typeenum Transaction type:
adjustment
,advance
,advance_
,funding anticipation_
,repayment application_
,fee application_
,fee_ refund charge
,climate_
,order_ purchase climate_
,order_ refund connect_
,collection_ transfer contribution
,issuing_
,authorization_ hold issuing_
,authorization_ release issuing_
,dispute issuing_
,transaction obligation_
,outbound obligation_
,reversal_ inbound payment
,payment_
,failure_ refund payment_
,network_ reserve_ hold payment_
,network_ reserve_ release payment_
,refund payment_
,reversal payment_
,unreconciled payout
,payout_
,cancel payout_
,failure payout_
,minimum_ balance_ hold payout_
,minimum_ balance_ release refund
,refund_
,failure reserve_
,transaction reserved_
,funds stripe_
,fee stripe_
,fx_ fee stripe_
,balance_ payment_ debit stripe_
,balance_ payment_ debit_ reversal tax_
,fee topup
,topup_
,reversal transfer
,transfer_
,cancel transfer_
, orfailure transfer_
. Learn more about balance transaction types and what they represent. To classify transactions for accounting purposes, considerrefund reporting_
instead.category Possible enum valuesadjustment
advance
advance_
funding anticipation_
repayment application_
fee application_
fee_ refund charge
climate_
order_ purchase climate_
order_ refund connect_
collection_ transfer Show 34 more
- currencyenum
The currency the
transaction
was made in. - evidenceobject
Evidence for the dispute. Evidence contains exactly two non-null fields: the
reason
for the dispute and the associated evidence field for the selectedreason
.- evidence.
cancelednullable object Evidence provided when
reason
is ‘canceled’.- evidence.
canceled. additional_ documentationnullable stringExpandable (ID of a file upload) Additional documentation supporting the dispute.
- evidence.
canceled. canceled_ atnullable timestamp Date when order was canceled.
- evidence.
canceled. cancellation_ policy_ providednullable boolean Whether the cardholder was provided with a cancellation policy.
- evidence.
canceled. cancellation_ reasonnullable string Reason for canceling the order.
- evidence.
canceled. expected_ atnullable timestamp Date when the cardholder expected to receive the product.
- evidence.
canceled. explanationnullable string Explanation of why the cardholder is disputing this transaction.
- evidence.
canceled. product_ descriptionnullable string Description of the merchandise or service that was purchased.
- evidence.
canceled. product_ typenullable enum Whether the product was a merchandise or service.
Possible enum valuesmerchandise
Tangible goods such as groceries and furniture.
service
Intangible goods such as domain name registration, flights and lessons.
- evidence.
canceled. return_ statusnullable enum Result of cardholder’s attempt to return the product.
Possible enum valuesmerchant_
rejected The merchant rejected the return.
successful
The merchant accepted the return.
- evidence.
canceled. returned_ atnullable timestamp Date when the product was returned or attempted to be returned.
- evidence.
duplicatenullable object Evidence provided when
reason
is ‘duplicate’.- evidence.
duplicate. additional_ documentationnullable stringExpandable (ID of a file upload) Additional documentation supporting the dispute.
- evidence.
duplicate. card_ statementnullable stringExpandable (ID of a file upload) Copy of the card statement showing that the product had already been paid for.
- evidence.
duplicate. cash_ receiptnullable stringExpandable (ID of a file upload) Copy of the receipt showing that the product had been paid for in cash.
- evidence.
duplicate. check_ imagenullable stringExpandable (ID of a file upload) Image of the front and back of the check that was used to pay for the product.
- evidence.
duplicate. explanationnullable string Explanation of why the cardholder is disputing this transaction.
- evidence.
duplicate. original_ transactionnullable string Transaction (e.g., ipi_…) that the disputed transaction is a duplicate of. Of the two or more transactions that are copies of each other, this is original undisputed one.
- evidence.
fraudulentnullable object Evidence provided when
reason
is ‘fraudulent’.- evidence.
fraudulent. additional_ documentationnullable stringExpandable (ID of a file upload) Additional documentation supporting the dispute.
- evidence.
fraudulent. explanationnullable string Explanation of why the cardholder is disputing this transaction.
- evidence.
merchandise_ not_ as_ describednullable object Evidence provided when
reason
is ‘merchandise_not_as_described’.- evidence.
merchandise_not_as_described. additional_ documentationnullable stringExpandable (ID of a file upload) Additional documentation supporting the dispute.
- evidence.
merchandise_not_as_described. explanationnullable string Explanation of why the cardholder is disputing this transaction.
- evidence.
merchandise_not_as_described. received_ atnullable timestamp Date when the product was received.
- evidence.
merchandise_not_as_described. return_ descriptionnullable string Description of the cardholder’s attempt to return the product.
- evidence.
merchandise_not_as_described. return_ statusnullable enum Result of cardholder’s attempt to return the product.
Possible enum valuesmerchant_
rejected The merchant rejected the return.
successful
The merchant accepted the return.
- evidence.
merchandise_not_as_described. returned_ atnullable timestamp Date when the product was returned or attempted to be returned.
- evidence.
nullable object Evidence provided when
reason
is ‘no_valid_authorization’.- evidence.
no_valid_authorization. nullable stringExpandable (ID of a file upload) Additional documentation supporting the dispute.
- evidence.
no_valid_authorization. nullable string Explanation of why the cardholder is disputing this transaction.
- evidence.
not_ receivednullable object Evidence provided when
reason
is ‘not_received’.- evidence.
not_received. additional_ documentationnullable stringExpandable (ID of a file upload) Additional documentation supporting the dispute.
- evidence.
not_received. expected_ atnullable timestamp Date when the cardholder expected to receive the product.
- evidence.
not_received. explanationnullable string Explanation of why the cardholder is disputing this transaction.
- evidence.
not_received. product_ descriptionnullable string Description of the merchandise or service that was purchased.
- evidence.
not_received. product_ typenullable enum Whether the product was a merchandise or service.
Possible enum valuesmerchandise
Tangible goods such as groceries and furniture.
service
Intangible goods such as domain name registration, flights and lessons.
- evidence.
othernullable object Evidence provided when
reason
is ‘other’.- evidence.
other. additional_ documentationnullable stringExpandable (ID of a file upload) Additional documentation supporting the dispute.
- evidence.
other. explanationnullable string Explanation of why the cardholder is disputing this transaction.
- evidence.
other. product_ descriptionnullable string Description of the merchandise or service that was purchased.
- evidence.
other. product_ typenullable enum Whether the product was a merchandise or service.
Possible enum valuesmerchandise
Tangible goods such as groceries and furniture.
service
Intangible goods such as domain name registration, flights and lessons.
- evidence.
reasonenum The reason for filing the dispute. Its value will match the field containing the evidence.
Possible enum valuescanceled
Service or merchandise was canceled.
duplicate
There were multiple copies of a charge for a single purchase, or the charge was paid by other means.
fraudulent
The cardholder’s details were compromised and the cardholder claims to not have participated in the transaction.
merchandise_
not_ as_ described The merchandise was not as described.
no_
valid_ authorization The merchant processed a transaction without first obtaining a correct and valid authorization approval.
not_
received Merchandise or service was not received.
other
All other types of disputes.
service_
not_ as_ described The service was not as described.
- evidence.
service_ not_ as_ describednullable object Evidence provided when
reason
is ‘service_not_as_described’.- evidence.
service_not_as_described. additional_ documentationnullable stringExpandable (ID of a file upload) Additional documentation supporting the dispute.
- evidence.
service_not_as_described. canceled_ atnullable timestamp Date when order was canceled.
- evidence.
service_not_as_described. cancellation_ reasonnullable string Reason for canceling the order.
- evidence.
service_not_as_described. explanationnullable string Explanation of why the cardholder is disputing this transaction.
- evidence.
service_not_as_described. received_ atnullable timestamp Date when the product was received.
- metadataobject
Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
- statusenum
Current status of the dispute.
Possible enum valuesexpired
The dispute has expired.
lost
The dispute is lost.
submitted
The dispute has been submitted to Stripe.
unsubmitted
The dispute is pending submission to Stripe.
won
The dispute is won.
- transactionstringExpandable
The transaction being disputed.
More attributes
- objectstring
String representing the object’s type. Objects of the same type share the same value.
- createdtimestamp
Time at which the object was created. Measured in seconds since the Unix epoch.
- livemodeboolean
Has the value
true
if the object exists in live mode or the valuefalse
if the object exists in test mode. - loss_
reasonnullable enum The enum that describes the dispute loss outcome. If the dispute is not lost, this field will be absent. New enum values may be added in the future, so be sure to handle unknown values.
Possible enum valuescardholder_
authentication_ issuer_ liability This dispute, created for Card-Not-Present fraud, is invalid because the card network has indicated the cardholder was securely authenticated. This most commonly occurs via 3DS or a secure digital wallet (e.g. Apple Pay). The dispute was automatically rejected by the card network.
eci5_
token_ transaction_ with_ tavv DEPRECATED: This dispute, created under Condition 10.4: Other Fraud, is invalid for an ECI 5 Token Transaction where the Token Authentication Verification Value (TAVV) was included in the Authorization Request. The dispute was automatically rejected by Visa.
excess_
disputes_ in_ timeframe This dispute is invalid as more than 35 total disputes have been submitted with 120 calendar days of this dispute. The dispute was automatically rejected by the card network.
has_
not_ met_ the_ minimum_ dispute_ amount_ requirements This dispute has not met the minimum amount threshold set by the card network based on the MCC. The dispute was automatically rejected by the card network.
invalid_
duplicate_ dispute This dispute, created under Condition 12.6: Duplicate Processing/Paid by Other Means, has not met the criteria set by Visa. The dispute was automatically rejected by Visa.
invalid_
incorrect_ amount_ dispute This dispute, created under Condition 12.5: Incorrect Amount, has not met the criteria set by Visa. The dispute must include evidence of the correct amount. The dispute was automatically rejected by Visa.
invalid_
no_ authorization The dispute, created under Condition 11.3: No Authorization, is invalid due to the transaction being authorized as indicated in the Visa Core Rules and Visa Product and Service Rules. The dispute was automatically rejected by Visa.
invalid_
use_ of_ disputes Stripe has determined that this is an invalid use of the card network dispute process; no dispute conditions apply.
merchandise_
delivered_ or_ shipped The merchant provided evidence indicating that the merchandise was shipped/delivered. Stripe has evaluated this evidence and determined that it is compelling.
merchandise_
or_ service_ as_ described The merchant provided information indicating the item/service provided matched the description. Stripe has evaluated this evidence and determined that it is compelling.
Show 10 more
{ "id": "idp_1MykdxFtDWhhyHE1BFAV3osZ", "object": "issuing.dispute", "amount": 100, "created": 1681947753, "currency": "usd", "evidence": { "fraudulent": { "additional_documentation": null, "dispute_explanation": null, "explanation": "This transaction is fraudulent.", "uncategorized_file": null }, "reason": "fraudulent" }, "livemode": false, "metadata": {}, "status": "unsubmitted", "transaction": "ipi_1MykXhFtDWhhyHE1UjsZZ3xQ"}