curl --request GET \
--url https://api.malga.io/v1/subacquirer/prepayment/{id} \
--header 'X-Api-Key: <api-key>' \
--header 'X-Client-Id: <api-key>'const options = {method: 'GET', headers: {'X-Client-Id': '<api-key>', 'X-Api-Key': '<api-key>'}};
fetch('https://api.malga.io/v1/subacquirer/prepayment/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.malga.io/v1/subacquirer/prepayment/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Client-Id", "<api-key>")
req.Header.Add("X-Api-Key", "<api-key>")
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"
}{
"error": {
"code": 123,
"declinedCode": "<string>",
"key": "<string>",
"businessCode": "<string>",
"message": "<string>",
"details": "<array>"
}
}Recuperar detalhes de uma antecipação
🚧 Beta — esta API está em fase Beta e detalhes do contrato podem evoluir nas próximas versões.
Retorna os detalhes de uma simulação ou antecipação pelo seu identificador.
Se a simulação ainda está com status pending mas o horário atual já passou do expiresAt (15h, horário de Brasília), o status retornado vem como expired automaticamente. Nesse caso, basta criar uma nova simulação.
curl --request GET \
--url https://api.malga.io/v1/subacquirer/prepayment/{id} \
--header 'X-Api-Key: <api-key>' \
--header 'X-Client-Id: <api-key>'const options = {method: 'GET', headers: {'X-Client-Id': '<api-key>', 'X-Api-Key': '<api-key>'}};
fetch('https://api.malga.io/v1/subacquirer/prepayment/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.malga.io/v1/subacquirer/prepayment/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Client-Id", "<api-key>")
req.Header.Add("X-Api-Key", "<api-key>")
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"
}{
"error": {
"code": 123,
"declinedCode": "<string>",
"key": "<string>",
"businessCode": "<string>",
"message": "<string>",
"details": "<array>"
}
}Path Parameters
Identificador da antecipação.
Response
Detalhes da antecipação
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 avulsaRecuperar detalhes de uma sessãoRecuperar detalhes de cartãoRecuperar detalhes de customerWas this page helpful?