# Afiliados

Dê um código para quem divulga a cidade, defina as comissões e pague os criadores, com histórico de cada venda e pagamento.

Source: https://fivedash.fivex.gg/docs/pt/store/affiliates

O programa de afiliados transforma quem divulga a cidade (streamers, criadores de conteúdo, parceiros) em vendedores. Cada criador ganha um código próprio: quem compra com ele ganha desconto, e o criador ganha comissão sobre a venda. Tudo fica em **Loja → Afiliados**, com as vendas, o que está a pagar e o que já foi pago.

## Antes de começar

* **Plano:** a página **Afiliados** faz parte do plano **Pro** ou superior.
* **Programa ligado:** enquanto o **Programa de afiliados** estiver desligado, nenhum código funciona no checkout.
* **Permissões** (área **Afiliados**):

| Ação                                  | Nível          |
| ------------------------------------- | -------------- |
| Criadores, comissões e pagamentos     | **Ver**        |
| Pagar, dar bônus e cancelar comissões | **Gerenciar**  |
| Regras do programa e criadores        | **Configurar** |

> Os criadores de **Afiliados** são da loja. Eles não têm ligação com o módulo **Discord → Creators**, que cuida de divulgações e níveis no servidor do Discord.

## Como funciona

1. O comprador digita o código do criador no checkout do site (no campo **Cupom ou código de criador**) ou no carrinho do Discord (botão **Código de criador**).
2. Se o programa tiver **Desconto para quem usa o código**, o comprador ganha esse desconto na hora.
3. Quando o pagamento é confirmado, o FiveDash calcula a comissão pelas regras do programa e cria uma comissão **Em espera**.
4. Depois da **Espera antes de pagar**, a comissão passa para **A pagar**.
5. A equipe paga o criador por fora (Pix, por exemplo) e marca como paga em **Pagar**.

A comissão é registrada uma vez por pedido. Ela não é criada quando o programa está desligado, quando o código está pausado ou não existe, ou quando o criador compra com o próprio código (se ele tiver um Discord ligado).

## Ligar o programa e definir as regras

### Abra as regras

Em **Loja → Afiliados**, clique em **Editar regras**. Se o programa estiver desligado, o aviso **Programa desligado** também mostra o botão **Ligar programa**.

### Ligue o programa

Em **Regras de comissão**, ligue **Programa de afiliados**.

### Escolha a comissão base

Em **Comissão base**, escolha 5%, 10%, 15%, 20% ou digite outro valor em **Outro** (de 0 a 50%). Embaixo de cada taxa aparece quanto ela rende numa venda de R$ 100.

### Ajuste o resto (opcional)

Configure **Grupos de produtos**, **Níveis**, **Desconto para quem usa o código**, **Bônus de primeira compra**, **Pagamento mínimo** e **Quando a comissão pode ser paga**.

### Salve

Clique em **Salvar regras**. As regras valem para as próximas vendas; o que já foi ganho não muda.

### Regras do programa

| Campo                        | O que faz                                                                                                                                                                                                               | Padrão                                     |
| ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------ |
| **Programa de afiliados**    | Liga os códigos no checkout. Desligado, nenhum código funciona, mas os criadores e o que já ganharam continuam na página.                                                                                               | Desligado                                  |
| **Comissão base**            | Porcentagem do que o comprador pagou, nos produtos fora dos grupos. De 0 a 50%.                                                                                                                                         | 10%                                        |
| **Grupos de produtos**       | Produtos que pagam outra taxa (mais nos VIPs, menos no dinheiro do jogo). Até 8 grupos, cada um com nome (até 32 caracteres), taxa (0 a 50%), **Categorias** e **Produtos**.                                            | Sem grupos                                 |
| **Níveis**                   | Quem vende mais sobe de nível e ganha pontos a mais em todas as taxas. Até 5 níveis, cada um com nome, **Vendas a partir de** (receita total trazida) e pontos a mais (0 a 20). O primeiro nível sempre começa do zero. | Um nível, **Iniciante**, sem pontos a mais |
| **Desconto do comprador**    | Desconto no pedido para quem usa um código: **Sem desconto**, 5%, 10% ou 15%.                                                                                                                                           | 5%                                         |
| **Bônus de primeira compra** | Valor fixo a mais na comissão quando o comprador nunca tinha comprado na loja.                                                                                                                                          | **Sem bônus**                              |
| **Pagamento mínimo**         | Abaixo desse valor, a equipe é avisada antes de pagar. Não impede o pagamento.                                                                                                                                          | **Sem mínimo**                             |
| **Espera antes de pagar**    | Quantos dias depois da venda a comissão pode ser paga: **Na hora**, 7, 14 ou 30 dias. Protege contra reembolso e contestação.                                                                                           | 7 dias                                     |

### Como a comissão é calculada

* Cada item do pedido rende a taxa do grupo dele, ou a **Comissão base** se não estiver em nenhum grupo.
* Um produto escolhido sozinho num grupo vale mais que a categoria dele.
* Os pontos do nível do criador somam em todas as taxas.
* Se o criador tem **Taxa própria**, ela substitui a base e os grupos (os pontos do nível continuam somando).
* A base de cálculo é o que o comprador pagou: os descontos do pedido são divididos entre os itens.
* O **Bônus de primeira compra** entra por cima, quando vale.

> Exemplo: comissão base de 10%, grupo "VIPs" com 20% e criador no nível com +2 pontos. Numa venda de R$ 100 de VIP, a comissão é de 22%, ou R$ 22.

## Adicionar um criador

### Abra o formulário

Em **Loja → Afiliados**, clique em **Novo criador** (ou **Adicionar o primeiro criador**, se ainda não houver nenhum).

### Ligue o Discord (opcional)

Em **Discord (opcional)**, clique em **Escolher um cliente da loja** e escolha o criador entre os clientes. Ligado a um cliente, dá para pagar a comissão em crédito, e ele não ganha comissão comprando com o próprio código.

### Preencha os dados

Digite **Nome** e **Código**. Abaixo do código aparece o desconto que o comprador vai ganhar.

### Defina a comissão

Em **Comissão**, deixe **Regras da loja** ou escolha **Taxa própria** e digite a porcentagem.

### Salve

Clique em **Adicionar criador**. O criador aparece na aba **Criadores** e o código já funciona no checkout (se o programa estiver ligado).

### Campos do criador

| Campo                                 | O que faz                                                                                                                                                                                   | Padrão             |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ |
| **Discord (opcional)**                | Liga o criador a um cliente da loja. Permite pagar em **Crédito na loja** e bloqueia o uso do próprio código.                                                                               | Vazio              |
| **Nome**                              | Como o criador aparece no painel e para o comprador ("Apoiando" e o nome dele). De 2 a 40 caracteres.                                                                                       | —                  |
| **Código**                            | O que o comprador digita. Fica em maiúsculas, sem acentos nem espaços; aceita letras, números, `_` e `-`. De 3 a 20 caracteres. Não pode repetir o código de outro criador nem de um cupom. | —                  |
| **Chave Pix**                         | Para onde a equipe manda o pagamento: e-mail, telefone, CPF ou chave aleatória. Até 120 caracteres.                                                                                         | Vazio              |
| **Comissão**                          | **Regras da loja** segue o programa. **Taxa própria** vale em tudo, no lugar da taxa base e dos grupos (0 a 50%).                                                                           | **Regras da loja** |
| **Nota da equipe**                    | Anotação interna, só a equipe vê. Até 300 caracteres.                                                                                                                                       | Vazio              |
| **Código ativo** / **Código pausado** | Pausado, o código para de funcionar no checkout. O que ele já ganhou continua na página.                                                                                                    | **Código ativo**   |

> Um criador que já tem comissões não pode ser excluído. Pause o código em vez de excluir, para o histórico ficar.

## Situação das comissões

| Situação      | O que quer dizer                                                                                                       |
| ------------- | ---------------------------------------------------------------------------------------------------------------------- |
| **Em espera** | A venda é recente e ainda está dentro da **Espera antes de pagar**. A linha mostra "Pode ser paga a partir de" a data. |
| **A pagar**   | Já passou da espera. Entra no total de **A pagar agora**.                                                              |
| **Paga**      | Foi incluída num pagamento. Não pode mais mudar.                                                                       |
| **Cancelada** | A equipe cancelou (reembolso, fraude). Não conta na receita nem no que o criador ganhou. Dá para **Restaurar**.        |

## Pagar um criador

### Encontre quem tem a receber

Na aba **Visão geral**, a lista **A pagar agora** mostra quem tem comissões que já passaram da espera, com a chave Pix. Clique em **Pagar** ao lado do criador (ou abra o criador e clique em **Pagar**).

### Faça o pagamento por fora

O FiveDash não transfere dinheiro. Pague o criador pelo seu banco (Pix, por exemplo).

### Escolha como foi pago

Em **Como foi pago**, escolha **Pix**, **Crédito na loja** ou **Outro**. Se escolher **Pix**, a chave do criador aparece para conferir.

### Anote a referência e o comprovante (opcional)

Em **Referência (opcional)**, cole o **ID da transação Pix** ou diga como foi pago. Em **Comprovante (opcional)**, anexe um print ou PDF do banco (PNG, JPG, WebP ou PDF, até 4 MB).

### Confirme

Clique em **Marcar … como pago** (o botão mostra o total, como "Marcar R$ 150,00 como pago"). Todas as comissões **A pagar** desse criador viram **Paga**, e o pagamento aparece na aba **Pagamentos**.

| Forma               | O que acontece                                                                                                                                             |
| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Pix**             | Só registra o pagamento que você fez por fora.                                                                                                             |
| **Crédito na loja** | O valor entra como crédito na loja para o cliente ligado ao criador, sem validade. Precisa que o criador tenha entrado na loja com o Discord ligado a ele. |
| **Outro**           | Registra um pagamento feito de outro jeito; descreva em **Como foi pago**.                                                                                 |

> Se o total estiver abaixo do **Pagamento mínimo**, o painel avisa "abaixo do mínimo", mas dá para pagar mesmo assim.

## Dar um bônus

### Abra o criador

Clique no criador na aba **Criadores** e depois em **Dar bônus**.

### Preencha

Digite o **Valor** e, em **Do que é o bônus**, a razão (por exemplo, meta de 20 vendas ou a live do evento). Os dois são obrigatórios.

### Confirme

Clique em **Dar bônus**. O bônus entra direto em **A pagar**, sem espera.

## Cancelar ou restaurar uma comissão

Abra o criador, encontre a venda no **Histórico** e clique em **Cancelar comissão**. Para desfazer, clique em **Restaurar**. Comissões já pagas não podem ser canceladas.

## O que a página mostra

| Aba             | O que tem                                                                                                                                                                                                                          |
| --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Visão geral** | **Vendas com código** e **Receita gerada** nos últimos 30 dias, **A pagar agora**, **Pago aos criadores** desde o começo, a lista de quem pagar, **Quem mais vende** e **Comissão por semana** nas últimas 8 semanas.              |
| **Criadores**   | Cada criador com **Código**, **Nível**, **Vendas**, **Receita** e **A pagar**. Busca por criador ou código.                                                                                                                        |
| **Comissões**   | Cada comissão com **Quando**, **Criador**, **Venda**, **Valor da venda**, **Comissão** e **Situação**. Filtros **Todas**, **Em espera**, **A pagar**, **Pagas** e **Canceladas**; busca por criador, código, comprador ou #pedido. |
| **Pagamentos**  | Cada pagamento com **Quando**, **Criador**, **Como**, **Referência**, **Comissões** e **Valor**, e o link **Ver comprovante**.                                                                                                     |

Na ficha de cada criador aparecem o nível atual ("Nível 2 de 3"), quanto falta em vendas para o próximo nível, quanto ele ganha por venda já com o nível, e o histórico de comissões e pagamentos.

## Perguntas frequentes

**Cupom e código de criador valem juntos?**
No site, o comprador pode aplicar os dois. No carrinho do Discord, depende da opção **Cupom e código juntos** em **Loja → Canais de venda**: desligada (o padrão), usar um tira o outro.

**O que acontece com a comissão se o pagamento for devolvido?**
A comissão não é cancelada sozinha. Cancele em **Cancelar comissão** antes de pagar o criador. Por isso a **Espera antes de pagar** existe.

**Mudei a taxa. As comissões antigas mudam?**
Não. As regras valem só para as próximas vendas.

**O criador pode usar o próprio código?**
Se ele tiver um Discord ligado, não: o checkout recusa com "Você não pode usar o seu próprio código de criador." Sem Discord ligado, o FiveDash não tem como reconhecer o criador.

## Próximos passos

[Cupons](https://fivedash.fivex.gg/docs/pt/store/coupons)Descontos com código para campanhas da cidade.
[Crédito](https://fivedash.fivex.gg/docs/pt/store/credit)Saldo na carteira e cashback, inclusive para pagar criadores.
[Clientes](https://fivedash.fivex.gg/docs/pt/store/customers)Quem comprou, para ligar o Discord do criador.
[Canais de venda](https://fivedash.fivex.gg/docs/pt/store/sales-channels)Códigos de criador no carrinho do Discord.
