Skip to main content
Schema2020-08-27object

dispute

A dispute occurs when a customer questions your charge with their card issuer. When this happens, you're given the opportunity to respond to the dispute with evidence that shows that the charge is legitimate. You can find more information about the dispute process in our [Disputes and Fraud](/docs/disputes) documentation. Related guide: [Disputes and Fraud](https://stripe.com/docs/disputes).

Source
openapi/spec3.json
Commit
d70de345383d
Active snapshot
da69df7e6e11

DisputeEvidence

object
access_activity_log string
optionalnullable

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.

billing_address string
optionalnullable

The billing address provided by the customer.

cancellation_policy
optionalnullable

(ID of a [file upload](https://stripe.com/docs/guides/file-upload)) Your subscription cancellation policy, as shown to the customer.

cancellation_policy_disclosure string
optionalnullable

An explanation of how and when the customer was shown your refund policy prior to purchase.

cancellation_rebuttal string
optionalnullable

A justification for why the customer's subscription was not canceled.

customer_communication
optionalnullable

(ID of a [file upload](https://stripe.com/docs/guides/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.

customer_email_address string
optionalnullable

The email address of the customer.

customer_name string
optionalnullable

The name of the customer.

customer_purchase_ip string
optionalnullable

The IP address that the customer used when making the purchase.

customer_signature
optionalnullable

(ID of a [file upload](https://stripe.com/docs/guides/file-upload)) A relevant document or contract showing the customer's signature.

duplicate_charge_documentation
optionalnullable

(ID of a [file upload](https://stripe.com/docs/guides/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.

duplicate_charge_explanation string
optionalnullable

An explanation of the difference between the disputed charge versus the prior charge that appears to be a duplicate.

duplicate_charge_id string
optionalnullable

The Stripe ID for the prior charge which appears to be a duplicate of the disputed charge.

product_description string
optionalnullable

A description of the product or service that was sold.

receipt
optionalnullable

(ID of a [file upload](https://stripe.com/docs/guides/file-upload)) Any receipt or message sent to the customer notifying them of the charge.

refund_policy
optionalnullable

(ID of a [file upload](https://stripe.com/docs/guides/file-upload)) Your refund policy, as shown to the customer.

refund_policy_disclosure string
optionalnullable

Documentation demonstrating that the customer was shown your refund policy prior to purchase.

refund_refusal_explanation string
optionalnullable

A justification for why the customer is not entitled to a refund.

service_date string
optionalnullable

The date on which the customer received or began receiving the purchased service, in a clear human-readable format.

service_documentation
optionalnullable

(ID of a [file upload](https://stripe.com/docs/guides/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.

shipping_address string
optionalnullable

The address to which a physical product was shipped. You should try to include as complete address information as possible.

shipping_carrier string
optionalnullable

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.

shipping_date string
optionalnullable

The date on which a physical product began its route to the shipping address, in a clear human-readable format.

shipping_documentation
optionalnullable

(ID of a [file upload](https://stripe.com/docs/guides/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.

shipping_tracking_number string
optionalnullable

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.

uncategorized_file
optionalnullable

(ID of a [file upload](https://stripe.com/docs/guides/file-upload)) Any additional evidence or statements.

uncategorized_text string
optionalnullable

Any additional evidence or statements.