# Discord

## 1) Create An Upgrade.Chat Account <a href="#create-an-account" id="create-an-account"></a>

### GO TO: <https://upgrade.chat/create-account>  <a href="#invite" id="invite"></a>

![](https://3870626768-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LtjPa0xRhBiePPCK7pK%2F-MbCXCSwAa_LPiTvZNxB%2F-MbCXrdbS3lkp4y3vRho%2Fimage.png?alt=media\&token=f2f43e52-81b1-4d8e-8595-287c86b47bfb)

#### Connect Your Discord Account:

![](https://3870626768-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LtjPa0xRhBiePPCK7pK%2F-MbO3Bfn_aIQOVrd5yqE%2F-MbO3NfjfvpT9swI2eTX%2Fimage.png?alt=media\&token=44edb71e-39c0-4516-a60e-9930a809f3f1)

#### (If you already have an account: <https://upgrade.chat/upgrades>)

1. Grant Upgrade.Chat Administrator Permissions
2. [Create a role you want to sell in your Discord server. Click here to learn how.](https://support.discord.com/hc/en-us/articles/206143877-How-do-I-set-up-a-Role-Exclusive-channel-)
3. Move bot role position in Discord above roles you want to sell.

![](https://3870626768-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LtjPa0xRhBiePPCK7pK%2F-MK8fifNuZ6qqHgNswoi%2F-MK8l4AMmpYYuZ45TrQ-%2Finviteuc.gif?alt=media\&token=467562f3-ec18-4c38-8d76-ba4721125f06)

![Move Upgrade.Chat Role Up](https://3870626768-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LtjPa0xRhBiePPCK7pK%2F-MK8fifNuZ6qqHgNswoi%2F-MK8jZ7Ln3AgltjGyV3c%2Frole.gif?alt=media\&token=f9cf5e33-5411-4faf-b612-c2e15e8dc8c6)

{% hint style="danger" %}
**THE UPGRADE.CHAT ROLE MUST HAVE PROPER PERMISSIONS AND ABOVE ROLES YOU WANT TO SELL OR IT WILL NOT WORK PROPERLY!!**
{% endhint %}

**If you don't want to set the bot as Admin, these are the minimum permissions required:**

![](https://3870626768-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LtjPa0xRhBiePPCK7pK%2F-MGn0CX7mHVeFI4x6TGT%2F-MGn4NERVYL-Dd5473jy%2Fimage.png?alt=media\&token=5a6e5d10-f8fe-4cca-9dc6-c89961af0655)

{% hint style="warning" %}
**We do NOT guarantee that it will always work with only these permissions because we add new features all the time that may require other perms.**
{% endhint %}

**LOG INTO DISCORD NOW AND PROCEED TO STEP TWO!**

## 2) Add your Payment Processor to Upgrade.Chat <a href="#add-payment-processor" id="add-payment-processor"></a>

{% hint style="success" %}
**UPGRADE.CHAT ACCEPTS BUSINESS OR PERSONAL PAYPAL ACCOUNTS!**
{% endhint %}

### [**h**](https://upgrade.chat/payment-settings)[**ttps://upgrade.chat/payment-settings**](https://upgrade.chat/payment-settings) <a href="#payments" id="payments"></a>

* [x] Add PayPal to Upgrade.Chat
* [x] Add Stripe to Upgrade.Chat

![](https://3870626768-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LtjPa0xRhBiePPCK7pK%2F-MK8l7ABqCVpoI7gy7bA%2F-MK8mplCmvQSP-ECnOks%2FPayment%20Processor.png?alt=media\&token=1bb4b68d-1294-4762-8a4f-2caaecbd4f2e)

![](https://3870626768-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LtjPa0xRhBiePPCK7pK%2F-MCjjDIAXaCQnxEaWuaJ%2F-MCjqCFPLE4y2GeIDBTw%2Fconnectpaypal.jpg?alt=media\&token=2f9d246f-3613-4d94-b2a0-880a4d28d05d)

![](https://3870626768-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LtjPa0xRhBiePPCK7pK%2F-MCjjDIAXaCQnxEaWuaJ%2F-MCjqFb4AVssImffQ_lc%2Flinkedsetup.jpg?alt=media\&token=a8f4bd2f-4638-4d2f-9029-d0e6e53d596b)

![](https://3870626768-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LtjPa0xRhBiePPCK7pK%2F-M6AkEhAdmSrUvVlXdjS%2F-M6Am5FW7HGjx2zWulwf%2F56345.jpg?alt=media\&token=b8375956-fcef-4b2d-89bf-5e3659291401)

{% hint style="success" %}
**UPGRADE.CHAT ACCEPTS BUSINESS OR PERSONAL PAYPAL ACCOUNTS!**
{% endhint %}

## 3) Set Upgrades for sale in the Control Panel <a href="#setting-upgrades-for-sale" id="setting-upgrades-for-sale"></a>

### <https://upgrade.chat/upgrades>

### ADD THE DISCORD ROLE BONUS TO THE UPGRADE

![Simple Setup](https://3870626768-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LtjPa0xRhBiePPCK7pK%2F-MWnirlo2xpP7043xE2G%2F-MWnjOWat-rO5nKHuQj9%2Fimage.png?alt=media\&token=225cc1d8-83bc-49c2-966c-09d490ed9131)

{% hint style="success" %}
**At the bottom of the page, click bonuses & add the discord roles bonus to the upgrade.&#x20;*****YOU MUST DO THIS TO GRANT THE DISCORD ROLE.***
{% endhint %}

{% hint style="warning" %}
***IF YOU DO NOT ADD THE DISCORD ROLE BONUS, WHEN USERS PURCHASE THEY WILL NOT RECEIVE THE ROLE! BONUSES ARE NOT RETROACTIVE.***
{% endhint %}

{% hint style="danger" %}
**USERS WILL ONLY GET THE ROLES INCLUDED WITH THE UPGRADE AT THE TIME OF PURCHASE. IF YOU ADD THE ROLE AFTER THE USER PURCHASED, THIS ROLE WILL NOT BE INCLUDED. THEY WILL NOT BE ABLE TO CLAIM THE ROLE BECAUSE THEY DID NOT PURCHASE THAT ROLE. BONUSES ARE NOT RETROACTIVE.**
{% endhint %}

![Add Discord Roles to the Upgrade](https://3870626768-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LtjPa0xRhBiePPCK7pK%2F-MWnk9lSPhFYtiXzAZQL%2F-MWnkI_jqY-C0C2MxK-x%2Fimage.png?alt=media\&token=2dcdda8f-e86d-4214-8739-08d74d9c6b33)

{% hint style="success" %}
Access is automatically granted when customers pay and access is revoked when customers stop paying or dispute a transaction. This applies on all platforms.
{% endhint %}

### SIMPLE SETUP FOR UPGRADES <a href="#simple-upgrades" id="simple-upgrades"></a>

| LABEL TITLE               | DESCRIPTION                                                                                                                                                                                                                                                         |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Pay What You Want         | This allows you to set a minimum price for the role but people can enter in their own amount and pay anything they want for the role. Good for Donations and Supporter type roles.                                                                                  |
| Auto Cancel Roles         | This will automatically cancel the role after the first billing cycle. Allows for a paid trial style of membership without having to use a coupon.                                                                                                                  |
| Paymentless Free Trials   | This allows users to be able to get a free trial without entering credit card information. Provides a much quicker and easier experience for users.                                                                                                                 |
| Required Role to Purchase | If you put a role here, it will **LOCK** the upgrade and **ONLY ALLOW THAT ROLE TO PURCHASE!**                                                                                                                                                                      |
| Roles                     | Set which roles you want to give when a user purchases this package.                                                                                                                                                                                                |
| Minimum Price             | The price you want to charge for the role. This is the minimum price wanted.                                                                                                                                                                                        |
| Interval                  | This is how frequently the user will be billed. (Billing Cycle)                                                                                                                                                                                                     |
| Interval Count            | <p>This is how many of the interval (cycles) you want to pass before the user is billed again.  Ie. If you set interval to monthly and count to 3, the user will be billed every 3 months. <br><strong>(Interval x Interval Count = Billing Frequency)</strong></p> |
| Free Trial                | This is how many days you want the user to have access before being billed.                                                                                                                                                                                         |
| Inventory                 | This allows you to limit the number of times this package can be purchased.                                                                                                                                                                                         |

{% hint style="info" %}
Your checkout link is:  \*\*<https://upgrade.chat/{YourServerID}**\\>
[**Not sure how to get your server ID?  Click Here to see how.**](https://support.discord.com/hc/en-us/articles/206346498-Where-can-I-find-my-User-Server-Message-ID-)\
**This can be used anywhere. Websites, social media, emails, etc.**
{% endhint %}

{% hint style="info" %}
[**To set up a locked channel to hide your content behind - CLICK HERE!**](https://support.discord.com/hc/en-us/articles/206143877-How-do-I-set-up-a-Role-Exclusive-channel-)
{% endhint %}

{% hint style="danger" %}
**DO NOT EDIT ANYTHING IN PAYPAL OR STRIPE MANUALLY!** \
**THE BOT TAKES CARE OF ALL INTERACTIONS AND IF YOU EDIT ANY CUSTOMERS, SUBSCRIPTIONS OR DATA...YOU WILL CAUSE ERRORS!**
{% endhint %}

### **ADVANCED** SETUP FOR UPGRADES <a href="#advanced-upgrades" id="advanced-upgrades"></a>

![Advanced Upgrade Setup](https://3870626768-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LtjPa0xRhBiePPCK7pK%2F-MWMstRS9q4T8AJThQOe%2F-MWNP9cZ3WUTqtXSAyj1%2Fadvrole.png?alt=media\&token=38bb595a-7b75-4af3-964a-a848d6021093)

| LABEL                           | DESCRIPTION                                                                                                                                                                     |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Limited Inventory               | This limits the amount of times this upgrade can be purchased by all users.                                                                                                     |
| Auto Cancel After One Cycle     | This will automatically cancel the subscription upgrade after one cycle of whatever length you set. Ex. Monthly role will cancel after one month.                               |
| Require (LOCK) Role To Purchase | **ONLY PUT AN UPGRADE HERE IF YOU WANT TO&#x20;*****LOCK*****&#x20;THE PURCHASE SO&#x20;*****ONLY PEOPLE WITH AN EXISTING ROLE CAN UNLOCK*****&#x20;TO PURCHASE THIS UPGRADE.** |

{% content-ref url="../features/loyalty-tiered-roles" %}
[loyalty-tiered-roles](https://docs.upgrade.chat/features/loyalty-tiered-roles)
{% endcontent-ref %}

## 4) Create Discord Channels to Lock Content <a href="#locking-discord-channels-paywall" id="locking-discord-channels-paywall"></a>

Please see this article from Discord: <https://support.discord.com/hc/en-us/articles/206143877-How-do-I-set-up-a-Role-Exclusive-channel->

This will show you how to setup PayWalls with Upgrade.Chat where you can lock content behind a channel / role.&#x20;

## 5) Upgrade.Chat Settings <a href="#settings" id="settings"></a>

![](https://3870626768-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LtjPa0xRhBiePPCK7pK%2F-MKBCtTUgLsyD4l_UwoP%2F-MKBE3q3NFtHXyRsF_SY%2FSettings.png?alt=media\&token=03459c74-8014-4abf-9d6f-0e49d1548ba4)

{% tabs %}
{% tab title="Welcome Messages" %}
This is the message that is sent upon a user joining your chat room. It contains a payment link to your checkout page as well as your custom message that you set.

{% hint style="info" %}
To turn Welcome Messages OFF, leave the welcome messages blank.
{% endhint %}
{% endtab %}

{% tab title="Welcome Message Delivery Settings" %}
**DISABLED:** A way to turn off welcome messages\
**DIRECT MESSAGE:** Users will get their welcome message in their DMs\
**PUBLIC:** The welcome message will be sent in the chat room's default channel.
{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="Server Referrals" %}
This allows you to set how much your users will get back as account credits when they refer paid members to your server. By default, the credit is a one time credit.
{% endtab %}

{% tab title="Recurring Referrals" %}
This allows credits for referrals to be refunded to the referrer every billing cycle.
{% endtab %}

{% tab title="Referral Percentage" %}
This is the amount that you set to be refunded per successful paid referral.
{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="Cancel Subscriptions on Exit" %}
This settings allows subscriptions to automatically be cancelled when the user leaves your chatroom, even if they didn't specifically downgrade themselves.\
(This helps prevent chargebacks for people who leave or forget they are paying.)
{% endtab %}

{% tab title="Disable Public Downgrades" %}
This setting disables the bot responding in public channels to the $downgrade command but allows people to Direct Message the bot to get the downgrade link.
{% endtab %}

{% tab title="Terms of Service" %}
This is where you can set your own custom terms of service for your server that will show to each user before they pay on your chat's checkout page.&#x20;
{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="Gross Earnings" %}
This is the amount you charge.&#x20;
{% endtab %}

{% tab title="Net Earnings" %}
This is the amount you keep after Payment Processor and Upgrade.Chat fees.
{% endtab %}
{% endtabs %}

{% hint style="info" %}
To check your Stripe Members & Payments: \
[**https://dashboard.stripe.com**](https://dashboard.stripe.com)\
To check your PayPal Members & Payments: \
[**https://upgrade.chat/payment-settings?section=transactions**](https://upgrade.chat/payment-settings?section=transactions)
{% endhint %}

{% hint style="info" %}
Once you add a server, there is no delete function. Please make sure you are adding the correct server to the Dashboard.
{% endhint %}
