O Markup opera dentro de uma hierarquia clara: merchant principal e submerchants.
Para que a funcionalidade esteja ativa, o merchant deve ter o modelo de faturamento por markup habilitado nos produtos de Payin e/ou Payout, isso é feita pela WEpayments. Uma vez habilitado, os submerchants herdam essa configuração automaticamente.
Não é necessário configurar fees individuais para os submerchants.
Regra de prioridade
O sistema segue uma regra objetiva de aplicação:
Se houver Markup Inline enviado na criação da transação, ele será utilizado. Se não houver envio de markup inline, o sistema aplicará o Markup Global configurado no merchant.
Essa lógica garante flexibilidade por transação sem perder a segurança de uma regra padrão.
Configuração do Markup Global
O Markup Global pode ser configurado via Dashboard ou via API.
No Dashboard, a configuração está disponível na aba “Markup”, dentro do módulo da conta do merchant. Essa aba é exibida apenas para empresas com a flag de faturamento por markup habilitada.
Durante a configuração, é possível definir:
Tipo de valor (percentual ou fixo)
Valor aplicado
Regras de vigência, quando aplicável
Para que um usuário configure ou visualize o markup global, ele precisa possuir as permissões:
markup::read
markup::write
Sem essas permissões, a funcionalidade não ficará disponível para edição.
Quando o Markup é obrigatório
Para transações criadas por submerchants dentro do modelo de faturamento por markup, é obrigatório que exista:
Um markup inline enviado na criação da cobrança ou pagamento, ou
Um markup global previamente configurado no merchant principal.
Caso nenhum dos dois esteja presente, o fluxo não seguirá corretamente o modelo de monetização esperado.
É importante reforçar que o markup não se aplica à transações criadas pelo próprio merchant principal. Caso um markup inline seja enviado em uma cobrança do merchant, ele será ignorado.
Produtos compatíveis
O Markup está disponível para:
Payin:
Pix
Boleto
Cartão de Crédito
Payout:
Pix
O valor pode ser definido como percentual ou fixo, conforme a estratégia comercial do merchant.
Visão de extrato e liquidação
Após a liquidação da transação:
No extrato do submerchant, o sistema exibe o valor total da operação e uma linha separada com o desconto correspondente ao markup.
No extrato do merchant principal, o valor do markup é creditado automaticamente. Em paralelo, a fee operacional da WE é debitada conforme a tabela contratada.
Esse fluxo garante clareza sobre o ganho bruto (markup) e o custo operacional da plataforma.
Como configurar o Markup?
No seu Painel vá em “Conta” e selecione o “Markup”.
Dentro da página você terá acesso às configurações de Pay-in e Payout. Você pode configurar os valores por porcentagem (%) ou fixos. Após adicionar os valores, clique em salvar e o markup estará pronto para ser utilizado.