Skip to main content
Evidence can only be updated while is_response_editable is true. Once you submit via Submit Dispute, the evidence is locked and this endpoint will return a 409 error.

​
Request

​
Method & Path

​
Headers

​
Path Parameters

​
string
required
The unique identifier for the dispute.

​
Request Fields

All fields are optional. Include only the fields you want to set or update.
customer_email_address, customer_name, and billing_address are prefilled from the customer record attached to the disputed charge when the dispute is raised, falling back to the customer’s email as the name when no name is on file. They are ordinary evidence fields once prefilled: send a value here to overwrite what was prefilled, or send an empty string to clear it, the same as any other field.
​
string
Max Length: 500Customer’s billing address as it appears on their payment record. Prefilled from the customer’s billing_address when one is on file.
​
string
Max Length:Your cancellation policy text as it was presented to the customer at the time of purchase.
​
string
Max Length: 255Email address of the customer who filed the dispute. Prefilled from the customer record when available.
​
string
Max Length: 255Full name of the customer. Prefilled from the customer record when available.
​
string
Max Length:Freeform notes with any additional context that supports your case.
​
string
Max Length:A clear description of the product or service delivered, including any identifiers (e.g., subscription plan, order ID).
​
string
Max Length:Your refund policy text as it was presented to the customer at the time of purchase.
​
string
Max Length:An explanation of why a refund was not granted, if applicable.
​
string
Max Length: 32The date the service was rendered or the product was delivered (e.g., 2026-03-01).
​
string
An access or activity log showing the customer used what they paid for: timestamps, IP addresses, and the pages or features they reached. For a “product not received” or “service not rendered” dispute this is often the strongest single piece of evidence, because it contradicts the claim directly.
​
string
Max Length: 64document_id from Upload Dispute Document for your cancellation policy document. Pair it with cancellation_policy_disclosure: the text says what the policy is, the file shows the customer was given it. Replaces any previously attached document.
​
string
Max Length: 64document_id from Upload Dispute Document for your refund policy document. Pair it with refund_policy_disclosure the same way. Replaces any previously attached document.
​
string
Max Length: 64document_id from Upload Dispute Document for a general supporting file. Replaces any previously attached document.
​
string
Max Length: 64document_id from Upload Dispute Document for a file showing communication with the customer (e.g., email or chat screenshot). Replaces any previously attached document.

​
Request Example

​
Response

​
200 Success

​
Response Fields

​
string
The dispute whose evidence was updated.
​
string
Current dispute status.
​
boolean
Reflects editability after the update. Will be true as long as the dispute has not been submitted and the deadline has not passed.
​
string
ISO 8601 timestamp of this update.
To review the full evidence state after updating, call Get Dispute.

​
Errors