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

# Set 23, 2026 - Descrição na fatura em cobranças Rede

> Como a Rede monta a descrição exibida na fatura do comprador e o que muda no tratamento do statementDescriptor enviado pela Malga.

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 diego = {
  name: "Diego Saouda",
  title: "Staff Software Engineer",
  url: "https://github.com/diego-malga",
  image: "https://github.com/diego-malga.png"
};

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

O texto que aparece na fatura do comprador em cobranças processadas pela [Rede](/documentations/providers/rede) agora é tratado antes do envio ao provedor. A mudança evita descrições cortadas no lugar errado e ajuda a manter a taxa de aprovação.

## Como a Rede monta a descrição na fatura

A Rede envia para a bandeira uma linha de até **22 caracteres**, composta por duas partes separadas por `*`:

* **Hard descriptor:** o nome do estabelecimento, cadastrado no portal da Rede. O `*` já faz parte dele e conta como 1 caractere.
* **Soft descriptor:** o valor que você envia no campo `statementDescriptor` da cobrança. Aceita até 18 caracteres.

Quando a soma passa de 22, a Rede corta o **hard descriptor** para caber o soft descriptor inteiro, até sobrarem só 3 caracteres do nome do estabelecimento.

Por exemplo, com o hard descriptor `SUALOJA*` (8 caracteres) e o `statementDescriptor` `PLANOPREMIUMANUAL` (17 caracteres):

| Envio                    | Fatura do comprador                                      |
| ------------------------ | -------------------------------------------------------- |
| `PLANOPREMIUMANUAL` (17) | `SUAL*PLANOPREMIUMANUAL` — o nome da loja é cortado      |
| `PLANOPREMIUM` (12)      | `SUALOJA*PLANOPREMIUM` — o nome da loja aparece completo |

## O que muda

* **Asterisco e caracteres especiais removidos:** a Malga remove do `statementDescriptor` o asterisco e os caracteres especiais, e troca letras acentuadas pela versão sem acento. O `*` enviado por você seria lido como um segundo separador e deixaria a fatura inconsistente.
* **Espaços mantidos:** o espaço simples entre palavras é preservado. Espaços repetidos viram um só, e o espaço que sobrar no fim depois do corte é removido.
* **Limite de 18 caracteres:** o `statementDescriptor` é cortado em 18 caracteres, contados já depois da limpeza.
* **Malga Sub:** nas cobranças da sub-adquirência Malga, o hard descriptor é `MALGA*` (6 caracteres). Nesse caso, o `statementDescriptor` é limitado a 16 caracteres e **sem espaços**, para que o nome `MALGA` continue completo na fatura, como exige a regulação.

| Envio                    | Valor enviado para a Rede | Valor enviado no Malga Sub |
| ------------------------ | ------------------------- | -------------------------- |
| `LOJA*PEDIDO`            | `LOJAPEDIDO`              | `LOJAPEDIDO`               |
| `LOJA * DO JOSE`         | `LOJA DO JOSE`            | `LOJADOJOSE`               |
| `Padaria São João Ltda.` | `Padaria Sao Joao L`      | `PadariaSaoJoaoLt`         |

## Site do Vendor

Em cobranças com [Vendor](/documentations/vendors/intro), o campo `website` do Vendor é enviado à Rede só com o domínio (sem `https://`, `www.` e caminho) e limitado a **25 caracteres**. Por exemplo, `https://backoffice.aviva.barte.com/seller/3202` é enviado como `backoffice.aviva.barte.co`.

## O que recomendamos

Calcule o tamanho do `statementDescriptor` a partir do seu hard descriptor: **22 − tamanho do hard descriptor (com o `*`)**. Com `SUALOJA*`, por exemplo, sobram 14 caracteres. Os espaços contam como caracteres, então prefira descrições curtas.

<Tip>
  Principais novidades:

  <ul>
    <li>Asterisco e caracteres especiais removidos do `statementDescriptor` em cobranças Rede, mantendo o espaço simples entre palavras.</li>
    <li>Limite de 16 caracteres, sem espaços, no Malga Sub, para manter o `MALGA*` completo na fatura.</li>
    <li>Site do Vendor enviado à Rede com até 25 caracteres.</li>
    <li>Recomendação de tamanho do `statementDescriptor` a partir do seu hard descriptor.</li>
  </ul>
</Tip>

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


## Related topics

- [Pagamentos com Pix na Malga](/documentations/payment-methods/pix.md)
- [Cartão de crédito](/documentations/payment-methods/credit-card.md)
- [Começando em meios de pagamento](/documentations/payment-methods/intro.md)
- [Mais releases](/release-notes/releases.md)
