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

# Dec 13, 2023 - Adição de Campos à Charges API e Sessions 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 fabio = {
  name: "Fábio Cereto",
  title: "Product Manager",
  url: "https://github.com/cereto",
  image: "https://github.com/cereto.png"
};

<AuthorProfile author={fabio} />

Foram adicionados à nossa API de charges e sessions novos campos.

***Flag de recorrência***

Agora, para sinalizar que uma transação é recorrente, basta preencher o campo `recurrence` com um dos valores válidos previstos na nossa documentação:

* `initial`: primeira transação recorrente;
* `subsequent`: transação recorrente que não é a primeira;
* `unscheduled`: transação avulsa criada para quitar débitos no contexto de recorrência.

Junto com o lançamento do novo campo, temos a implementação do envio da informação para os provedores Cielo e Pagseguro. Em breve atualizaremos nossos serviços para repassar a flag para mais provedores.

***Chave de referência no provedor***

Agora para gerenciar a chave de referência que será repassada aos provedores adicionamos o campo `providerReferenceKey`. Basta informar esse campo para poder gerenciar essa informação.
Caso não enviado, o comportamento padrão será a geração de um UUID novo a cada `TransactionRequest` gerada para as integrações de adquirentes.

<Info>
  Conte com o apoio do nosso time através do e-mail [suporte@malga.io](mailto:suporte@malga.io) para tirar qualquer dúvida sobre os novos campos.
</Info>

Até mais 🚀


## Related topics

- [Dec 18 - Barte](/release-notes/2024-12-18-Release-Notes.md)
- [Mais releases](/release-notes/releases.md)
- [Queries do grupo Charges na Analytics API](/analytics/queries/charges.md)
- [Sobre as APIs da Malga](/api-reference/about-apis.md)