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

# Ago 26, 2026 - Melhoria em Cards no Analytics API

> Novas queries cards e card no grupo Cards da Analytics API, consultando o novo índice card com tokens e transaction requests aninhados. A query allCards foi depreciada e será descontinuada em 2027.

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 paulo = {
  name: "Paulo Chaves",
  title: "Data Engineer",
  url: "https://github.com/paulosdchaves",
  image: "https://github.com/paulosdchaves.png"
};

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

Novidade na Analytics API! O grupo **Cards** agora conta com as consultas `cards` e `card`, que utilizam o novo índice `card` com os objetos aninhados `tokens` e `transactionRequests`.

## Cards — novas consultas

No grupo [Cards](/analytics/queries/cards) disponibilizamos duas novas consultas:

* `cards`: retorna os cartões a partir do novo índice `card`. Mantém paridade de argumentos com `allCards` (o filtro de identificador passa a se chamar `id`). Adiciona novos campos e filtros, incluindo consultas nos objetos aninhados `tokens` e `transactionRequests` (por exemplo `tokenStatus`, `tokenFingerprint`, `tokenProviderType`, `providerType`). Também inclui `sellerId`, `merchantId`, `fingerprint`, `expirationMonth`, `expirationYear` e os filtros por atualização `updatedStartDate`/`updatedEndDate`.
* `card`: retorna um único cartão pelo `id`, também a partir do índice `card`.

O objeto de retorno traz os campos de raiz do cartão (como `id`, `clientId`, `customerId`, `status`, `brand`, `holderName`, `createdAt`, `updatedAt`, `merchants`, `sellers`, `fingerprint`) e os objetos aninhados `tokens` e `transactionRequests`.

## Depreciação — allCards

A consulta `allCards` está **depreciada** e será **descontinuada em 2027**. Ela continua funcionando normalmente até lá, mas recomendamos a migração para a nova consulta `cards`. O principal ajuste é o filtro de identificador, que deixa de ser `cardId` e passa a se chamar `id`.

<Warning>
  A query `allCards` será descontinuada em **2027**. Planeje a migração para `cards` (índice `card`), lembrando que o argumento `cardId` foi renomeado para `id`.
</Warning>

<Tip>
  Features:

  1. Nova query `cards` no grupo Cards (índice `card`, com `tokens` e `transactionRequests` aninhados)
  2. Nova query `card` para consulta de um único cartão pelo `id`
  3. Novos filtros: `sellerId`, `merchantId`, `fingerprint`, `tokenFingerprint`, `tokenProviderType`, `providerType`, `expirationMonth`, `expirationYear`, `updatedStartDate`/`updatedEndDate`
  4. Depreciação da query `allCards` (descontinuação em 2027)
</Tip>


## Related topics

- [Mais releases](/release-notes/releases.md)
- [Começando em meios de pagamento](/documentations/payment-methods/intro.md)
- [Ago 10, 2026 - Koin](/release-notes/2026-08-10-Release-Notes.md)
- [Ago 04, 2026 - Apple Pay WorldPay e disputa SafraPay (Beta)](/release-notes/2026-08-04-Release-Notes.md)