Ago 31, 2026 - Listagem de antecipações e notificação de repasse no recebedor

Duas novidades nesta release: a antecipação avulsa ganhou um endpoint de listagem, e os recebedores passam a controlar se devem ser notificados quando ocorre um repasse.

Antecipação avulsa — listagem de antecipações

Até agora, consultar uma antecipação exigia guardar o id devolvido na simulação. Com o novo endpoint Listar antecipações, você consulta o histórico completo da sua conta em uma única chamada:

curl --location 'https://api.malga.io/v1/subacquirer/prepayment?page=1&limit=10' \
  --header 'X-Client-Id: YOUR_CLIENT_ID' \
  --header 'X-Api-Key: YOUR_API_KEY'

Pontos importantes do contrato:

A listagem é escopada pelo X-Client-Id, ou seja, devolve apenas as antecipações da sua conta.
Os resultados vêm da mais recente para a mais antiga.
A paginação usa page (padrão 1) e limit (padrão 10, máximo 100). Valores acima do máximo são limitados a 100.
Cada item traz exatamente os mesmos campos da consulta por identificador, incluindo a lista de recebíveis em items. Não é preciso consultar cada antecipação individualmente para ver os detalhes.
Simulações com status pending que já passaram do expiresAt são retornadas como expired, seguindo a mesma regra da consulta por identificador.

A resposta segue o envelope de listagem já usado na plataforma, com items e meta:

{
  "items": [
    {
      "id": "01964c5a-0001-7000-8000-000000000001",
      "status": "pending",
      "grossAmount": 20000,
      "netAmount": 19323
    }
  ],
  "meta": {
    "totalItems": 32,
    "itemCount": 10,
    "itemsPerPage": 10,
    "totalPages": 4,
    "currentPage": 1
  }
}

A antecipação avulsa segue em Beta. A funcionalidade está disponível para clientes habilitados, e detalhes da API podem evoluir nas próximas versões. Para habilitar sua conta, fale com o suporte pelo e-mail suporte@malga.io.

Recebedores — campo notifyOnPayout

Os endpoints de criação e de atualização de recebedor aceitam o novo campo booleano opcional notifyOnPayout, na raiz do corpo da requisição. Ele define se o recebedor deve ser notificado quando ocorre um repasse.

{
  "merchantId": "b1612460-0fef-447d-9590-97825cf60cf6",
  "notifyOnPayout": false
}

O comportamento padrão é notificar. Quem não quiser isso precisa desligar a notificação explicitamente:

Na criação: quando o campo é omitido, o recebedor é criado com notifyOnPayout igual a true.
Na atualização: quando o campo é omitido, o valor atual do recebedor é mantido. Uma atualização parcial que não cita a flag não religa a notificação de um recebedor configurado com false.
Nos recebedores existentes: todos passam a responder notifyOnPayout igual a true.

O campo também é devolvido nas respostas de criação, atualização, consulta por identificador e listagem de recebedores.

Features:

Novo endpoint GET /v1/subacquirer/prepayment para listar as antecipações da conta, com paginação por page e limit
Novo campo opcional notifyOnPayout em POST /v1/sellers e PATCH /v1/sellers/{id}
Campo notifyOnPayout incluído nas respostas dos endpoints de recebedor

Ficou com dúvida? Fale com a gente pelo e-mail suporte@malga.io.

​Antecipação avulsa — listagem de antecipações

​Recebedores — campo notifyOnPayout

Antecipação avulsa — listagem de antecipações

Recebedores — campo notifyOnPayout