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

# June 30, 2026 - Instruções de boleto em sessões

> Envie instruções de boleto (vencimento, juros, multa) ao criar uma sessão de link de pagamento por meio do campo instructions no paymentMethod do boleto.

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 andre = {
  name: "André Campos",
  title: "Software Engineer",
  url: "https://github.com/ATCamposs",
  image: "https://github.com/ATCamposs.png"
};

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

Novidade na Malga! Agora você pode enviar **instruções de boleto** diretamente na criação de uma sessão de link de pagamento por meio do campo `instructions` no `paymentMethod` do boleto.

Esse campo atende fluxos de ERP e cobrança que precisam repassar instruções como vencimento, juros e multa ao provedor de boleto, com o mesmo comportamento já existente nas cobranças via API.

## Como funciona

O campo `instructions` é **opcional e anulável** e aceita uma string de até **255 caracteres**. Quando omitido ou enviado como `null`, a sessão é criada normalmente. Utilize `\n` para incluir quebras de linha na instrução exibida no boleto.

### Exemplo

<CodeGroup>
  ```bash Request theme={null}
  curl --location 'https://api.malga.io/v1/sessions' \
  --header 'X-Client-Id: <YOUR_CLIENT_ID>' \
  --header 'X-Api-Key: <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
     "amount": 1000,
     "merchantId": "<YOUR_MERCHANT_ID>",
     "paymentMethods": [
        {
           "paymentType": "boleto",
           "expiresDate": "2026-01-01",
           "instructions": "Não receber após o vencimento. Multa de 2% e juros de 1% ao mês."
        }
     ]
  }'
  ```
</CodeGroup>

Na consulta da sessão, o campo `instructions` é retornado no objeto `paymentMethod` do boleto, espelhando o valor informado na criação.

Para mais detalhes, consulte a [referência de criação de sessão](/api-reference/sessions/criar-nova-sessao).

<Tip>
  Features:

  1. Campo `instructions` no `paymentMethod` do boleto na criação de sessões
  2. Campo opcional e anulável, com limite de 255 caracteres
  3. Paridade de comportamento com as cobranças via API
  4. Suporte a quebras de linha com `\n`
</Tip>


## Related topics

- [June 18, 2026 - Platform Fee](/release-notes/2026-06-18-Release-Notes.md)
- [Mais releases](/release-notes/releases.md)
- [Sessões](/documentations/more/sessions.md)
- [Abr 30, 2026 - APIs de payouts e novo campo totalPaidAmount](/release-notes/2026-04-30-Release-Notes.md)