# Sales channels

Sell the store's products on your city's Discord, with a fixed panel or showcases, a cart in a private channel and payment through the store's link.

Source: https://fivedash.fivex.gg/docs/en/store/sales-channels

Sales channels take the store to where players already are. On Discord, the city's bot posts the store in a fixed panel or in showcases across channels, and each buyer builds their order in a private cart. The catalog, prices, coupons and creators are the same as on the website. Everything lives in **Store → Sales channels**.

## Before you start

* **Plan:** the **Sales channels** page is part of the **Pro** plan or above.
* **Discord bot:** the store sells through this server's bot. If it isn't set up, the page shows **Connect the Discord bot first** with the **Set up the bot** button. If Discord rejected the token, it shows **Discord rejected the bot's token** with **Replace the token**.
* **Bot permissions:** it needs to send messages in the panel and showcase channels and create channels in the cart category.
* **Payments:** for buyers to pay, the store must be taking payments. See [Payments](https://fivedash.fivex.gg/docs/en/store/payments).
* **Permissions** (**Sales channels** area):

| Action                  | Level         |
| ----------------------- | ------------- |
| Channels and open carts | **View**      |
| Discord panel and carts | **Configure** |

> The **WhatsApp** card shows as **Coming soon**. For now, the available sales channel is Discord.

## Open the store on Discord

### Open the page

Go to **Store → Sales channels**. In **Store on Discord**, turn on the switch (it goes from **Off** to **On**).

### Pick the format

In **How to sell → Format**, pick **Main panel** (one fixed message in a channel, with every category in a list) or **Showcases** (messages in several channels, each with the products or categories you choose).

### Pick where the purchase happens

In **Where the purchase happens**, pick **On Discord** (a cart in a private channel) or **On the website** (the buttons lead to the product or category on the store's website).

### Pick the channel

With the **Main panel** format, choose the **Panel channel**. With the **Showcases** format, create at least one showcase with **New showcase**.

### Set up the cart

If the purchase happens **On Discord**, choose the **Cart category** and review the **Cart**, **Discounts**, **Buyer** and **Offers** options.

### Save

Click **Save**. The bot posts the panel (or the showcases) and the **Store open on Discord** notice shows where it is. Use **Open in Discord** to see the message.

> Saving posts the panel again with the changes. Switching the format removes the other format's messages when you save.

## How players buy on Discord

1. In the panel, the player picks a category from the list. They get a reply only they can see, with its products.
2. They pick a product and click **Add to cart**. The bot creates a private channel just for them (for example `#cart-player`), inside the **Cart category**.
3. In the cart, they use **Add products**, **Coupon**, **Creator code**, **Gift** or **Cancel cart**, and change the quantity or remove items from the list.
4. On the first cart, if **Buyer details** is on, the bot asks for first name, last name, email and CPF. The details are saved for future purchases.
5. They click **Go to payment** and then the pay button (by default `Pay {total}`). The button opens FiveDash's payment page, with the cart at the store's current prices.
6. On that page, they pick the payment method: Pix shows right there, with a QR code and copy-and-paste code; card is paid on the provider's site. If needed, the page asks for the in-city ID of whoever receives it.
7. Once paid, the cart shows **Payment approved** and the channel closes by itself in a few minutes. Delivery in the city starts right away.

The payment link works while the cart is open. If the cart closes, the buyer builds another one from the panel.

> The bot writes in the city's language. The default texts and button names on this page are the English ones, for cities set to English.

## Settings

### How to sell

| Field                          | What it does                                                                                                                                                                                                                                                             | Default        |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------- |
| **Format**                     | **Main panel** or **Showcases**.                                                                                                                                                                                                                                         | **Main panel** |
| **Where the purchase happens** | **On Discord**: a cart in a private channel, with coupons and offers, and payment through the store's link. **On the website**: the buttons lead to the product or category on the website, and the purchase finishes there. Applies to the panel and to every showcase. | **On Discord** |

> With **On the website**, cart, coupons, creator codes and offers follow the website's rules, and the Discord cart settings are kept for when you sell there again. If the store website is offline, sales keep happening on Discord until it goes live.

### Panel

| Field                       | What it does                                                                                                                                                                | Default            |
| --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ |
| **Panel channel**           | Where the store's fixed message lives. Saving posts the panel again.                                                                                                        | None               |
| **Categories in the panel** | Only the categories picked, in the store's order. Empty, it shows every visible category with active products (up to 25). Categories without active products don't show up. | **All categories** |

### Showcases

Each showcase is a message in a channel, with up to 5 products or categories, one card each. A category shows all its products, including ones added later. The store can have up to 10 showcases.

| Field                       | What it does                                                                                      | Default  |
| --------------------------- | ------------------------------------------------------------------------------------------------- | -------- |
| **Showcase channel**        | Where the showcase stays fixed. It can be the same channel as the panel, but not the log channel. | —        |
| **Products and categories** | Up to 5, in the order picked. Use **Add product or category**.                                    | —        |
| **Title**                   | Optional. With no title or text, the showcase is just the cards.                                  | Empty    |
| **Text**                    | Optional, up to 1000 characters.                                                                  | Empty    |
| **Image**                   | Optional. Wide (2:1), below the title and text. PNG, JPG, WebP or GIF up to 1 MB.                 | No image |

The showcase list shows each one's status: **Posts when you save**, **Not posted**, **Nothing for sale** or how many items are **not for sale** (paused, deleted or in a hidden category).

### Cart

| Field                        | What it does                                                                                                                                              | Default                                                        |
| ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------- |
| **Cart category**            | The Discord category where cart channels are created. Only the member (and the team below) can see theirs. Empty, the channels go at the top of the list. | None                                                           |
| **Channel name**             | Name of the cart channels. `{membro}` becomes the username. Up to 60 characters.                                                                          | `cart-{membro}` (`carrinho-{membro}` for cities in Portuguese) |
| **Closes on its own after**  | With no clicks for this long, the cart closes and the channel is deleted: 15 min, 30 min, 1 hour, 2 hours, 6 hours or 1 day.                              | 30 min                                                         |
| **Maximum per product**      | How many units of the same product fit in a cart: 1, 2, 3, 5, 10 or 20. Stock and the per-player limit also apply.                                        | 5 units                                                        |
| **Team that sees the carts** | Roles that see every cart, to help anyone who gets stuck. Nobody writes in the channels. Up to 10 roles.                                                  | **Nobody but the member**                                      |

A cart holds up to 20 different products.

### Discounts

| Field                        | What it does                                                                                                                            | Default |
| ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- | ------- |
| **Coupons**                  | The **Coupon** button in the cart, with the same rules as the website.                                                                  | On      |
| **Creator codes**            | The **Creator code** button: the sale counts for the creator and the buyer gets the program's discount. Needs the affiliate program on. | On      |
| **Coupon and code together** | Turned off, using one removes the other from the cart, so the discounts don't add up.                                                   | Off     |

### Buyer

| Field             | What it does                                                                                                                                       | Default |
| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | ------- |
| **Gifting**       | The **Gift** button in the cart: the buyer types another player's ID and that player receives it. Without a gift, it goes to the buyer's account.  | On      |
| **Buyer details** | On the first cart, asks for first name, last name, email and CPF. The details are saved on the customer, in **Customers**, and aren't asked again. | On      |

### Offers

| Field                       | What it does                                                                                               | Default |
| --------------------------- | ---------------------------------------------------------------------------------------------------------- | ------- |
| **Suggestions in the cart** | Upgrades, "Buy together" and bundles from the **Offers** page show up in the cart with a one-click button. | On      |
| **Volume discount**         | The "Buy more, pay less" tiers apply in the cart, with a note on how much is left for the next one.        | On      |
| **Suggestions at a time**   | How many offers the cart shows together: 1, 2 or 3. Upgrades come first.                                   | 2       |

Use **Manage offers** to go to **Store → Offers**.

### Log

| Field           | What it does                                                                                                                  | Default    |
| --------------- | ----------------------------------------------------------------------------------------------------------------------------- | ---------- |
| **Log channel** | Posts when someone opens a cart, goes to payment, pays, cancels or lets it close. Must be different from the panel's channel. | **No log** |

## Customize the messages

Click **Messages** (Panel, products, cart and payment) to open **Customize messages**. Each tab is a step of the purchase.

| Step         | Field                                                                                                                   | Default                                                                                                                        |
| ------------ | ----------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| **Panel**    | **Title**                                                                                                               | `{{store}} {servidor} Store`                                                                                                   |
| **Panel**    | **Text**                                                                                                                | "Shop without leaving Discord: pick a category below, build your cart and pay on the site. Delivery in the city is automatic." |
| **Panel**    | **List text** (what the list shows before anything is picked)                                                           | "Pick a category"                                                                                                              |
| **Panel**    | **Website button** (a link below the list to the store's website), with **Website button text** and **Website address** | Off; "Buy on the site"                                                                                                         |
| **Panel**    | **Image** (wide, 2:1, below the text)                                                                                   | No image                                                                                                                       |
| **Panel**    | **Thumbnail** (square, to the right of the text): **Server icon**, **Own image** or **None**                            | **Server icon**                                                                                                                |
| **Products** | **Product list text**                                                                                                   | "Pick a product"                                                                                                               |
| **Products** | **Add button**                                                                                                          | "Add to cart"                                                                                                                  |
| **Products** | **Product photo** (the product's image, large, below the price)                                                         | On                                                                                                                             |
| **Cart**     | **Title**                                                                                                               | `{{cart}} Your cart`                                                                                                           |
| **Cart**     | **Text** (sits at the top of the cart, above the items)                                                                 | `{membro}, this channel is just for you. Build your order with the buttons below and go to payment whenever you're ready.`     |
| **Cart**     | **Empty cart**                                                                                                          | "Your cart is empty. Pick products on the store's panel."                                                                      |
| **Cart**     | **Checkout button**                                                                                                     | "Go to payment"                                                                                                                |
| **Payment**  | **Title**                                                                                                               | `{{card}} Almost there!`                                                                                                       |
| **Payment**  | **Text**                                                                                                                | "Check your order and click pay. Payment happens on the store's site."                                                         |
| **Payment**  | **Pay button** (opens payment on the store's website)                                                                   | `Pay {total}`                                                                                                                  |

The texts start in the city's language. Titles take up to 120 characters and texts up to 1500. Images: PNG, JPG, WebP or GIF up to 1 MB.

### Variables

The variables keep their Portuguese names in every language.

| Variable     | Where it works              | What it becomes                                               |
| ------------ | --------------------------- | ------------------------------------------------------------- |
| `{servidor}` | Panel                       | The FiveM server's name                                       |
| `{loja}`     | Panel                       | The store's name                                              |
| `{membro}`   | Cart, payment, channel name | Mentions the cart's owner (in the channel name, the username) |
| `{itens}`    | Cart                        | How many items are in the cart                                |
| `{total}`    | Cart, payment, pay button   | The total, with discounts                                     |

### Embed

Click **Embed** to open **Customize embed**. It applies to every store message.

| Field             | What it does                                                                                                                                                                             | Default       |
| ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------- |
| **Color**         | The side bar of each message.                                                                                                                                                            | **Bot color** |
| **Server header** | The server's name and icon at the top.                                                                                                                                                   | Off           |
| **Footer**        | Optional text at the bottom, up to 100 characters (for example, "Automatic delivery in the city"), with an icon from the bot's pack on the left. The icon only shows together with text. | Empty         |

The **Discord preview**, alongside, shows each step (**Panel**, **Category**, **Product**, **Cart**, **Payment**) as the player will see it.

## Carts

The **Carts** list shows open and recent carts, with the **Open now**, **At payment**, **In carts** and **Went to payment** numbers (over the last 7 days). Click **Refresh** to read them again.

| Status                | What it means                                                  |
| --------------------- | -------------------------------------------------------------- |
| **Shopping**          | The player is still building the cart.                         |
| **At payment**        | The player went to payment.                                    |
| **Paid**              | The order was paid.                                            |
| **Canceled**          | The player canceled the cart.                                  |
| **Closed on its own** | The cart went unused for the **Closes on its own after** time. |

## Close the store on Discord

Turn off the **Store on Discord** switch and click **Save**. The store's messages are removed from the channels. Open carts stay until they close.

## FAQ

**The bot didn't post the panel. What should I check?**
If you see "The bot can't send messages in this channel", give the bot permission to send messages in the channel. If the channel was deleted, pick another one. If the player sees "The bot isn't allowed to create your cart", give the bot permission to manage channels in the cart category.

**Are Discord prices different from the website?**
No. The catalog and prices always come from the store. The payment page checks the price again before charging.

**Can the team see the carts?**
Yes, if you pick roles in **Team that sees the carts**. They can only read; nobody writes in the channels.

**Sales are paused on Discord. Why?**
When delivery in the city is off (the FiveDash resource missing from the server, outdated or turned off), payment says sales are paused. The cart stays saved while it's open.

## Next steps

[Discord bot](https://fivedash.fivex.gg/docs/en/discord/bot)Connect the bot that sells in your city.
[Discord notices](https://fivedash.fivex.gg/docs/en/store/discord-notices)Private messages to buyers.
[Offers](https://fivedash.fivex.gg/docs/en/store/offers)Upgrades, bundles and "Buy together" in the cart.
[Affiliates](https://fivedash.fivex.gg/docs/en/store/affiliates)Creator codes that work in the cart.
