Disputes Overview

    Learn what disputes are, how the process works, and how to respond should a dispute occur. If you need help after reading this, search our documentation or check out answers to common questions.

    A dispute occurs when one of your customers questions your charge with their bank or credit card company. Banks usually ask customers for a reason for the dispute.

    Following the customer’s complaint, most banks tend to immediately side with the customer without additional investigation, and initiate a formal dispute. This can be pretty frustrating (and is a case of somewhat misaligned incentives), but there is a dispute resolution process, and in many cases you can prove that the charge was valid. Stripe will provide you with the dispute details, and we’ll then work with you to fight any disputes that you feel are unjustified.

    Although we’ve developed tools and a knowledgebase for fighting disputes, the best way to manage disputes is to prevent them from occurring in the first place.

    Dispute process

    Once you’ve been notified of a dispute, you have a few options:

    • If you have contact details for the customer, you can get in touch with them to understand the reason for the dispute. It’s possible (maybe even likely) that the customer simply did not recognize the transaction; contacting them can often help resolve the issue quickly. If the dispute is the result of a misunderstanding, the customer can ask their bank to withdraw the dispute. Even if your customer withdraws, it’s still important to provide evidence in the case.

    • You can respond to the dispute. To do this, simply visit the dispute’s page (at the URL we email you) and provide evidence appropriate for the dispute category. You can also submit evidence via the API. We will guide you through the appropriate evidence to provide depending on the type of dispute. We will submit any information you can provide to your customer’s credit card company and keep you posted afterwards.

    • You can accept the dispute—effectively agreeing to the bank’s refund of the transaction. You should always perform this action if you do not intend to respond and submit evidence.

    How to respond

    Below we’ve compiled information to help you prevent disputes, and respond to them when they do occur. Please note that we will pass along the responses you provide directly to your customer’s bank as-is and you will only get one opportunity to present your case. Your goal should be to present a clear and concise argument for why the customer’s bank should resolve the dispute in your favor.

    To overturn a dispute, you’ll want to provide evidence that fits into our typed evidence fields. These fields are specific pieces of information which are most helpful for winning a dispute. For example, if you provide a physical product, then the shipping_number field is very important for winning a product not received dispute. We’ve curated the list of evidence fields so that they are the most relevant for winning disputes. However, different types of dispute require different types of evidence fields. This guide will help you figure out which fields are relevant to your specific dispute. You can find the full list of evidence fields in our API documentation.

    You can respond to a dispute either via the Dashboard or the API. To respond in the Dashboard, you’ll need to go to the disputed charge and click on the “Respond to dispute” button. You can also view all of your disputes by going to http://dashboard.stripe.com/disputes.

    Once you’ve gotten to the dispute response page, we’ll guide through providing information that is most relevant to the particular dispute, and to the products or services that you provided. The more fields you can fill out on this page, the better your chances of overturning the dispute. If you think your product or service is a special case that doesn’t fit the fields shown on the page, you can always go to settings icon and select “All fields” which will allow you to submit evidence for all possible evidence fields.

    To respond to evidence via the API, you’ll need to update a dispute and set the particular evidence fields you’d like to respond with. You can find out more about this in our API documentation for updating a dispute.

    General evidence

    We recommend including the following evidence fields (if available) when responding to all types of disputes:

    • product_description: A description of the product or service which was sold.
    • customer_name: The name of the customer. This field will be automatically filled when possible.
    • customer_email_address: The email address of the customer. This field will be automatically filled when possible.
    • customer_purchase_ip: The IP address that the customer used when making the purchase. This field will be automatically filled when possible, and will be expanded to include geographical data before we send your evidence to the customer’s credit card company.
    • billing_address: The billing address provided by the customer (if the AVS check was successful). This field will be automatically filled when possible.
    • receipt: Any receipt or message sent to the customer notifying them of the charge. This field will be automatically filled with a Stripe generated email receipt if any such receipt was sent.
    • customer_signature: A relevant document or contract showing the customer’s signature.
    • customer_communication: Any communication with the customer that you feel is relevant to your case (for example emails proving that they received the product or service, or demonstrating their use of or satisfaction with the product or service).

    Type-specific evidence

    Depending on the type of dispute, there are best practices for how to respond and what kinds of evidence you should be prepared to provide. You can learn about which evidence fields are most relevant to each type on our Dispute Types page.

    Uncategorized evidence

    If you have further evidence that you feel is relevant to your case but doesn’t fit into any of the fields provided by Stripe, you can include it as uncategorized_text or uncategorized_file.

    Formatting file uploads

    Dispute evidence can be transmitted through several legacy systems as it makes its way to the cardholder’s bank. Here are some tips to keep in mind when uploading documents to make sure they’re legible when they come out the other end:

    • Use a 12 point font or larger
    • Ensure that documents are Letter or A4 size, in portrait orientation

    When uploading screenshots:

    • Crop the screenshot to the area of interest and circle any key components
    • Use a word processor or PDF editor to place the screenshot on a Letter or A4-size white background
    • Make sure that text is legible (equivalent to 12 points) at the scale in which it is sent
    • Use the text fields in the dispute evidence form to state what the image contains and how it supports your case

    In the worst case, your evidence may be downgraded to fax quality (black and white at a resolution of 200 DPI). Using a large font and providing high-contrast images are key to preserving readability.

    Inquiries and retrievals

    Banks may investigate disputed payments before a formal chargeback is created. This type of dispute is known as an inquiry and, unlike a standard dispute, can still be refunded. Most Stripe users may never see an inquiry or retrieval, but you can learn more about the differences between them and disputes.