> ## 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.

# Discord App

> Install the official Discord app to post payment, refund, dispute, subscription, and payout alerts from Dodo Payments to a Discord channel.

## What the Discord app does

The Discord app posts a message to one Discord channel when an event occurs in your Dodo Payments business. You select the events and the filters.

> [!NOTE]
>
> To send events to Discord through your webhook endpoint and your transformation code, use the [Discord webhook connector](https://docs.dodopayments.com/integrations/discord.md).

## Before you start

* You are an owner or an admin of the Dodo Payments business.
* You have a Discord account that can add a webhook to the server and the channel that you want to use.

## Install, connect, and configure

**1. Install the app**

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

**2. Connect Discord**

Select **Connect**. Select **Continue to Discord**. A Discord page opens in a new window. Dodo Payments does not see your Discord password. The app asks only for the permission **webhook.incoming**.

![The Connect Discord dialog with the Cancel and Continue to Discord buttons](https://mintcdn.com/dodopayments/9p5nlYkB8XwTy1ds/images/app-marketplace/merchant/apps/discord-3.png?fit=max\&auto=format\&n=9p5nlYkB8XwTy1ds\&q=85\&s=3c441a587657b560b480e1b7ef6f2d59)

On the Discord page, select the server and the channel for the messages. Then approve the access.

**3. Choose the alerts**

Open the **Configure** tab. Turn on the alerts that you need.

![The Configure tab of the Discord app with the alert switches and the unsaved changes bar](https://mintcdn.com/dodopayments/9p5nlYkB8XwTy1ds/images/app-marketplace/merchant/apps/discord-1.png?fit=max\&auto=format\&n=9p5nlYkB8XwTy1ds\&q=85\&s=3abc48aa974ba91d724d779d42e2906e)

**4. Set the filters and save**

Scroll down. Select the products and currencies, and enter a minimum amount if you need one. Then select **Save**.

![The Products, Currencies, and Minimum amount filters on the Configure tab of the Discord app](https://mintcdn.com/dodopayments/9p5nlYkB8XwTy1ds/images/app-marketplace/merchant/apps/discord-2.png?fit=max\&auto=format\&n=9p5nlYkB8XwTy1ds\&q=85\&s=5ec7ee7d4c1df5deaa92a51e22dc6bd1)

## Settings

| Setting | What it does | Default |
| - | - | - |
| Successful payments | Posts a message for each successful payment. | On |
| Failed payments | Posts a message for each failed payment. | Off |
| Refunds | Posts a message when a refund succeeds or fails. | On |
| Disputes | Posts a message when a dispute opens and when its status changes. | On |
| New subscriptions | Posts a message when a subscription becomes active. | Off |
| Subscription payment problems | Posts a message when a subscription is on hold, past due, or failed. | On |
| Cancellations | Posts a message when a subscription is cancelled or expires. | On |
| Payouts | Posts a message when a payout succeeds or fails. | On |
| Daily summary | Posts the event totals of the previous day (UTC) one time each day. | Off |
| Products | Payment and subscription messages only for these products. | All products |
| Currencies | Payment, subscription, refund, and dispute messages only in these currencies. | All currencies |
| Minimum amount | Payment, subscription, refund, and dispute messages only from this amount. Use a whole number in the main unit of the currency, for example 10 for 10.00 USD. | No minimum |

## What is sent and when

Dodo Payments posts a message after the event occurs. Each message shows the event type, the amount in the major unit, and the currency code. It can also show the customer email (or the customer ID), the product names, the ID of the object, the dispute status, and the dispute reason.

The messages contain no card data, no address, and no customer name. Test mode and live mode use different connections. To use a different channel, connect the app again.

Discord has no duplicate check for a message. In rare cases, a retry can post the same message two times.

## Test the app

**1. Use test mode**

Install and connect the app in test mode. Turn on **Successful payments**.

**2. Make a test payment**

Create a test payment.

**3. Check Discord**

Open the channel that you selected. A payment message appears.

## Troubleshooting

| Problem | What to do |
| - | - |
| The messages stop | A person can delete the channel webhook in Discord. Connect the app again. |
| **Connection needs attention** | Discord stopped accepting the webhook. Select **Reconnect** and select the channel again. |
| The messages go to the wrong channel | Connect the app again and select the correct channel. |
| No message arrives | Check that the alert switch is on and that the filters do not skip the event. |
| A message appears two times | Discord has no duplicate check. This is rare. |

## Disconnect and uninstall

Turn off the alerts on the **Configure** tab to stop the messages. Uninstall the app to delete the Discord connection. See [Manage and uninstall](https://docs.dodopayments.com/features/app-marketplace/manage-and-uninstall.md).

![The Installed tab of the Apps page with Discord in the list and the status Active](https://mintcdn.com/dodopayments/9p5nlYkB8XwTy1ds/images/app-marketplace/merchant/apps/discord-4.png?fit=max\&auto=format\&n=9p5nlYkB8XwTy1ds\&q=85\&s=412fb41a26ec240d5ce78bb5117307e7)


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