Skip to main content

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.

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 data de recebimento. Você informa uma ou mais datas para as quais quer antecipar o dinheiro, e a Malga agrupa todos os recebíveis previstos para cada data informada numa única simulação, 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.
curl --location 'https://api.malga.io/v1/subacquirer/prepayment/receivables' \
  --header 'X-Client-Id: YOUR_CLIENT_ID' \
  --header 'X-Api-Key: YOUR_API_KEY'
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 ou mais datas e crie uma simulação com o endpoint Simular antecipação. A Malga agrupa todos os recebíveis previstos para cada data informada e devolve o valor líquido que você vai receber.
curl --location 'https://api.malga.io/v1/subacquirer/prepayment' \
  --header 'X-Client-Id: YOUR_CLIENT_ID' \
  --header 'X-Api-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "requestedDates": ["2026-06-15", "2026-06-20"]
  }'
A resposta traz o id da simulação (que você usa no aceite), 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.
curl --location --request POST 'https://api.malga.io/v1/subacquirer/prepayment/{id}/commit' \
  --header 'X-Client-Id: YOUR_CLIENT_ID' \
  --header 'X-Api-Key: YOUR_API_KEY'
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.
A regra que vale em todo recebível e no total da simulação é: 
grossAmount = netAmount + feeAmount + markupAmount

​
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

StatusO que significa
pendingSimulação criada, ainda não aceita.
committedAceite confirmado. A antecipação está em processamento.
paidPagamento da antecipação realizado.
expiredSimulação expirou (passou de 15h sem aceite) ou o aceite foi recusado porque o conjunto de recebíveis mudou desde a simulação. Basta simular novamente.

​
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 as datas que quer 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.