Attributes
- idstring
Unique identifier for the object.
- amountinteger
Disputed amount. Usually the amount of the charge, but it can differ (usually because of currency fluctuation or because only part of the order is disputed).
- chargestringExpandable
ID of the charge that’s disputed.
- currencyenum
Three-letter ISO currency code, in lowercase. Must be a supported currency.
- evidenceobject
Evidence provided to respond to a dispute. Updating any field in the hash submits all fields in the hash for review.
- evidence.
access_ activity_ lognullable string Any server or activity logs showing proof that the customer accessed or downloaded the purchased digital product. This information should include IP addresses, corresponding timestamps, and any detailed recorded activity.
- evidence.
billing_ addressnullable string The billing address provided by the customer.
- evidence.
cancellation_ policynullable stringExpandable (ID of a file upload) Your subscription cancellation policy, as shown to the customer.
- evidence.
cancellation_ policy_ disclosurenullable string An explanation of how and when the customer was shown your refund policy prior to purchase.
- evidence.
cancellation_ rebuttalnullable string A justification for why the customer’s subscription was not canceled.
- evidence.
customer_ communicationnullable stringExpandable (ID of a file upload) Any communication with the customer that you feel is relevant to your case. Examples include emails proving that the customer received the product or service, or demonstrating their use of or satisfaction with the product or service.
- evidence.
customer_ email_ addressnullable string The email address of the customer.
- evidence.
customer_ namenullable string The name of the customer.
- evidence.
customer_ purchase_ ipnullable string The IP address that the customer used when making the purchase.
- evidence.
customer_ signaturenullable stringExpandable (ID of a file upload) A relevant document or contract showing the customer’s signature.
- evidence.
duplicate_ charge_ documentationnullable stringExpandable (ID of a file upload) Documentation for the prior charge that can uniquely identify the charge, such as a receipt, shipping label, work order, etc. This document should be paired with a similar document from the disputed payment that proves the two payments are separate.
- evidence.
duplicate_ charge_ explanationnullable string An explanation of the difference between the disputed charge versus the prior charge that appears to be a duplicate.
- evidence.
duplicate_ charge_ idnullable string The Stripe ID for the prior charge which appears to be a duplicate of the disputed charge.
- evidence.
enhanced_ evidenceobject Additional evidence for qualifying evidence programs.
- evidence.
enhanced_evidence. visa_ compelling_ evidence_ 3nullable object Evidence provided for Visa Compelling Evidence 3.0 evidence submission.
- evidence.
enhanced_evidence. visa_compelling_evidence_3. disputed_ transactionnullable object Disputed transaction details for Visa Compelling Evidence 3.0 evidence submission.
- evidence.
enhanced_evidence. visa_compelling_evidence_3. disputed_transaction. customer_ account_ idnullable string User Account ID used to log into business platform. Must be recognizable by the user.
- evidence.
enhanced_evidence. visa_compelling_evidence_3. disputed_transaction. customer_ device_ fingerprintnullable string Unique identifier of the cardholder’s device derived from a combination of at least two hardware and software attributes. Must be at least 20 characters.
- evidence.
enhanced_evidence. visa_compelling_evidence_3. disputed_transaction. customer_ device_ idnullable string Unique identifier of the cardholder’s device such as a device serial number (e.g., International Mobile Equipment Identity [IMEI]). Must be at least 15 characters.
- evidence.
enhanced_evidence. visa_compelling_evidence_3. disputed_transaction. customer_ email_ addressnullable string The email address of the customer.
- evidence.
enhanced_evidence. visa_compelling_evidence_3. disputed_transaction. customer_ purchase_ ipnullable string The IP address that the customer used when making the purchase.
- evidence.
enhanced_evidence. visa_compelling_evidence_3. disputed_transaction. merchandise_ or_ servicesnullable enum Categorization of disputed payment.
Possible enum valuesmerchandise
Disputed payment was for a physical product.
services
Disputed payment was for a service.
- evidence.
enhanced_evidence. visa_compelling_evidence_3. disputed_transaction. product_ descriptionnullable string A description of the product or service that was sold.
- evidence.
enhanced_evidence. visa_compelling_evidence_3. disputed_transaction. shipping_ addressnullable object The address to which a physical product was shipped. All fields are required for Visa Compelling Evidence 3.0 evidence submission.
- evidence.
enhanced_evidence. visa_compelling_evidence_3. disputed_transaction. shipping_address. citynullable string City, district, suburb, town, or village.
- evidence.
enhanced_evidence. visa_compelling_evidence_3. disputed_transaction. shipping_address. countrynullable string Two-letter country code (ISO 3166-1 alpha-2).
- evidence.
enhanced_evidence. visa_compelling_evidence_3. disputed_transaction. shipping_address. line1nullable string Address line 1 (e.g., street, PO Box, or company name).
- evidence.
enhanced_evidence. visa_compelling_evidence_3. disputed_transaction. shipping_address. line2nullable string Address line 2 (e.g., apartment, suite, unit, or building).
- evidence.
enhanced_evidence. visa_compelling_evidence_3. disputed_transaction. shipping_address. postal_ codenullable string ZIP or postal code.
- evidence.
enhanced_evidence. visa_compelling_evidence_3. disputed_transaction. shipping_address. statenullable string State, county, province, or region.
- evidence.
enhanced_evidence. visa_compelling_evidence_3. prior_ undisputed_ transactionsarray of objects List of exactly two prior undisputed transaction objects for Visa Compelling Evidence 3.0 evidence submission.
- evidence.
enhanced_evidence. visa_compelling_evidence_3. prior_undisputed_transactions. chargestring Stripe charge ID for the Visa Compelling Evidence 3.0 eligible prior charge.
- evidence.
enhanced_evidence. visa_compelling_evidence_3. prior_undisputed_transactions. customer_ account_ idnullable string User Account ID used to log into business platform. Must be recognizable by the user.
- evidence.
enhanced_evidence. visa_compelling_evidence_3. prior_undisputed_transactions. customer_ device_ fingerprintnullable string Unique identifier of the cardholder’s device derived from a combination of at least two hardware and software attributes. Must be at least 20 characters.
- evidence.
enhanced_evidence. visa_compelling_evidence_3. prior_undisputed_transactions. customer_ device_ idnullable string Unique identifier of the cardholder’s device such as a device serial number (e.g., International Mobile Equipment Identity [IMEI]). Must be at least 15 characters.
- evidence.
enhanced_evidence. visa_compelling_evidence_3. prior_undisputed_transactions. customer_ email_ addressnullable string The email address of the customer.
- evidence.
enhanced_evidence. visa_compelling_evidence_3. prior_undisputed_transactions. customer_ purchase_ ipnullable string The IP address that the customer used when making the purchase.
- evidence.
enhanced_evidence. visa_compelling_evidence_3. prior_undisputed_transactions. product_ descriptionnullable string A description of the product or service that was sold.
- evidence.
enhanced_evidence. visa_compelling_evidence_3. prior_undisputed_transactions. shipping_ addressnullable object The address to which a physical product was shipped. All fields are required for Visa Compelling Evidence 3.0 evidence submission.
- evidence.
enhanced_evidence. visa_compelling_evidence_3. prior_undisputed_transactions. shipping_address. citynullable string City, district, suburb, town, or village.
- evidence.
enhanced_evidence. visa_compelling_evidence_3. prior_undisputed_transactions. shipping_address. countrynullable string Two-letter country code (ISO 3166-1 alpha-2).
- evidence.
enhanced_evidence. visa_compelling_evidence_3. prior_undisputed_transactions. shipping_address. line1nullable string Address line 1 (e.g., street, PO Box, or company name).
- evidence.
enhanced_evidence. visa_compelling_evidence_3. prior_undisputed_transactions. shipping_address. line2nullable string Address line 2 (e.g., apartment, suite, unit, or building).
- evidence.
enhanced_evidence. visa_compelling_evidence_3. prior_undisputed_transactions. shipping_address. postal_ codenullable string ZIP or postal code.
- evidence.
enhanced_evidence. visa_compelling_evidence_3. prior_undisputed_transactions. shipping_address. statenullable string State, county, province, or region.
- evidence.
enhanced_evidence. visa_ compliancenullable object Evidence provided for Visa compliance evidence submission.
- evidence.
enhanced_evidence. visa_compliance. fee_ acknowledgedboolean A field acknowledging the fee incurred when countering a Visa compliance dispute. If this field is set to true, evidence can be submitted for the compliance dispute. Stripe collects a 500 USD (or local equivalent) amount to cover the network costs associated with resolving compliance disputes. Stripe refunds the 500 USD network fee if you win the dispute.
- evidence.
product_ descriptionnullable string A description of the product or service that was sold.
- evidence.
receiptnullable stringExpandable (ID of a file upload) Any receipt or message sent to the customer notifying them of the charge.
- evidence.
refund_ policynullable stringExpandable (ID of a file upload) Your refund policy, as shown to the customer.
- evidence.
refund_ policy_ disclosurenullable string Documentation demonstrating that the customer was shown your refund policy prior to purchase.
- evidence.
refund_ refusal_ explanationnullable string A justification for why the customer is not entitled to a refund.
- evidence.
service_ datenullable string The date on which the customer received or began receiving the purchased service, in a clear human-readable format.
- evidence.
service_ documentationnullable stringExpandable (ID of a file upload) Documentation showing proof that a service was provided to the customer. This could include a copy of a signed contract, work order, or other form of written agreement.
- evidence.
shipping_ addressnullable string The address to which a physical product was shipped. You should try to include as complete address information as possible.
- evidence.
shipping_ carriernullable string The delivery service that shipped a physical product, such as Fedex, UPS, USPS, etc. If multiple carriers were used for this purchase, please separate them with commas.
- evidence.
shipping_ datenullable string The date on which a physical product began its route to the shipping address, in a clear human-readable format.
- evidence.
shipping_ documentationnullable stringExpandable (ID of a file upload) Documentation showing proof that a product was shipped to the customer at the same address the customer provided to you. This could include a copy of the shipment receipt, shipping label, etc. It should show the customer’s full shipping address, if possible.
- evidence.
shipping_ tracking_ numbernullable string The tracking number for a physical product, obtained from the delivery service. If multiple tracking numbers were generated for this purchase, please separate them with commas.
- evidence.
uncategorized_ filenullable stringExpandable (ID of a file upload) Any additional evidence or statements.
- evidence.
uncategorized_ textnullable string Any additional evidence or statements.
- 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.
- payment_
intentnullable stringExpandable ID of the PaymentIntent that’s disputed.
- reasonstring
Reason given by cardholder for dispute. Possible values are
bank_
,cannot_ process check_
,returned credit_
,not_ processed customer_
,initiated debit_
,not_ authorized duplicate
,fraudulent
,general
,incorrect_
,account_ details insufficient_
,funds noncompliant
,product_
,not_ received product_
,unacceptable subscription_
, orcanceled unrecognized
. Learn more about dispute reasons. - statusenum
The current status of a dispute. Possible values include:
warning_
,needs_ response warning_
,under_ review warning_
,closed needs_
,response under_
,review won
,lost
, orprevented
.Possible enum valueslost
A dispute resolved in the customer’s favor.
needs_
response A dispute that requires a response.
prevented
A dispute that was prevented from becoming a formal chargeback.
under_
review A dispute under review after evidence submission.
warning_
closed An inquiry closed without becoming a formal dispute.
warning_
needs_ response An inquiry that requires a response.
warning_
under_ review An inquiry under review after evidence submission.
won
A dispute resolved in the merchant’s favor.
More attributes
- objectstring
String representing the object’s type. Objects of the same type share the same value.
- balance_
transactionsarray of objects List of zero, one, or two balance transactions that show funds withdrawn and reinstated to your Stripe account as a result of this 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
- createdtimestamp
Time at which the object was created. Measured in seconds since the Unix epoch.
- enhanced_
eligibility_ typesarray of enums List of eligibility types that are included in
enhanced_
.evidence Possible enum valuesvisa_
compelling_ evidence_ 3 Dispute is eligible for Visa Compelling Evidence 3.0 evidence submission.
visa_
compliance Dispute is eligible for Visa compliance evidence submission.
- evidence_
detailsobject Information about the evidence submission.
- evidence_details.
due_ bynullable timestamp Date by which evidence must be submitted in order to successfully challenge dispute. Will be 0 if the customer’s bank or credit card company doesn’t allow a response for this particular dispute.
- evidence_details.
enhanced_ eligibilityobject Eligibility details for qualifying evidence programs.
- evidence_details.
enhanced_eligibility. visa_ compelling_ evidence_ 3nullable object Eligibility details for Visa Compelling Evidence 3.0 evidence submission.
- evidence_details.
enhanced_eligibility. visa_compelling_evidence_3. required_ actionsarray of enums List of actions required to qualify dispute for Visa Compelling Evidence 3.0 evidence submission.
Possible enum valuesmissing_
customer_ identifiers disputed_
andtransaction prior_
fields should include a minimum of two customer identifiers. These identifiers can be chosen from the following:undisputed_ transactions customer_
,account_ id customer_
,email_ address shipping_
,address customer_
,purchase_ ip customer_
, ordevice_ id customer_
. At least one of the chosen identifiers must be eitherdevice_ fingerprint customer_
,purchase_ ip customer_
, ordevice_ id customer_
. Note thatdevice_ fingerprint customer_
anddevice_ id customer_
cannot be the only identifiers provided; they must be accompanied by at least one other identifier.device_ fingerprint missing_
disputed_ transaction_ description Missing
product_
fordescription disputed_
.transaction missing_
merchandise_ or_ services Missing
merchandise_
selection foror_ services disputed_
.transaction missing_
prior_ undisputed_ transaction_ description Missing
product_
for one or moredescription prior_
.undisputed_ transactions missing_
prior_ undisputed_ transactions No Visa Compelling Evidence 3.0 eligible prior transactions have been provided.
- evidence_details.
enhanced_eligibility. visa_compelling_evidence_3. statusenum Visa Compelling Evidence 3.0 eligibility status.
Possible enum valuesnot_
qualified Evidence was not qualified to be submitted to Visa as Compelling Evidence 3.0. Evidence was submitted through the standard dispute flow to Visa.
qualified
Evidence will be submitted to Visa as Compelling Evidence 3.0.
requires_
action Transactions provided are potentially eligible, but require further action to be submitted as Compelling Evidence 3.0. See
required_
.action_ details
- evidence_details.
enhanced_eligibility. visa_ compliancenullable object Eligibility details for Visa compliance evidence submission.
- evidence_details.
enhanced_eligibility. visa_compliance. statusenum Visa compliance eligibility status.
Possible enum valuesfee_
acknowledged The network fee for submitting evidence for Visa compliance disputes has been acknowledged. Submitting evidence for this dispute is permitted.
requires_
fee_ acknowledgement The network fee for submitting evidence for Visa compliance disputes has not been acknowledged. Submitting evidence for this dispute is not permitted.
- evidence_details.
has_ evidenceboolean Whether evidence has been staged for this dispute.
- evidence_details.
past_ dueboolean Whether the last evidence submission was submitted past the due date. Defaults to
false
if no evidence submissions have occurred. Iftrue
, then delivery of the latest evidence is not guaranteed. - evidence_details.
submission_ countinteger The number of times evidence has been submitted. Typically, you may only submit evidence once.
- is_
charge_ refundableboolean If true, it’s still possible to refund the disputed payment. After the payment has been fully refunded, no further funds are withdrawn from your Stripe account as a result of this dispute.
- livemodeboolean
Has the value
true
if the object exists in live mode or the valuefalse
if the object exists in test mode. - payment_
method_ detailsnullable object Additional dispute information specific to the payment method type.
- payment_method_details.
amazon_ paynullable object AmazonPay specific dispute details.
- payment_method_details.
amazon_pay. dispute_ typenullable enum The AmazonPay dispute type, chargeback or claim
Possible enum valueschargeback
Disputes triggered via card network or issuing bank
claim
Disputes triggered via Amazon Pay A-to-z guarantee program
- payment_method_details.
cardnullable object Card specific dispute details.
- payment_method_details.
card. brandstring Card brand. Can be
amex
,cartes_
,bancaires diners
,discover
,eftpos_
,au jcb
,link
,mastercard
,unionpay
,visa
orunknown
. - payment_method_details.
card. case_ typeenum The type of dispute opened. Different case types may have varying fees and financial impact.
Possible enum valuesblock
A dispute opened by a cardholder that the card network blocked before it could become a chargeback.
chargeback
The action taken by a cardholder’s bank to debit a business’s account in response to a dispute from the cardholder. The debited funds are held until the dispute is resolved.
compliance
An action taken by the card network when they believe the merchant does not conform to network rules.
inquiry
A pre-dispute request from a card issuer, asking for information about a charge. Based on the response from the business, an inquiry might or might not escalate to a full chargeback. Inquiries are sometimes called retrievals or requests for information.
resolution
A dispute opened by a cardholder that was resolved (refunded) before it could become a chargeback.
- payment_method_details.
card. network_ reason_ codenullable string The card network’s specific dispute reason code, which maps to one of Stripe’s primary dispute categories to simplify response guidance. The Network code map lists all available dispute reason codes by network.
- payment_method_details.
klarnanullable object Klarna specific dispute details.
- payment_method_details.
klarna. reason_ codenullable string The reason for the dispute as defined by Klarna
- payment_method_details.
paypalnullable object Paypal specific dispute details.
- payment_method_details.
paypal. case_ idnullable string The ID of the dispute in PayPal.
- payment_method_details.
paypal. reason_ codenullable string The reason for the dispute as defined by PayPal
- payment_method_details.
typeenum Payment method type.
Possible enum valuesamazon_
pay The dispute corresponds to a AmazonPay payment
card
The dispute corresponds to a card payment
klarna
The dispute corresponds to a Klarna payment
paypal
The dispute corresponds to a PayPal payment
{ "id": "du_1MtJUT2eZvKYlo2CNaw2HvEv", "object": "dispute", "amount": 1000, "balance_transactions": [], "charge": "ch_1AZtxr2eZvKYlo2CJDX8whov", "created": 1680651737, "currency": "usd", "evidence": { "access_activity_log": null, "billing_address": null, "cancellation_policy": null, "cancellation_policy_disclosure": null, "cancellation_rebuttal": null, "customer_communication": null, "customer_email_address": null, "customer_name": null, "customer_purchase_ip": null, "customer_signature": null, "duplicate_charge_documentation": null, "duplicate_charge_explanation": null, "duplicate_charge_id": null, "product_description": null, "receipt": null, "refund_policy": null, "refund_policy_disclosure": null, "refund_refusal_explanation": null, "service_date": null, "service_documentation": null, "shipping_address": null, "shipping_carrier": null, "shipping_date": null, "shipping_documentation": null, "shipping_tracking_number": null, "uncategorized_file": null, "uncategorized_text": null }, "evidence_details": { "due_by": 1682294399, "has_evidence": false, "past_due": false, "submission_count": 0 }, "is_charge_refundable": true, "livemode": false, "metadata": {}, "payment_intent": null, "reason": "general", "status": "warning_needs_response"}