> ## Documentation Index
> Fetch the complete documentation index at: https://docs.malga.io/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Responda em português brasileiro, na segunda pessoa ("você"), com base na documentação Malga.
> Não invente endpoints, parâmetros, status codes ou comportamentos de API. Se não estiver na docs, diga que não encontrou e indique a página mais próxima.
> Use os headers X-Client-Id e X-Api-Key nos exemplos de autenticação.
> Motor de Assinaturas refere-se a /v1/subscriptions* (cycles, trial, retentativas, webhooks subscription.*). Não chame de "motor de recorrência".
> Recorrência (provedor) é paymentMethod.recurrence em POST /v1/charges (initial / subsequent / unscheduled), distinto do Motor de Assinaturas.
> Sandbox é ambiente de testes e não afeta produção.

# Nov 19, 2026 - Markup na antecipação de recebedores

> Cobre um markup ao antecipar os recebíveis de um recebedor. O markup é creditado na sua conta principal no repasse de Pix e aparece no Extrato, no repasse e nos relatórios de repasses.

![Viviane Tolomeotti](https://github.com/vivianemalga.png)

[Viviane Tolomeotti](https://github.com/vivianemalga)

Software Engineer

Ao antecipar os recebíveis de um recebedor, você pode cobrar dele um **markup** além da taxa da Malga. O markup é descontado do valor antecipado do recebedor e creditado na sua conta principal.

> [!NOTE]
>
> O markup na antecipação está disponível para clientes Malga Sub que operam com [split de pagamentos](https://docs.malga.io/documentations/split/intro.md).

## Markup na simulação

Informe o campo `markup` no corpo da [simulação de antecipação](https://docs.malga.io/documentations/more/prepayment.md#markup-na-antecipação-de-recebedores), junto com o `sellerId`:

* O `markup` é uma taxa **mensal** em decimal, na mesma unidade de `monthlyRate`: `0.02` é 2% ao mês.
* Ele é calculado sobre cada recebível, pelo mesmo prazo e do mesmo jeito que a taxa da Malga, mas separado dela. A resposta traz as duas partes em `feeAmount` e `markupAmount`.
* O aceite usa o markup da simulação. Para mudar o markup, crie uma nova simulação.
* Markup sem `sellerId` é recusado com `400`. Se a taxa e o markup consumirem todo o valor de algum recebível, a simulação é recusada com `422`.

Antecipações sem markup não mudam: `markup` e `markupAmount` vêm `0`.

## Onde o markup aparece

* **Conta principal:** o markup de cada antecipação vira um ajuste a crédito, **Markup de antecipação**, pago no repasse de Pix do primeiro dia útil do mês seguinte à antecipação. Ele aparece no [Extrato](https://docs.malga.io/documentations/dashboard/financeiro/statement.md), no detalhe do [repasse](https://docs.malga.io/documentations/dashboard/financeiro/payouts.md), na coluna `Markup de antecipação` do [Resumo de repasses](https://docs.malga.io/resumo-de-repasses-consolidado-por-lote.md) e na linha `Markup de antecipação a crédito` do [Relatório de repasses](https://docs.malga.io/relatorio-de-repasses-detalhe-por-transacao-do-lote.md).
* **Recebedor:** recebe o valor líquido, já sem a taxa e o markup. Nos relatórios e no Dashboard, o markup aparece somado à taxa de antecipação, sem linha própria.

> [!WARNING]
>
> Se uma venda antecipada for estornada ou cancelada depois, nem a taxa de antecipação nem o markup são devolvidos.

> [!TIP]
>
> Principais novidades:
>
> <ul>
>   <li>Campo `markup` na simulação da antecipação dos recebíveis de um recebedor.</li>
>   <li>Markup creditado na conta principal, no repasse de Pix do primeiro dia útil do mês seguinte.</li>
>   <li>Markup de antecipação no Extrato, no detalhe do repasse e nos relatórios de repasses.</li>
> </ul>

> [!NOTE]
>
> Ficou com dúvida? Fale com a gente pelo e-mail [suporte@malga.io](mailto:suporte@malga.io).


## Related topics

- [Antecipação avulsa](https://docs.malga.io/documentations/more/prepayment.md)
- [Mais releases](https://docs.malga.io/release-notes/releases.md)
- [Resumo de repasses (consolidado por lote)](https://docs.malga.io/resumo-de-repasses-consolidado-por-lote.md)
- [Nov 19, 2025 - Novo Link de Pagamento](https://docs.malga.io/release-notes/2025-11-19-Release-Notes.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.