Responding to Disputes

    Learn how to respond to disputes using best practices.

    We recommend most users respond within the Dashboard. The Dashboard guides you through the submission process, step-by-step—automatically formatting the information you provide. You’re asked to provide different pieces of evidence and upload any necessary files, depending on the dispute type. All this works to increase the likelihood of a dispute being found in your favor.

    If you receive a dispute, you may want to first get in touch with the customer and discuss it before you respond. It’s possible that they simply did not recognize or remember the transaction when they viewed their statement. If an email address was provided to Stripe when creating the payment (either to send an email receipt or if it was created using a Customer object), click Email customer to create a new email that contains information about the dispute.

    Clicking Submit evidence begins the response process and provides additional information about the type of dispute and what steps you should take. If you have any information you think the card issuer might want to see, you should submit it as dispute evidence.

    Responding to dipsutes in the Dashboard.

    There is a limited period of time that disputes can be responded to (usually 7–21 days)—the amount of time available is provided within the dispute information. After that time has passed, no further responses or evidence can be submitted. Once you have submitted a response, it generally takes the card issuer 60–75 days to reach a final decision.

    Once you’ve submitted a response, the dispute’s status is changed to under_review. If a dispute is found in your favor, this changes to won. If the card issuer upholds the cardholder’s dispute, the status changes to lost. Once a dispute is closed, we send you an email with information about the outcome and a charge.dispute.closed webhook event.

    Submitting evidence

    The evidence you submit should be appropriate to the reason for the dispute. Web logs, email communications, shipment tracking numbers and delivery confirmation, proof of prior refunds or replacement shipments, etc., can all be helpful. For example, a response to a dispute with the reason “product not received” should have evidence that includes shipping information and any screenshots of package tracking. Stripe electronically submits this information to your cardholder’s issuer and notifies you of any updates to the dispute.

    Stripe automatically formats the evidence you provide into a format accepted by card issuers. This includes all mandatory payment information (e.g., amount, date of payment), CVC or postal code verification results (if available), and any additional information or documents that you provide.

    Starting the dispute process.

    Submitting evidence.

    You can prepare a suitable response that has the most relevant evidence using the following best practices. These can help ensure you have the greatest possible chance of a dispute being found in your favor—and your funds returned.

    Keep your evidence relevant and to the point

    Card issuers review thousands of dispute responses every day. A long introduction about your product or company, complaint about the customer, or the unfairness of the dispute isn’t going to make your responses more compelling. Instead, provide only the facts surrounding the original purchase, using a neutral and professional tone. For example:

    Jenny Rosen purchased X from our company on [date] using their Visa credit card. The customer agreed to our terms of service and authorized this transaction. We shipped the product on [date] to the address provided by the customer, and it was delivered on [date].

    You may want to take some time to investigate the dispute while collecting evidence to submit. For instance, you can take a look at Google Maps and Street View to see where your delivery took place, or check social media like Facebook or LinkedIn to help establish the customer as the legitimate cardholder.

    Many merchants also include email correspondence or texts with the customer, but it’s important to be aware that these exchanges do not verify identity. If you’re going to include them, make sure only the relevant information is included (e.g., if you’re going to include a long email thread, redact any text that is only quoting previous emails).

    Your evidence should be factual, professional, and concise. While providing little evidence is a problem, overwhelming the card issuer with unnecessary information can have the same effect.

    Provide clear and accurate evidence

    Card issuers do not follow any links provided in a response. Instead, you must include a clear screenshot of your terms or policies as they appear during checkout or on your site if they are an important part of your defense (e.g., a customer disputed a subscription but there is a minimum contract term that must be adhered to).

    Include proof of customer authorization

    Fraudulent disputes account for over half of all disputes. Proving the legitimate cardholder was aware of and authorized the transaction being disputed is vitally important in such cases. Any data that shows proof of this is a standard part of a compelling response, such as:

    • AVS (Address Verification System) matches
    • CVC (Card Verification Code) confirmations
    • Signed receipts or contracts
    • IP address that matches the cardholder's verified billing address

    Stripe always includes any AVS/CVC results as well as the purchase IP (if available from your Stripe integration), but if you have any other evidence of authorization be sure to include it.

    Include proof of service or delivery

    In addition to fraudulent disputes, claims from cardholders that products or services never arrived or happened, were defective or unsatisfactory, or not as described are also potential dispute reasons. Assuming that all is well on your side (the product was not faulty, was as described, was shipped and delivered prior to the dispute date) then you’ll want to provide proof of service or delivery.

    For a merchandise purchase, provide proof of shipment and delivery that includes the full delivery address, not just the city and ZIP code. Choosing a carrier or delivery method that requires a signature on delivery provides the best defense against product not received or fraudulent disputes where you’ve shipped to a verified billing address that has passed AVS and ZIP code verification.

    If your customer provides a “Ship To” name that differs from their own (e.g., gift purchase), be prepared to provide documentation explaining why they are different. While it’s common practice to purchase and ship to an address that doesn’t match the card’s verified billing address, this is an additional dispute risk.

    If your business provides digital goods, include evidence such as an IP address or system log proving the customer downloaded the content or used your software or service.

    Include a copy of your terms of service and refund policy

    When it comes to disputes, fine print matters. Providing proof that your customer agreed to and understood your terms of service at checkout, or did not follow your policies when it comes to returns or refunds is critical. A clean screenshot of how your terms of service or other policies are presented during checkout is an important addition to your evidence—it is not enough to simply include a text copy of these.

    Formatting documents and images to upload

    Dispute evidence is often transmitted through several legacy systems and most card issuers are still utilizing paper faxing. Before sending your response, ensure that any text or images are clear and large enough to show up clearly in a black and white fax transmission.

    While you can zoom in on your electronic documents, the card issuer will not be able to do so. Any evidence that is too small to transmit clearly won’t be considered by the card issuer, so it’s better to have large, full-page images than try to fit too many on one page.

    When submitting documents or images as evidence, use the following recommendations to make sure they can remain legible:

    • Use a 12 point font or larger
    • Ensure that documents are U.S. Letter or A4 size, in portrait orientation (screenshots can still be added to your documents in landscape orientation)
    • Use bold text, callouts, or arrows to draw attention to pertinent information
    • Avoid using color highlighting

    When uploading screenshots:

    • Crop the screenshot to the area of interest and circle any key components (e.g., delivery confirmation or signature)
    • Use the text fields in the dispute evidence form to describe what the image contains and how it supports your response

    Any illegible text or data that is submitted with a response will be considered incomplete by the card issuer and not reviewed.

    Accepting disputes

    You can accept a dispute, effectively agreeing with the cardholder that the dispute was valid for the reason given. Accepting a dispute is not considered an admission of wrongdoing and is sometimes the most appropriate response. The customer has already received their refund via the dispute process—if you agree they should have been refunded, it’s best to accept the dispute. You should always perform this action if you do not intend to respond and submit evidence. Although accepting disputes does not negatively affect your business any further, it should not be seen as an alternative to an effective refund or returns policy. Dispute activity is calculated based upon the disputes received, not won or lost, so dispute prevention is critical.


    For disputes that are the result of a misunderstanding, your customer can tell their card issuer that they no longer dispute the transaction. It’s still important that you submit evidence to show that the payment was valid, however, and to ensure that the card issuer knows you are not accepting the dispute.

    In cases where you agree that the customer should keep the disputed funds, you should accept the dispute rather than ask the cardholder to withdraw the dispute for a regular refund. Remember, the card networks do not consider how many disputes you win or lose, only how many you receive.

    Next steps

    Now that you know how to respond to disputes, you may want to learn more about the different reasons for disputes, or move on to related subjects:

    If you require assistance with a dispute, please contact Stripe support.
    Was this page helpful?

    Thank you for helping improve Stripe's documentation. If you need help or have any questions, please consider contacting support.

    On this page