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

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