> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Slack App

> Install the official Slack app to get a Slack message for payments, refunds, disputes, subscription problems, cancellations, and payouts. Connect with OAuth and choose the events.

## What the Slack app does

The Slack app posts a message to a Slack channel when an event happens in your business. You choose the events and the filters. It can also post a daily summary.

## Before you start

* You are an owner or an admin of the Dodo Payments business.
* You can add apps to the Slack workspace, and you can pick the channel for the messages.

## Install, connect, and configure

**1. Install the app**

Open **Apps**, then **Explore**. Open **Slack** (publisher **Dodo Payments**) and select **Install**.

![The Slack app page in the marketplace with the Official badge and the Install button](https://mintcdn.com/dodopayments/clOL2gp3BmPo5w6L/images/app-marketplace/merchant/12-slack-app-page.png?fit=max\&auto=format\&n=clOL2gp3BmPo5w6L\&q=85\&s=c59746ae8fb3c28f42485ec1a2c72d8c)

**2. Connect Slack**

Select **Connect**. The dialog **Connect Slack** opens. Select **Continue to Slack**. Slack opens in a separate window with the permission page of the workspace. Choose the channel for the messages, then select **Allow**. The app asks only for the right to post to the channel that you choose.

![The Slack window that asks which channel Dodo Payments can post to](https://mintcdn.com/dodopayments/clOL2gp3BmPo5w6L/images/app-marketplace/merchant/13-slack-oauth-window.png?fit=max\&auto=format\&n=clOL2gp3BmPo5w6L\&q=85\&s=6cce0197a32d111684854f8263439d02)

After you select **Allow**, the card shows **Connected** and the button **Update connection**. Slack posts the first message "Dodo Payments is connected" in the channel.

**3. Choose the events**

Open the **Configure** tab. Turn on the messages that you want, set the filters, and select **Save**.

![The Configure tab of the Slack app with the event switches, the filters, and the Save bar](https://mintcdn.com/dodopayments/clOL2gp3BmPo5w6L/images/app-marketplace/merchant/14-slack-configure.png?fit=max\&auto=format\&n=clOL2gp3BmPo5w6L\&q=85\&s=66ac85292451dd4e008abeb27321d731)

## Settings

| Setting | What it does | Default |
| - | - | - |
| Successful payments | A message for each successful payment. | On |
| Failed payments | A message for each failed payment. | Off |
| Refunds | A message for refund events. | On |
| Disputes | A message for dispute events. | On |
| New subscriptions | A message for a new subscription. | Off |
| Subscription payment problems | A message when a subscription payment has a problem. | On |
| Cancellations | A message for a cancellation. | On |
| Payouts | A message for payout events. | On |
| Daily summary | One message each day with the totals of the day. | Off |
| Products | Send messages only for the products that you pick. | All products |
| Currencies | Send messages only for the currencies that you pick. | All currencies |
| Minimum amount | Skip events with a smaller amount. | No minimum |

## What is sent and when

Dodo Payments sends a message after the event happens in your business. The message shows the event type, for example **Payment succeeded**, and a color that shows the result. Amounts show in the major unit with the currency code. The daily summary uses the totals of the events that Dodo Payments saw during the day.

Test mode and live mode send messages to the channel of their own connection.

## Test the app

**1. Use test mode**

Switch the dashboard to test mode, install the app, and connect it.

**2. Make a test payment**

Create a test payment, for example with a test checkout.

**3. Check the channel**

A **Payment succeeded** message appears in the channel. If **Successful payments** is off, turn it on first.

## Troubleshooting

| Problem | What to do |
| - | - |
| The card says **Not connected**. | Select **Connect** and finish the Slack sign-in. |
| The card says **Connection needs attention**. | Slack stopped accepting the connection, for example after the app was removed from the workspace. Select **Reconnect**. |
| No message arrives. | Check that the event switch is on, and that the filters do not skip the event. Check that **Action needed** is not shown on the Configure tab. |
| The pop-up does not open. | Allow pop-ups for the dashboard and select **Open window again**. |

## Disconnect and uninstall

To stop the messages, turn off the events on the **Configure** tab, or uninstall the app. When you uninstall, Dodo Payments deletes the Slack connection. See [Manage and uninstall](https://docs.dodopayments.com/features/app-marketplace/manage-and-uninstall.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.