Skip to main content
POST
/
v1
/
subacquirer
/
prepayment
Simular antecipação
curl --request POST \
  --url https://api.malga.io/v1/subacquirer/prepayment \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --header 'X-Client-Id: <api-key>' \
  --data '
{
  "requestedDates": [
    "2026-06-15",
    "2026-06-20"
  ]
}
'
{
  "id": "01964c5a-0001-7000-8000-000000000001",
  "status": "pending",
  "grossAmount": 20000,
  "netAmount": 19323,
  "markupAmount": 387,
  "feeAmount": 290,
  "effectiveRate": 0.03385,
  "monthlyRate": 0.015,
  "markup": 0.02,
  "expiresAt": "2026-05-27T18:00:00Z",
  "items": [
    {
      "receivableUnitExternalId": "ru-ext-ok-1",
      "grossAmount": 12000,
      "netAmount": 11594,
      "markupAmount": 232,
      "feeAmount": 174,
      "daysToAnticipate": 30,
      "settlementDate": "2026-06-15",
      "paymentArrangement": "vcc"
    },
    {
      "receivableUnitExternalId": "ru-ext-ok-2",
      "grossAmount": 8000,
      "netAmount": 7729,
      "markupAmount": 155,
      "feeAmount": 116,
      "daysToAnticipate": 30,
      "settlementDate": "2026-06-15",
      "paymentArrangement": "vcc"
    }
  ]
}

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.

Authorizations

​
X-Client-Id
string
header
required
​
X-Api-Key
string
header
required

Body

application/json
​
requestedDates
string<date>[]
required

Datas de recebimento para as quais deseja antecipar os recebíveis. A Malga agrupa todos os recebíveis previstos para cada data informada.

Minimum array length: 1
Example:
["2026-06-15", "2026-06-20"]
​
sellerId
string | null

ID do recebedor para antecipar recebíveis dele. Se omitido, opera sobre a conta principal.

Example:

"123"

Response

Simulação criada com sucesso

​
id
string<uuid>
required

Identificador da antecipação.

Example:

"01964c5a-0001-7000-8000-000000000001"

​
status
enum<string>
required

Status atual da antecipação:

  • pending: simulação criada, ainda não aceita.
  • committed: aceite confirmado, antecipação em processamento.
  • paid: pagamento da antecipação realizado.
  • expired: simulação expirou (passou de 15h sem aceite) ou aceite recusado porque o conjunto de recebíveis mudou.
Available options:
pending,
committed,
paid,
expired
Example:

"pending"

​
grossAmount
integer<int64>
required

Soma do valor original dos recebíveis, em centavos.

Example:

20000

​
netAmount
integer<int64>
required

Valor líquido a ser recebido pelo cliente após o desconto, em centavos.

Example:

19323

​
markupAmount
integer<int64>
required

Componente do desconto referente ao markup do contrato, em centavos.

Example:

387

​
feeAmount
integer<int64>
required

Componente do desconto referente à taxa base da Malga, em centavos.

Example:

290

​
effectiveRate
number<double>
required

Taxa efetiva total da antecipação sobre o valor bruto.

Example:

0.03385

​
monthlyRate
number<double>
required

Taxa mensal base aplicada no cálculo (decimal).

Example:

0.015

​
markup
number<double>
required

Markup mensal do contrato aplicado no cálculo (decimal).

Example:

0.02

​
expiresAt
string<date-time>
required

Data e hora limite para confirmar a antecipação (sempre 15h, horário de Brasília, do dia da simulação).

Example:

"2026-05-27T18:00:00Z"

​
items
object[]
required

Lista dos recebíveis incluídos na antecipação.