> ## 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.

> ## Agent Instructions
> Responda em português brasileiro, na segunda pessoa ("você"), com base na documentação Malga.
> Não invente endpoints, parâmetros, status codes ou comportamentos de API. Se não estiver na docs, diga que não encontrou e indique a página mais próxima.
> Use os headers X-Client-Id e X-Api-Key nos exemplos de autenticação.
> Motor de Assinaturas refere-se a /v1/subscriptions* (cycles, trial, retentativas, webhooks subscription.*). Não chame de "motor de recorrência".
> Recorrência (provedor) é paymentMethod.recurrence em POST /v1/charges (initial / subsequent / unscheduled), distinto do Motor de Assinaturas.
> Sandbox é ambiente de testes e não afeta produção.

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

> Novo endpoint de listagem paginada das antecipações avulsas e novo campo notifyOnPayout na criação e na atualização de recebedores.

export const AuthorProfile = ({author}) => <div className="flex flex-row gap-3 items-center">
    {author.image && <img src={author.image} alt={author.name} className="w-10 h-10 rounded-full m-0" />}
    <div>
      <a href={author.url}>{author.name}</a>
      <br />
      <span>{author.title}</span>
    </div>
  </div>;

export const leozera = {
  name: "Leonardo Pinheiro",
  title: "Tech Lead",
  url: "https://github.com/0xleozera",
  image: "https://github.com/0xleozera.png"
};

<div className="flex flex-row gap-4">
  <AuthorProfile author={leozera} />
</div>

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](/api-reference/prepayment/listar-antecipacoes), você consulta o histórico completo da sua conta em uma única chamada:

```bash theme={null}
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`:

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

<Note>
  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](mailto:suporte@malga.io).
</Note>

## Recebedores — campo notifyOnPayout

Os endpoints de [criação](/api-reference/sellers/criacao-de-um-novo-recebedor) e de [atualização](/api-reference/sellers/atualizacao-de-recebedor-pelo-id) 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.

```json theme={null}
{
  "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.

<Tip>
  Features:

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

<Info>Ficou com dúvida? Fale com a gente pelo e-mail [suporte@malga.io](mailto:suporte@malga.io).</Info>


## Related topics

- [Ago 04, 2026 - Apple Pay WorldPay e disputa SafraPay (Beta)](/release-notes/2026-08-04-Release-Notes.md)
- [Mais releases](/release-notes/releases.md)
- [Abr 30, 2026 - APIs de payouts e novo campo totalPaidAmount](/release-notes/2026-04-30-Release-Notes.md)
- [Ago 10, 2026 - Koin](/release-notes/2026-08-10-Release-Notes.md)