How to send Stripe dispute alerts to Slack and meet the evidence deadline
Get Stripe dispute alerts in Slack the moment a charge is disputed, then work the case day by day. Name an owner, decide whether to fight, gather evidence, and submit once.
The ChargeBell Team
Updated October 1, 2026. 9 min read.

To send Stripe dispute alerts to Slack with ChargeBell, connect Stripe and Slack, turn on the dispute created alert, send it to a channel with an owner, and send a test alert. ChargeBell maps charge.dispute.created, shows the respond-by date when Stripe provides one, and marks the alert critical. It doesn't map charge.dispute.closed, so check the outcome in Stripe. The rest of this guide covers what to do once the alert arrives.
Set up Stripe dispute alerts in Slack
- 1
Connect Stripe and Slack
Approve read-only Stripe access and connect your Slack workspace in ChargeBell.
- 2
Turn on and route disputes
In Alerts, turn on dispute created and pick a channel with a named finance or risk owner. Turn on the critical mention if your team needs it.
- 3
Test and check
Send a ChargeBell test alert and confirm the channel and owner. For a real dispute, open its Stripe link and work from the deadline shown there.
Make disputes your loudest alert
You choose to issue a refund. A dispute comes from the cardholder's bank, has a deadline, and takes the money from your balance right away. Send it somewhere it can't get lost in a busy channel.
What happens when a charge is disputed
When a cardholder disputes a payment with their bank, Stripe sends charge.dispute.created and takes the disputed amount from your available balance. It holds the funds until the case closes. In a formal dispute, the bank has already credited the cardholder, so the money stays off your balance unless you win.
In the US, Stripe pricing lists a $15 dispute fee that you don't get back if you win. Countering a dispute adds a separate $15 fee, which Stripe returns if you win. Amounts and exceptions depend on region and payment method. We checked these US figures on September 25, 2026.
Fees vary by country
The countered fee doesn't apply to businesses in Mexico and Japan, and fees differ by region and change over time. Check the current numbers on Stripe's disputes pricing page.
The Dispute object has the field that matters most, evidence_details.due_by. That's your response deadline, and every step below aims to get a complete response in before it.
The deadline is fixed, and you get one submission
You usually have 7 to 21 days from when the dispute opens, depending on the card network. If you miss the deadline, you lose. Stripe won't review late evidence, and there's no appeal.
You also get one submission. After you submit, you can't edit it, add files, or send more information. Preparation matters as much as speed. A rushed packet sent an hour before the deadline is often weaker than a careful one sent on day three.
- One submission, no edits. Collect everything before you click submit.
- 4.5 MB total file size. Mastercard also limits evidence to 19 pages combined.
- One file per evidence type. Combine several files into one multi-page PDF.
- No audio, video, or links. Stripe won't accept them.
- 150,000 characters. That's the limit across all text evidence fields sent through the API.
The dispute plan, day by day
Most dispute windows run longer than a week. Use the first days to decide and gather evidence, and leave a buffer before the deadline in case a document goes missing.
- 1
Within the hour: claim it and note the deadline
Reply in the alert's Slack thread with the owner's name and the respond-by date. One owner per dispute. Then open the dispute in Stripe and read the reason, such as
fraudulentorproduct_not_received. The reason decides which evidence you need. - 2
Day 1: see if a conversation can fix it
Stripe suggests asking whether the cardholder will withdraw the dispute if you solve the problem another way, such as store credit or a replacement. Don't refund a disputed charge. The bank already credited the cardholder, so a refund can pay them twice.
- 3
Days 1 to 2: decide whether to accept or counter
Compare the disputed amount with the countered fee and the strength of your evidence. A small charge with a weak case can cost less to accept. Accepting tells the bank you won't contest it. Countering opens the evidence form.
- 4
Days 2 to 5: gather evidence for the stated reason
Collect what proves your side of this claim. That can be proof of delivery or access, receipts, customer messages, your refund policy, and product details. Combine several files per evidence type into one PDF and stay under the size limits.
- 5
Well before the deadline: review and submit once
Have a second person read the packet, then submit in Stripe. Stripe can send
charge.dispute.closedwhen the case ends, but ChargeBell doesn't alert on that event. Track the outcome in Stripe or another integration.
Inquiries count too
Some disputes start as an inquiry. That's a pre-dispute stage that usually means the cardholder doesn't recognize the charge. Inquiries show as disputed payments in the Stripe Dashboard. A reply at this stage can prevent a formal dispute and its fees. If the inquiry still escalates, you respond again.
Accept or counter?
No rule fits every case, but four questions help you decide.
- Is the cardholder right? If you didn't deliver, or the charge wasn't authorized, accepting usually costs less than a fight you'll lose.
- Is the amount worth the fee? In the US, countering adds a $15 fee you get back only if you win. On a small charge with thin evidence, that rarely pays.
- Do you have evidence for this reason? A delivery confirmation answers
product_not_received. It does nothing forfraudulent. - Is it a pattern? Several disputes on the same product or customer type point to a problem to fix upstream.
Why a complete response matters
Answer the bank's stated reason with the strongest evidence you have. Check the deadline in Stripe and leave time for a second person to review the packet. A fast response doesn't guarantee a win. A missed deadline means the bank never sees your evidence.
1
Evidence submission per dispute
7 to 21 days
Typical window to submit evidence
$15 + $15
US dispute fee, plus the countered fee if you fight
Before a dispute opens, clear support answers and quick refunds can settle real complaints. Once a dispute is open, use Stripe's dispute process and don't issue a second refund. See how to send Stripe refund alerts to Slack.
Who owns a dispute
| Role | Job during the dispute |
|---|---|
| Dispute owner, often the founder | Claims the thread, decides to accept or counter, submits |
| Support | Pulls customer conversations and refund history |
| Ops or fulfillment | Provides proof of delivery, access logs, or usage |
| Finance | Tracks held funds and fees until the case closes |
Send Stripe dispute alerts to the right person
ChargeBell's dispute created alert is critical. It can mention @channel and skips quiet hours. It shows the amount, the reason when Stripe supplies one, and the respond-by date when available. It doesn't send countdown reminders or an alert when the case closes. Give each alert one owner, confirm the deadline in Stripe, and track the outcome there. Send disputes to a channel such as #disputes or #finance.
ChargeBellAPP
🚨 @channel A $312.00 charge was disputed
Devon at Arcfield · "product not received"
Respond by: Fri Jul 3
Disputes have hard deadlines. Respond in Stripe as soon as you can.
How to respond to a dispute in Stripe
The alert gets you to Stripe in time, and you respond in Stripe. ChargeBell is read-only and can't touch the dispute. These are the Dashboard steps.
- 1
Open the dispute details page
From the alert, open the disputed charge in Stripe and go to its dispute details page.
- 2
Choose Accept dispute or Counter dispute
Accepting tells the card issuer you won't contest the amount. Countering opens a form that asks for the evidence this dispute type needs.
- 3
Explain why the dispute is wrong and set the product type
Tell Stripe why the dispute is incorrect and pick the product type, such as physical, digital, or service, so the right evidence fields appear.
- 4
Add your evidence
Stripe fills in what it has, such as shipping details, refund policy, customer info, and product details. Add proof of delivery, receipts, and messages. Combine files into one PDF per type and stay under 4.5 MB.
- 5
Confirm and submit
Tick the confirmation box and submit. You get one submission with no edits. The status changes to under_review until the bank decides.
To build one routine for every kind of payment problem, read how to build a payment incident workflow in Slack. To decide which events need an alert at all, start with what Stripe events a founder should monitor.
Key takeaways
- ChargeBell sends Stripe dispute alerts to Slack with the respond-by date when Stripe provides it.
- You usually have 7 to 21 days to respond. Miss the deadline and you lose with no review.
- In the US, the $15 dispute fee isn't returned. Countering adds another $15 that comes back only if you win.
- Claim each dispute in Slack within the hour and write the respond-by date in the thread.
- Try to resolve it with the customer first, but don't refund a disputed charge. You get one submission, so review it before you send.
Set up the alert
Frequently asked questions
What is a Stripe dispute, and is it the same as a chargeback?
A dispute, also called a chargeback, happens when a cardholder questions a payment with their card issuer. Stripe uses the word dispute for both. The issuer pulls the funds back while it reviews the case, and you can accept it or counter with evidence.
How long do I have to respond to a Stripe dispute?
Usually 7 to 21 days from when the dispute opens, depending on the card network. The exact deadline is on the dispute as evidence_details.due_by. If you miss it, you lose, the funds don't come back, and nobody reviews your evidence. You also get one submission with no edits.
How much does a Stripe dispute cost?
In the US, Stripe charges a $15 dispute fee when a dispute opens, whatever the amount or outcome, and doesn't return it. Since June 17, 2025, countering adds a $15 fee that comes back if you win. Fees vary by country, and Mexico and Japan don't have the countered fee. Check Stripe's pricing page for current numbers.
Should I accept a Stripe dispute or counter it?
Counter when the cardholder is wrong and you have evidence for their stated reason, such as proof of delivery for product_not_received. Accept when the claim is valid or the amount is too small to justify the countered fee. Decide early so you have time to gather evidence.
Can I refund a charge that's already disputed?
You shouldn't. In a formal dispute, the bank has already credited the cardholder. Stripe recommends accepting or countering instead of refunding, so you don't pay the customer twice. To settle with the customer, ask them to withdraw the dispute in exchange for store credit or a replacement.
Can ChargeBell respond to disputes in Stripe?
No. ChargeBell connects to Stripe with read-only OAuth. It reads dispute events to alert you in Slack. It can't counter a dispute, submit evidence, move money, or change anything in Stripe. You respond in your own Stripe Dashboard.
Will ChargeBell remind me as the deadline gets closer?
No. ChargeBell sends one critical alert when the dispute opens, with the respond-by date, and it skips quiet hours so your team sees it overnight. It doesn't send countdown reminders, so write the deadline in the Slack thread and track it there.


