> ## Documentation Index
> Fetch the complete documentation index at: https://support.wepayments.com.br/llms.txt
> Use this file to discover all available pages before exploring further.
# Markup: O que é e Como Usar
O **Markup** é uma funcionalidade que permite ao merchant principal gerar receita a partir das transações processadas pelos seus sub-merchants. Foi desenvolvido para empresas que operam com franquias, parceiros ou qualquer estrutura hierárquica em que um merchant principal gerencia a operação financeira.
## **Como funciona o Markup**
No modelo de faturamento com markup, a WEpayments cobra taxas operacionais **apenas do merchant principal**. Os sub-merchants não possuem taxas próprias configuradas na plataforma. Em vez disso, a monetização acontece por meio de um markup aplicado a cada cobrança (Payin) ou pagamento (Payout) criado pelos sub-merchants.
### **Explicação simplificada**
| **Etapa** | **O que acontece** |
| :-------- | :----------------------------------------------------------------------------------- |
| 1 | Sub-merchant processa uma transação |
| 2 | O sistema aplica o markup definido |
| 3 | O valor correspondente é creditado automaticamente na carteira do merchant principal |
## **Quem pode usar o Markup?**
O produto Markup está disponível exclusivamente para merchants com o **modelo de faturamento com markup ativado** em seus produtos.
### **Critérios de elegibilidade**
| **Critério** | **Detalhes** |
| :------------------------ | :------------------------------------------------------------------ |
| **Disponibilidade** | Exclusivo para merchants com modelo de markup ativado |
| **Transações aplicáveis** | Apenas transações criadas por **sub-merchants** |
| **Não aplicável** | Cobranças ou pagamentos criados diretamente pelo merchant principal |
### **Ideal para empresas que:**
* Fornecem infraestrutura de pagamento para parceiros
* Desejam escalar seu modelo de monetização de forma eficiente
* Operam com franquias, afiliados ou sub-parceiros
* Precisam de fluxos de receita separados para empresa-mãe e sub-entidades
## **Como o Markup pode ser aplicado**
O produto suporta **duas formas** de aplicar a receita, oferecendo flexibilidade e previsibilidade.
### **1. Markup Global (Padrão)**
Uma regra padrão configurada no nível do merchant principal.
| **Aspecto** | **Descrição** |
| :-------------------- | :---------------------------------------------------------------------------------------------------- |
| **Quando é aplicado** | Sempre que uma transação é criada por um sub-merchant e nenhum valor específico de markup é informado |
| **Comportamento** | O sistema aplica automaticamente o markup global |
| **Caso de uso** | Regra de monetização base – garante que todas as transações gerem receita |
### **2. Markup Inline**
Enviado diretamente no momento da criação da cobrança ou pagamento.
| **Aspecto** | **Descrição** |
| :-------------------- | :----------------------------------------------------------------------------------- |
| **Quando é aplicado** | O merchant define o valor exato do markup para uma transação específica |
| **Formato** | Percentual ou valor fixo |
| **Caso de uso** | Negociações especiais, campanhas, regras específicas por produto, região ou parceiro |
| **Prioridade** | Sempre substitui o markup global para aquela transação |
### **Comparação: Markup Global vs. Inline**
| **Característica** | **Markup Global** | **Markup Inline** |
| :-------------------------------- | :-------------------------------- | :-------------------------------------- |
| **Nível de configuração** | Merchant principal (regra padrão) | Por transação |
| **Flexibilidade** | Base fixa | Altamente flexível |
| **Comportamento de substituição** | Usado quando não há inline | Substitui o markup global |
| **Melhor para** | Transações padrão e recorrentes | Campanhas especiais, acordos negociados |
| **Formato** | Percentual ou fixo | Percentual ou fixo |
| **Recurso** | **Markup Global** | **Markup Inline** |
| :-------------------------------- | :-------------------------------------------- | :-------------------------------------- |
| **Nível de configuração** | Merchant principal (regra padrão) | Por transação |
| **Flexibilidade** | Base fixa | Altamente flexível |
| **Comportamento de substituição** | Usado quando nenhum markup inline é informado | Substitui o markup global |
| **Ideal para** | Transações padrão e recorrentes | Campanhas especiais, acordos negociados |
| **Formato** | Percentual ou fixo | Percentual ou fixo |
## Como configurar?
No seu Portal, acesse a seção "MarkUp" dentro de "Conta". Lá, você escolhe a sua conta e configura o Markup Global.
Você escolherá o MID no qual o MarkUp será utilizado e adicionará os valores referentes aos métodos de pagamento disponíveis. Após isso, é só clicar em salvar e a configuração foi feita.
## **O que acontece financeiramente?**
Após a liquidação da transação do sub-merchant, o sistema realiza automaticamente a alocação financeira:
### **Fluxo financeiro**
| **Etapa** | **Efeito** |
| :--------------------------------- | :----------------------------------- |
| **Valor do markup deduzido** | Do sub-merchant |
| **Valor do markup creditado** | Na carteira do merchant principal |
| **Taxa operacional da WEpayments** | Cobrada apenas do merchant principal |
### **Como aparece nos extratos**
| **Tipo de extrato** | **Como o markup aparece** |
| :-------------------------------- | :----------------------------------------------------- |
| **Extrato do sub-merchant** | Linha separada identificada como **"Markup"** (débito) |
| **Extrato do merchant principal** | Crédito correspondente à receita da transação |
## **Exemplos**
### **Exemplo 1: Payin (recebimento de pagamento)**
#### **Configuração**
* **Merchant principal:** Sua empresa
* **Sub-merchant:** Seu cliente
* **Markup global:** 2%
* **Valor da transação:** R\$ 1.000,00
#### **O que acontece**
| **Evento** | **Valor** | **Quem recebe/paga** |
| :------------------------------------- | :------------ | :------------------------ |
| Cliente paga R\$ 1.000,00 | +R\$ 1.000,00 | Sub-merchant (bruto) |
| Markup (2%) aplicado | -R\$ 20,00 | Deduzido do sub-merchant |
| Markup creditado ao merchant principal | +R\$ 20,00 | Merchant principal |
| Taxa WE cobrada | -Variável | Apenas merchant principal |
#### **Resultado líquido**
| **Parte** | **Valor líquido** |
| :--------------------- | :------------------------------------------- |
| **Sub-merchant** | R\$ 980,00 (após markup) |
| **Merchant principal** | R\$ 20,00 (receita de markup) menos taxas WE |
### **Exemplo 2: Payout (envio de pagamento)**
#### **Configuração**
* **Merchant principal:** Sua empresa
* **Sub-merchant:** Seu cliente
* **Tipo de markup:** Fixo
* **Valor do payout:** R\$ 100,00
* **Valor do markup:** R\$ 1,00 (fixo)
#### **O que acontece financeiramente**
Quando o payout é processado, os seguintes valores são debitados da carteira do sub-merchant:
| **Débito** | **Valor** | **Descrição** |
| :------------------ | :---------- | :-------------------------------------------------- |
| **Valor do payout** | -R\$ 100,00 | Correspondente ao pagamento enviado ao beneficiário |
| **Valor do markup** | -R\$ 1,00 | Correspondente ao markup aplicado à transação |
O valor do markup é então creditado na carteira do merchant principal, e a taxa operacional da WEpayments também é debitada da carteira do merchant principal.
#### **Resumo do impacto nas carteiras**
| **Carteira** | **Descrição** | **Valor** |
| :--------------- | :---------------------------- | :-------------------------------------------------------- |
| **Sub-merchant** | Débito do payout | - R\$ 100,00 |
| **Sub-merchant** | Débito do markup | - R\$ 1,00 |
| **Master** | Crédito do markup | + R\$ 1,00 |
| **Master** | Débito da taxa operacional WE | Valor fixo e/ou percentual definido nos termos comerciais |
#### **Resultado líquido**
| **Parte** | **Valor líquido** | **Cálculo** |
| :--------------- | :----------------------- | :------------------------------------------------- |
| **Sub-merchant** | **- R\$ 101,00** | R\$100,00 (payout) + R\$1,00 (markup) |
| **Master** | **+ R\$ 1,00 - taxa WE** | R\$ 1,00 (crédito do markup) - taxa operacional WE |
> 💡 A taxa operacional da WEpayments é cobrada apenas do merchant principal (Bamboo), nunca do sub-merchant.
## **Casos de uso**
| **Modelo de negócio** | **Como o Markup ajuda** |
| :----------------------------- | :-------------------------------------------------- |
| **Franquias** | O franqueador ganha com as transações do franqueado |
| **Marketplaces** | A plataforma ganha com as transações dos vendedores |
| **Facilitadores de pagamento** | O facilitador ganha com o volume dos sub-merchants |
| **Redes de afiliados** | O dono da rede ganha com as vendas dos afiliados |
| **Soluções white-label** | O provedor ganha com as transações dos parceiros |
## **Notas importantes**
| **Nota** | **Detalhes** |
| :----------------------------------- | :------------------------------------------------------------------------------- |
| **Transações do merchant principal** | Não estão sujeitas a markup (apenas transações de sub-merchants) |
| **Prioridade do markup inline** | Sempre substitui o markup global |
| **Taxas WE** | Cobradas apenas do merchant principal |
| **Taxas do sub-merchant** | Sub-merchants não têm configuração direta de taxas com a WEpayments |
| **Markup em payout** | Aplica-se tanto a transações de Payin quanto de Payout criadas por sub-merchants |
## **Próximos passos**
* **Ativar Markup:** Entre em contato com nossa equipe de suporte ou com seu gerente de conta para ativar o modelo de faturamento com markup
* **Integração via API:** Consulte nossa documentação da API para campos de markup inline ao criar cobranças ou pagamentos
* **Configuração no Dashboard:** Defina seu markup global no Dashboard, nas configurações do merchant
## **Perguntas Frequentes (FAQ)**
**1. Um sub-merchant pode ter sua própria configuração de markup?**\
Não. O markup é configurado no nível do merchant principal. Sub-merchants não podem definir ou substituir regras de markup.
**2. O que acontece se ambos markup global e inline forem fornecidos?**\
O markup inline substitui o markup global para aquela transação específica.
**3. O markup é aplicado antes ou depois das taxas WE?**\
O markup é aplicado ao valor da transação. As taxas WE são cobradas separadamente do merchant principal.
**4. O markup pode ser um valor fixo em vez de uma porcentagem?**\
Sim. Tanto o markup global quanto o inline suportam valores fixos ou percentuais.
**5. O markup se aplica tanto a Payin quanto a Payout?**\
Sim. O markup se aplica a qualquer transação criada por sub-merchants – tanto de entrada (Payin) quanto de saída (Payout).
**6. Como o markup aparece nas respostas da API?**\
As informações de markup estão incluídas nos objetos de transação e nos endpoints de extrato. Consulte nossa documentação da API para campos específicos.
**7. Posso alterar o markup global depois que as transações já estão sendo processadas?**\
Sim, mas as alterações se aplicam apenas a novas transações. Transações já processadas não são afetadas.
**8. O markup é visível para o cliente final?**\
Não. O markup é um acordo comercial entre o merchant principal e o sub-merchant. Os clientes finais veem apenas o valor da transação.