# Affiliates Give a code to whoever promotes the city, set the commissions and pay creators, with a history of every sale and payout. Source: https://fivedash.fivex.gg/docs/en/store/affiliates The affiliate program turns the people who promote the city (streamers, content creators, partners) into sellers. Each creator gets their own code: whoever buys with it gets a discount, and the creator earns a commission on the sale. Everything lives in **Store → Affiliates**, with the sales, what's due and what's already been paid. ## Before you start * **Plan:** the **Affiliates** page is part of the **Pro** plan or above. * **Program on:** while the **Affiliate program** is off, no code works at checkout. * **Permissions** (**Affiliates** area): | Action | Level | | ---------------------------------------- | ------------- | | Creators, commissions and payouts | **View** | | Pay, give bonuses and cancel commissions | **Manage** | | Program rules and creators | **Configure** | > The creators in **Affiliates** belong to the store. They aren't linked to the **Discord → Creators** module, which handles promotions and levels on the Discord server. ## How it works 1. The buyer types the creator's code at the website checkout (in the **Coupon or creator code** field) or in the Discord cart (the **Creator code** button). 2. If the program has a **Discount for code users**, the buyer gets that discount right away. 3. When the payment is confirmed, FiveDash works out the commission by the program's rules and creates an **On hold** commission. 4. After the **Hold before paying**, the commission moves to **Due**. 5. The team pays the creator outside FiveDash (by Pix, for example) and marks it as paid with **Pay**. The commission is recorded once per order. It isn't created when the program is off, when the code is paused or doesn't exist, or when the creator buys with their own code (if they have a Discord linked). ## Turn on the program and set the rules ### Open the rules In **Store → Affiliates**, click **Edit rules**. If the program is off, the **Program off** notice also shows a **Turn on program** button. ### Turn on the program In **Commission rules**, turn on **Affiliate program**. ### Pick the base commission In **Base commission**, pick 5%, 10%, 15%, 20% or type another value in **Other** (0 to 50%). Under each rate you see what it earns on a R$ 100 sale. ### Adjust the rest (optional) Set up **Product groups**, **Levels**, **Discount for code users**, **First-purchase bonus**, **Minimum payout** and **When the commission can be paid**. ### Save Click **Save rules**. The rules apply to future sales; what's already earned doesn't change. ### Program rules | Field | What it does | Default | | ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------- | | **Affiliate program** | Turns codes on at checkout. While it's off, no code works, but creators and what they've earned stay on the page. | Off | | **Base commission** | Percentage of what the buyer paid, on products outside the groups. 0 to 50%. | 10% | | **Product groups** | Products that pay a different rate (more on VIPs, less on in-game money). Up to 8 groups, each with a name (up to 32 characters), a rate (0 to 50%), **Categories** and **Products**. | No groups | | **Levels** | Whoever sells more moves up a level and gets extra points on every rate. Up to 5 levels, each with a name, **Sales from** (total revenue brought in) and extra points (0 to 20). The first level always starts at zero. | One level, **Iniciante**, with no extra points | | **Buyer discount** | Discount on the order for code users: **No discount**, 5%, 10% or 15%. | 5% | | **First-purchase bonus** | A fixed amount added to the commission when the buyer had never bought from the store. | **No bonus** | | **Minimum payout** | Below this amount, the team is warned before paying. It doesn't block the payout. | **No minimum** | | **Hold before paying** | How many days after the sale the commission can be paid: **Right away**, 7, 14 or 30 days. Protects against refunds and chargebacks. | 7 days | ### How the commission is worked out * Each item in the order earns its group's rate, or the **Base commission** if it isn't in any group. * A product picked on its own in a group beats its category. * The creator's level points add to every rate. * If the creator has an **Own rate**, it replaces the base and the groups (level points still add up). * The base is what the buyer paid: the order's discounts are spread over the items. * The **First-purchase bonus** goes on top, when it applies. > Example: 10% base commission, a "VIPs" group at 20% and a creator on the level with +2 points. On a R$ 100 VIP sale, the commission is 22%, or R$ 22. ## Add a creator ### Open the form In **Store → Affiliates**, click **New creator** (or **Add the first creator**, if there are none yet). ### Link their Discord (optional) In **Discord (optional)**, click **Pick a store customer** and choose the creator among the customers. Linked to a customer, the commission can be paid in credit, and they don't earn a commission buying with their own code. ### Fill in the details Type the **Name** and the **Code**. Below the code you see the discount the buyer will get. ### Set the commission In **Commission**, keep **Store rules** or choose **Own rate** and type the percentage. ### Save Click **Add creator**. The creator shows up in the **Creators** tab and the code already works at checkout (if the program is on). ### Creator fields | Field | What it does | Default | | --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------- | | **Discord (optional)** | Links the creator to a store customer. Allows paying in **Store credit** and blocks using their own code. | Empty | | **Name** | How the creator shows up in the panel and to the buyer ("Supporting" and their name). 2 to 40 characters. | — | | **Code** | What the buyer types. It's stored in upper case, without accents or spaces; it accepts letters, numbers, `_` and `-`. 3 to 20 characters. It can't repeat another creator's code or a coupon's. | — | | **Pix key** | Where the team sends the payout: email, phone, CPF or random key. Up to 120 characters. | Empty | | **Commission** | **Store rules** follows the program. **Own rate** applies to everything, replacing the base rate and the groups (0 to 50%). | **Store rules** | | **Team note** | Internal note, only the team sees it. Up to 300 characters. | Empty | | **Code active** / **Code paused** | While paused, the code stops working at checkout. What it already earned stays on the page. | **Code active** | > A creator who already has commissions can't be deleted. Pause the code instead of deleting it, so the history stays. ## Commission statuses | Status | What it means | | ------------ | ------------------------------------------------------------------------------------------------------------------------ | | **On hold** | The sale is recent and still within the **Hold before paying**. The row shows "Can be paid from" the date. | | **Due** | Past the hold. It counts in the **Due now** total. | | **Paid** | Included in a payout. It can't change anymore. | | **Canceled** | The team canceled it (refund, fraud). It doesn't count in revenue or in what the creator earned. You can **Restore** it. | ## Pay a creator ### Find who's due In the **Overview** tab, the **Due now** list shows who has commissions past the hold, with their Pix key. Click **Pay** next to the creator (or open the creator and click **Pay**). ### Make the payment outside FiveDash FiveDash doesn't transfer money. Pay the creator through your bank (by Pix, for example). ### Choose how it was paid In **How it was paid**, choose **Pix**, **Store credit** or **Other**. If you choose **Pix**, the creator's key shows up so you can check it. ### Add the reference and receipt (optional) In **Reference (optional)**, paste the **Pix transaction ID** or say how it was paid. In **Receipt (optional)**, attach a screenshot or bank PDF (PNG, JPG, WebP or PDF, up to 4 MB). ### Confirm Click **Mark … as paid** (the button shows the total, like "Mark R$ 150.00 as paid"). All of this creator's **Due** commissions become **Paid**, and the payout shows up in the **Payouts** tab. | Method | What happens | | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Pix** | Only records the payment you made outside FiveDash. | | **Store credit** | The amount is added as store credit for the customer linked to the creator, with no expiry. The creator must have signed in to the store with the Discord linked to them. | | **Other** | Records a payment made some other way; describe it in **How it was paid**. | > If the total is below the **Minimum payout**, the panel warns "below the minimum", but you can pay anyway. ## Give a bonus ### Open the creator Click the creator in the **Creators** tab, then **Give bonus**. ### Fill it in Type the **Amount** and, in **What the bonus is for**, the reason (for example, a 20-sale goal or the event stream). Both are required. ### Confirm Click **Give bonus**. The bonus goes straight into **Due**, with no hold. ## Cancel or restore a commission Open the creator, find the sale in **History** and click **Cancel commission**. To undo it, click **Restore**. Commissions already paid can't be canceled. ## What the page shows | Tab | What's in it | | --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Overview** | **Sales with a code** and **Revenue brought in** over the last 30 days, **Due now**, **Paid to creators** since the start, the list of who to pay, **Top sellers** and **Commission per week** over the last 8 weeks. | | **Creators** | Each creator with **Code**, **Level**, **Sales**, **Revenue** and **Due**. Search by creator or code. | | **Commissions** | Each commission with **When**, **Creator**, **Sale**, **Sale amount**, **Commission** and **Status**. Filters **All**, **On hold**, **Due**, **Paid** and **Canceled**; search by creator, code, buyer or #order. | | **Payouts** | Each payout with **When**, **Creator**, **Method**, **Reference**, **Commissions** and **Amount**, and the **View receipt** link. | Each creator's sheet shows their current level ("Level 2 of 3"), how much more in sales they need for the next level, what they earn per sale with the level included, and their history of commissions and payouts. ## FAQ **Do a coupon and a creator code work together?** On the website, the buyer can apply both. In the Discord cart, it depends on the **Coupon and code together** option in **Store → Sales channels**: off (the default), using one removes the other. **What happens to the commission if the payment is refunded?** The commission isn't canceled on its own. Cancel it with **Cancel commission** before paying the creator. That's what the **Hold before paying** is for. **I changed the rate. Do old commissions change?** No. The rules only apply to future sales. **Can the creator use their own code?** If they have a Discord linked, no: checkout refuses it with "You can't use your own creator code." Without a linked Discord, FiveDash has no way to recognize the creator. ## Next steps [Coupons](https://fivedash.fivex.gg/docs/en/store/coupons)Discount codes for the city's campaigns. [Credit](https://fivedash.fivex.gg/docs/en/store/credit)Wallet balance and cashback, including for paying creators. [Customers](https://fivedash.fivex.gg/docs/en/store/customers)Who bought, to link a creator's Discord. [Sales channels](https://fivedash.fivex.gg/docs/en/store/sales-channels)Creator codes in the Discord cart.