> ## Documentation Index
> Fetch the complete documentation index at: https://malga-develop.mintlify.site/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.

# Mai 29, 2026 - Beneficiário final NuPay e Antecipação avulsa

> Informe os beneficiários finais de uma cobrança NuPay com o novo campo recipients e antecipe seus recebíveis sob demanda com simulação e aceite via API.

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 viviane = {
  name: "Viviane Tolomeotti",
  title: "Software Engineer",
  url: "https://github.com/vivianemalga",
  image: "https://github.com/vivianemalga.png"
};

export const alberto = {
  name: "Alberto Martins",
  title: "Software Engineer",
  url: "https://github.com/albertomalga",
  image: "https://github.com/albertomalga.png"
};

export const marcos = {
  name: "Marcos Trevisan",
  title: "Software Engineer",
  url: "https://github.com/marcostrevisan",
  image: "https://github.com/marcostrevisan.png"
};

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

  <AuthorProfile author={alberto} />

  <AuthorProfile author={viviane} />
</div>

## Beneficiário final em cobranças NuPay

Agora você pode informar o **beneficiário final** de uma cobrança **NuPay** por meio do novo campo `recipients`. O beneficiário final é o destinatário efetivo dos valores de uma transação e seu envio atende às exigências da Circular BACEN 3.978/2020 sobre prevenção à lavagem de dinheiro e financiamento do terrorismo (PLDFT).

### Como utilizar

O campo `recipients` é **opcional** e deve ser enviado dentro de `paymentMethod` na criação da cobrança. Ele aceita um array em que cada item representa um beneficiário final, com os campos `referenceId`, `name`, `document` (`country`, `type` e `number`) e `amount` (em centavos).

Confira os detalhes completos no [guia de pagamento NuPay](/documentations/payment-methods/nupay#beneficiário-final) e na [referência da API de criação de cobrança](/api-reference/charges/realizar-nova-cobranca).

<Tip>
  Principais novidades:

  <ul>
    <li>Novo campo `recipients` no `paymentMethod` das cobranças NuPay.</li>
    <li>Suporte a múltiplos beneficiários finais por transação.</li>
    <li>Identificação do beneficiário final por documento (`country`, `type` e `number`).</li>
  </ul>
</Tip>

## Antecipação avulsa de recebíveis

Estamos lançando em **Beta** a **antecipação avulsa de recebíveis**: agora você pode receber antes da data prevista o dinheiro das suas vendas processadas pelo provedor de pagamento Malga, pagando uma taxa proporcional ao tempo antecipado. É uma antecipação **sob demanda** — você escolhe quando e quais recebíveis quer antecipar.

<Note>
  A funcionalidade está disponível para clientes habilitados, mas a documentação e as APIs podem evoluir nas próximas versões.
</Note>

### Como utilizar

A antecipação é solicitada **por data de recebimento**. Você informa uma ou mais datas e a Malga **agrupa todos os recebíveis previstos para cada data** numa única simulação, calculando o valor líquido que você vai receber.

O fluxo é simples e tem 3 passos:

1. [Consulte os recebíveis disponíveis](/api-reference/prepayment/consultar-recebiveis-disponiveis-para-antecipacao) para ver o valor total e as datas elegíveis.
2. [Simule a antecipação](/api-reference/prepayment/simular-antecipacao) informando as datas que quer antecipar — a resposta traz o valor líquido a receber e a validade da simulação.
3. [Confirme a antecipação](/api-reference/prepayment/confirmar-antecipacao) enviando o aceite.

Para receber **amanhã (D+1)**, simule e confirme até as **15h (horário de Brasília)**. Após esse horário, o pagamento passa para D+2.

Detalhes completos no [guia conceitual de Antecipação avulsa](/documentations/more/prepayment).

<Info>
  A antecipação avulsa está disponível apenas para clientes que **transacionam pelo provedor de pagamento Malga** e tiveram a habilitação aprovada. Para solicitar a habilitação, entre em contato pelo e-mail [suporte@malga.io](mailto:suporte@malga.io).
</Info>

<Tip>
  Principais novidades:

  <ul>
    <li>Consulta dos recebíveis disponíveis para antecipação, com valor total e quantidade.</li>
    <li>Simulação por uma ou mais datas — a Malga agrupa os recebíveis daquela data.</li>
    <li>Aceite com registro de IP e timestamp como comprovante da operação.</li>
    <li>Suporte a antecipação por recebedor para quem usa split de pagamentos.</li>
  </ul>
</Tip>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.