A dispute is a situation in which a customer questions the validity of a transaction that was registered to their account.
If you are unfamiliar with how disputes are received, fees associated, and what to submit please review Stripe's documentation.
- Create a Webhook between Stripe and Salesforce.
- In order to test disputes you will need to use a specific test card created for dispute simulation. See here.
- Navigate to the Dispute object.
Lightning: Navigate to app launcher, under "All Items" select Dispute.
Classic: Click "All Tabs" (The "+" icon in the top right corner), select Dispute.
A Dispute record is created through Webhook Events with the status "Needs Response".
The disputed Transaction's
Payment Statuschanges from "Captured" to "Disputed" and a refund Transaction is created for the captured amount. The Stripe fee for the dispute will also be populated on the
Payment Gateway Feefield on the refund transaction.
If you notice that two refund transactions are created when you receive a dispute this is because the old dispute logic operated in this manner. Please upgrade to the latest Payments package to see the most recent dispute logic.
When receiving a Dispute, you have until the
Due Bydate to formally respond and submit all supporting evidence.
Reasonis what the cardholder defined the disputed payment as.
Past Due, Has Evidence and Refundablefields are for tracking where the disputed record is in the process.
These fields can be used as notification filters in a Workflow, Process Builder, or Reports to make sure Disputes are submitted before being past due.
After adding your Dispute Evidence and clicking "Submit", the
Submission Count= 1 and the
Status= "Under Review".
It has now been submitted to Stripe's financial partner for review and no changes can be made.
If you won the Dispute,
Statuswill update to "Won". If the card issuer won the Dispute,
Statuswill update to "Lost".
Once a Dispute has been "Won" or "Lost", Stripe will send out an email with the Dispute information.
Important note from Stripe: If you receive a Dispute, try contacting your 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.
Stripe will charge you a $15.00 Dispute fee (for users in the United States) by the card network. If you win the Dispute, the original amount will be refunded to you and a $15.00 adjustment Transaction will be created for you to cover the original Stripe fee.
ACH disputes cannot be contested. If you receive an ACH dispute the Dispute
Status= "Lost" and the original Transaction's
Payment Statuswill update to "Refunded."
The purpose of the Dispute Evidence object is to submit evidence in defense of your Dispute that will push to Stripe. Review all evidence before clicking
Submit, as you cannot update evidence once submitted.
There are four different Record Types for Dispute Evidence. Record Types are used because not all fields are relevant for all Dispute types (as is designed in the Stripe dashboard), however, if you do need access to other fields as part of the Dispute, you can add them to the Page Layout or update the same data set in the Stripe dashboard:
- Basic Response
- Physical Product
- Digital Product or Service
- Offline Service
- Navigate to the Dispute Evidence object.
Lightning/Classic: Navigate to the Dispute record, under Related Lists click "New" for Dispute Evidence.
Select a Record Type and click "Next."
Billing Address, and
Customer IP Addressare general fields for all Product Categories and should be filled out unless they are not applicable.
Stripe Data fields will populate automatically once the Dispute Evidence has been submitted.
- Enter as much information as you can into all sections of the evidence record. Stripe provides best practice recommendations for preparing suitable responses. Click here.
Documentation can be uploaded through the "Upload Files" button under the Dispute Evidence Related List.
- Click on "Upload Files."
- Upload all relevant documentation.
- Click on the
Titlelink of all uploaded file(s).
- Click on
Go To Content Page(classic UI-located in the top right of the page) or click
Edit File Details(Lightning UI-pencil icon in the top right of the page).
Can't find the Go To Content Page link? You might not have "Salesforce CRM Content User" enabled on your user record.
- Under Content Details, click edit, and select
Edit Content Details(Classic UI).
Typeand select the available type for your uploaded documentation.
Can't see the
Typefield in Lightning? Edit the Content Version Page Layout to include the
- Click Save.
Do this for each uploaded file.
- There is no limit to the number of files you can upload.
- Upload documents per
Type, do not combine all documents into one file upload.
- Evidence cannot be added to Lost Disputes.
When you have uploaded and defined the
Type of your documentation you are ready to
Submit your evidence.
- Navigate to your Dispute Evidence record.
- Click the
Once you click this submit button, you can no longer edit, delete, or add anything to the record.
What happens when you
- Evidence is submitted to Stripe's financial partner.
- No can no longer edit, delete, or add anything to the record.
Status= "Under Review".
Submission Count= 1.
Has Evidenceis checked.
Then you wait...50-75 days for a response :)
Submitting Evidence in Stripe:
If you submit evidence in the Stripe Dashboard (as opposed to Salesforce), all evidence information will get created in Salesforce as Webhook Events.
The Dispute Evidence record will relate to the open Dispute.
File Idfields will populate with a Stripe Id if a document was uploaded for that particular
- Learn more about evidence submission.
Closing the Dispute for a charge indicates that you do not have any evidence to submit and are essentially ‘dismissing’ the Dispute, acknowledging it as lost. The disputed amount and $15 fee will not be reimbursed to you.
Steps to Accept a Dispute:
Navigate to the Dispute record.
Status will update to "Lost".
Losing a Dispute will update the original Transactions
If your customer has created a Dispute in error and plans to withdraw it, submit proof in Dispute Evidence that the customer made a mistake.
When a dispute is withdrawn:
The original Transaction amount will be refunded to you.
An adjustment Transaction for $15.00 will be created. This is Stripe reimbursing you for the Dispute fee.
Payment Statuson the original Transaction will update to "Captured."
If you are refunding your customer that has withdrawn their dispute, it can take up to 75 days to refund the payment because the disputed claim must close first.
Trying to refund a Transaction before the Dispute is closed will result in a failed Transaction.
Steps for refunding a withdrawn Dispute:
- Once the Dispute
Status= "Won", navigate back to the original Transaction and click
Refundat the top of the page (Classic UI) or click the drop-down arrow and select
Additional information on refunding a withdrawn Dispute.
Updated 11 months ago