Skip to main content
A antecipação avulsa e os endpoints relacionados estão em Beta. A funcionalidade já está disponível para clientes habilitados, mas detalhes da API e do fluxo podem evoluir nas próximas versões.
A antecipação avulsa permite que você receba antes da data prevista os recebíveis das suas vendas processadas pela Malga, pagando uma taxa proporcional ao tempo antecipado. É “avulsa” porque é solicitada sob demanda — você decide quando e quais recebíveis quer antecipar.

​
Como funciona

A antecipação é solicitada por período. Você informa uma data-limite (endDate) e a Malga inclui na simulação todos os recebíveis elegíveis com data prevista de recebimento até essa data (inclusive), calculando o valor líquido que você vai receber. Após confirmar a simulação, o pagamento é feito via transferência para a conta cadastrada.

​
Pré-requisitos

Antes de começar, sua conta precisa atender a estes dois requisitos:
  1. Transacionar pelo provedor de pagamento Malga. A antecipação avulsa cobre apenas os recebíveis gerados em transações processadas pelo provedor Malga. Transações feitas por outros provedores conectados à plataforma (como Cielo, Rede, Adyen, etc.) não entram na antecipação.
  2. Estar habilitada para antecipar recebíveis com a Malga. Para solicitar a habilitação, entre em contato com o nosso suporte pelo e-mail suporte@malga.io. A solicitação passa por uma análise antes de ser aprovada.
Se a sua conta ainda não está habilitada, qualquer chamada à API de antecipação retornará um erro com status 403 Forbidden.

​
Fluxo de uso

1

Consulte os recebíveis disponíveis

Use o endpoint Consultar recebíveis disponíveis para listar os recebíveis elegíveis para antecipação e ver o valor total disponível.
A resposta traz um summary com o valor total disponível e a quantidade de recebíveis, além da lista de recebíveis com a data prevista de recebimento de cada um.
2

Simule a antecipação

Escolha uma data-limite (endDate) e crie uma simulação com o endpoint Simular antecipação. A Malga inclui todos os recebíveis elegíveis com data prevista de recebimento até essa data (inclusive) e devolve o valor líquido que você vai receber.
A resposta traz o id da simulação (que você usa no aceite), o endDate considerado, o valor bruto, o valor líquido, o desconto, a taxa efetiva e o expiresAt (até quando a simulação pode ser aceita).
3

Confirme a antecipação

Para efetivar a antecipação, faça o aceite chamando o endpoint Confirmar antecipação.
Após o aceite, a antecipação passa para o status committed e segue para pagamento.

​
Como o valor antecipado é calculado

Cada recebível tem um valor bruto e uma data prevista de recebimento. Quanto mais distante essa data, maior o desconto aplicado, porque você está antecipando mais dias. A resposta da simulação devolve:
  • grossAmount: soma do valor original dos recebíveis (em centavos).
  • netAmount: valor líquido que você vai receber (em centavos).
  • feeAmount e markupAmount: componentes do desconto aplicado (em centavos).
  • effectiveRate: taxa efetiva total da antecipação sobre o valor bruto.
  • endDate: data-limite considerada na simulação (YYYY-MM-DD).
A regra que vale em todo recebível e no total da simulação é:

​
Prazos — horário de corte das 15h (horário de Brasília)

A Malga sempre opera em horário de Brasília. O campo expiresAt é retornado em formato ISO 8601, mas representa esse horário.
Para receber a antecipação amanhã (D+1), a simulação precisa ser criada e aceita até as 15h (horário de Brasília) do mesmo dia. Após as 15h, qualquer simulação criada (ou aceite ainda não realizado) é tratada como se tivesse sido feita no dia seguinte, e o pagamento passa para D+2. O campo expiresAt no response indica esse limite — sempre 15h (horário de Brasília) do dia em que a simulação foi criada.

​
Antecipação para recebedores

Se você opera com split de pagamentos, pode antecipar os recebíveis de um recebedor específico. Para isso, informe o sellerId no parâmetro da consulta e no corpo da simulação. Quando o sellerId não é informado, a operação é feita sobre os recebíveis da sua conta principal.

​
Status da antecipação

​
Próximos passos

Consultar recebíveis disponíveis

Liste os recebíveis disponíveis para antecipação e o valor total disponível.

Simular antecipação

Crie uma simulação informando a data-limite (endDate) do período a antecipar.

Recuperar detalhes de uma antecipação

Consulte o status e os detalhes de uma simulação ou antecipação.

Confirmar antecipação

Faça o aceite da simulação para efetivar a antecipação.