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 '
{
"endDate": "2026-06-20"
}
'const options = {
method: 'POST',
headers: {
'X-Client-Id': '<api-key>',
'X-Api-Key': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({endDate: '2026-06-20'})
};
fetch('https://api.malga.io/v1/subacquirer/prepayment', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.malga.io/v1/subacquirer/prepayment"
payload := strings.NewReader("{\n \"endDate\": \"2026-06-20\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Client-Id", "<api-key>")
req.Header.Add("X-Api-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"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",
"endDate": "2026-06-20",
"paymentDate": "2026-05-28",
"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"
}
]
}{
"error": {
"code": 123,
"declinedCode": "<string>",
"key": "<string>",
"businessCode": "<string>",
"message": "<string>",
"details": "<array>"
}
}{
"code": "I-403",
"networkDeniedMessage": "Client is not eligible for prepayment"
}{
"code": "I-403",
"networkDeniedMessage": "Client is not eligible for prepayment"
}{
"code": "I-403",
"networkDeniedMessage": "Client is not eligible for prepayment"
}{
"error": {
"code": 123,
"declinedCode": "<string>",
"key": "<string>",
"businessCode": "<string>",
"message": "<string>",
"details": "<array>"
}
}Simular antecipação
🚧 Beta — esta API está em fase Beta e detalhes do contrato podem evoluir nas próximas versões.
Cria uma simulação de antecipação para o período que termina em endDate. A Malga inclui todos os recebíveis elegíveis com data prevista de recebimento até endDate (inclusive) e calcula o valor líquido a ser recebido pelo cliente, junto com o desconto aplicado.
A simulação fica válida até as 15h (horário de Brasília) do dia em que foi criada (campo expiresAt). Para receber em D+1, o aceite precisa acontecer dentro desse prazo.
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 '
{
"endDate": "2026-06-20"
}
'const options = {
method: 'POST',
headers: {
'X-Client-Id': '<api-key>',
'X-Api-Key': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({endDate: '2026-06-20'})
};
fetch('https://api.malga.io/v1/subacquirer/prepayment', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.malga.io/v1/subacquirer/prepayment"
payload := strings.NewReader("{\n \"endDate\": \"2026-06-20\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Client-Id", "<api-key>")
req.Header.Add("X-Api-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"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",
"endDate": "2026-06-20",
"paymentDate": "2026-05-28",
"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"
}
]
}{
"error": {
"code": 123,
"declinedCode": "<string>",
"key": "<string>",
"businessCode": "<string>",
"message": "<string>",
"details": "<array>"
}
}{
"code": "I-403",
"networkDeniedMessage": "Client is not eligible for prepayment"
}{
"code": "I-403",
"networkDeniedMessage": "Client is not eligible for prepayment"
}{
"code": "I-403",
"networkDeniedMessage": "Client is not eligible for prepayment"
}{
"error": {
"code": 123,
"declinedCode": "<string>",
"key": "<string>",
"businessCode": "<string>",
"message": "<string>",
"details": "<array>"
}
}Body
Data-limite (YYYY-MM-DD) do período a antecipar. A Malga inclui todos os recebíveis elegíveis com data prevista de recebimento até essa data (inclusive).
"2026-06-20"
ID do recebedor para antecipar recebíveis dele. Se omitido, opera sobre a conta principal.
"123"
Response
Simulação criada com sucesso
Identificador da antecipação.
"01964c5a-0001-7000-8000-000000000001"
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.
pending, committed, paid, expired "pending"
Soma do valor original dos recebíveis incluídos em items, em centavos.
20000
Valor líquido a ser recebido pelo cliente após o desconto, em centavos.
19323
Componente do desconto referente ao markup do contrato, em centavos.
387
Componente do desconto referente à taxa base da Malga, em centavos.
290
Taxa efetiva total da antecipação sobre o valor bruto.
0.03385
Taxa mensal base aplicada no cálculo (decimal).
0.015
Markup mensal do contrato aplicado no cálculo (decimal).
0.02
Data e hora limite para confirmar a antecipação (sempre 15h, horário de Brasília, do dia da simulação).
"2026-05-27T18:00:00Z"
Lista dos recebíveis incluídos na antecipação.
Show child attributes
Show child attributes
Data-limite (YYYY-MM-DD) considerada na simulação. Todos os recebíveis com data de recebimento até essa data (inclusive) foram incluídos.
"2026-06-20"
Data prevista de pagamento da antecipação (YYYY-MM-DD). Retornada para simulações pendentes (D+1 se criada antes das 15h) e após o aceite.
"2026-05-28"
Related topics
Antecipação avulsaWebhooks v1.1Pagamentos com Pix na MalgaConfirmar antecipação (aceite)Was this page helpful?