> ## Documentation Index
> Fetch the complete documentation index at: https://malga-develop.mintlify.site/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.

# Cards

> Consultas GraphQL do grupo Cards na Analytics API da Malga, com as queries cards e card no novo índice card e a query allCards depreciada.

As consultas disponíveis do serviço de <code>cards</code> têm o objetivo de prover os dados de cartões e tokens criados na Malga, bem como dos clientes associados, facilitando a análise das informações nestes serviços. Não são expostos dados sensíveis nestas consultas, tais como CVV e documentos dos clientes.

No grupo <b>Cards</b> disponibilizamos as seguintes consultas:

<table>
  <tbody>
    <tr>
      <td><code>allCards</code> <b>(deprecated)</b></td>

      <td>
        Retorna todos os cartões e tokens. <b>Depreciada</b> — será descontinuada em <b>2027</b>. Utilize <code>cards</code>.
      </td>
    </tr>

    <tr>
      <td><code>cards</code></td>

      <td>
        Retorna os cartões a partir do novo índice <code>card</code>, com os tokens e as solicitações de transação aninhados, além de novos campos e filtros.
      </td>
    </tr>

    <tr>
      <td><code>card</code></td>

      <td>
        Retorna um único cartão pelo <code>id</code> a partir do novo índice <code>card</code>.
      </td>
    </tr>
  </tbody>
</table>

***

## allCards

<Warning>
  **Depreciada.** A consulta <code>allCards</code> está depreciada e será **descontinuada em 2027**. Migre para a nova consulta [`cards`](#cards), que consulta o índice <code>card</code> e mantém os mesmos argumentos, além de novos campos e filtros. Enquanto não for descontinuada, a <code>allCards</code> continua funcionando normalmente.
</Warning>

Retorna todos os cartões.

<table>
  <thead>
    <tr>
      <td><strong>QUERY : OBJETO DE RETORNO</strong></td>
      <td><strong>allCards: CardsConnection</strong></td>
    </tr>
  </thead>

  <thead>
    <tr>
      <td><strong>ARGUMENTO : TIPO</strong></td>
      <td><strong>DESCRIÇÃO</strong></td>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>first: <b>Int</b></td>
      <td>Retorna os primeiros *n* elementos da lista. O padrão é 100</td>
    </tr>

    <tr>
      <td>after: <b>String</b></td>
      <td>Retorna os elementos da lista que vêm após o ID global especificado.</td>
    </tr>

    <tr>
      <td>startDate: <b>Datetime</b></td>
      <td>startDate (intervalo de datas, iniciando o range no formato yyyy-MM-dd HH:mm:ss.SSSS)</td>
    </tr>

    <tr>
      <td>endDate: <b>Datetime</b></td>
      <td>endDate (intervalo de datas, finalizando o range no formato yyyy-MM-dd HH:mm:ss.SSSS)</td>
    </tr>

    <tr>
      <td>cardId: <b>String</b></td>
      <td>ID do cartão</td>
    </tr>

    <tr>
      <td>cardStatus: <b>String</b></td>
      <td>Status do cartão</td>
    </tr>

    <tr>
      <td>brand: <b>String</b></td>
      <td>Bandeira do cartão</td>
    </tr>

    <tr>
      <td>customerId: <b>String</b></td>
      <td>ID do cliente vinculado ao cartão</td>
    </tr>

    <tr>
      <td>holderName: <b>String</b></td>
      <td>Nome do portador do cartão</td>
    </tr>
  </tbody>
</table>

***

## cards

Retorna os cartões a partir do novo índice <code>card</code>. Mantém paridade de argumentos com <code>allCards</code> (o filtro de identificador passa a se chamar <code>id</code>). Adiciona novos campos e filtros, incluindo consultas nos objetos aninhados <code>tokens</code> e <code>transactionRequests</code>.

<table>
  <thead>
    <tr>
      <td><strong>QUERY : OBJETO DE RETORNO</strong></td>
      <td><strong>cards: CardV2Connection</strong></td>
    </tr>
  </thead>

  <thead>
    <tr>
      <td><strong>ARGUMENTO : TIPO</strong></td>
      <td><strong>DESCRIÇÃO</strong></td>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>first: <b>Int</b></td>
      <td>Retorna os primeiros *n* elementos da lista. O padrão é 100</td>
    </tr>

    <tr>
      <td>after: <b>String</b></td>
      <td>Retorna os elementos da lista que vêm após o cursor especificado.</td>
    </tr>

    <tr>
      <td>id: <b>\[String]</b></td>
      <td>Filtra por um ou mais IDs de cartão</td>
    </tr>

    <tr>
      <td>cardStatus: <b>\[String]</b></td>
      <td>Status do cartão</td>
    </tr>

    <tr>
      <td>tokenStatus: <b>\[String]</b></td>
      <td>Status do token (consulta no objeto aninhado <code>tokens</code>)</td>
    </tr>

    <tr>
      <td>customerId: <b>String</b></td>
      <td>ID do cliente vinculado ao cartão</td>
    </tr>

    <tr>
      <td>brand: <b>String</b></td>
      <td>Bandeira do cartão</td>
    </tr>

    <tr>
      <td>holderName: <b>String</b></td>
      <td>Nome do portador do cartão</td>
    </tr>

    <tr>
      <td>sellerId: <b>String</b></td>
      <td>ID do recebedor (seller) vinculado ao cartão</td>
    </tr>

    <tr>
      <td>merchantId: <b>String</b></td>
      <td>ID do merchant vinculado ao cartão</td>
    </tr>

    <tr>
      <td>fingerprint: <b>String</b></td>
      <td>Fingerprint do cartão</td>
    </tr>

    <tr>
      <td>tokenFingerprint: <b>String</b></td>
      <td>Fingerprint do token (consulta no objeto aninhado <code>tokens</code>)</td>
    </tr>

    <tr>
      <td>tokenProviderType: <b>\[String]</b></td>
      <td>Tipo de provider do token (consulta no objeto aninhado <code>tokens</code>)</td>
    </tr>

    <tr>
      <td>providerType: <b>\[String]</b></td>
      <td>Tipo de provider (consulta no objeto aninhado <code>transactionRequests</code>)</td>
    </tr>

    <tr>
      <td>expirationMonth: <b>String</b></td>
      <td>Mês de expiração do cartão</td>
    </tr>

    <tr>
      <td>expirationYear: <b>String</b></td>
      <td>Ano de expiração do cartão</td>
    </tr>

    <tr>
      <td>startDate: <b>Date</b></td>
      <td>Início do intervalo de criação (<code>created\_at</code>), no formato yyyy-MM-dd</td>
    </tr>

    <tr>
      <td>endDate: <b>Date</b></td>
      <td>Fim do intervalo de criação (<code>created\_at</code>), no formato yyyy-MM-dd</td>
    </tr>

    <tr>
      <td>updatedStartDate: <b>Date</b></td>
      <td>Início do intervalo de atualização (<code>updated\_at</code>), no formato yyyy-MM-dd</td>
    </tr>

    <tr>
      <td>updatedEndDate: <b>Date</b></td>
      <td>Fim do intervalo de atualização (<code>updated\_at</code>), no formato yyyy-MM-dd</td>
    </tr>
  </tbody>
</table>

Além dos campos de raiz do cartão (por exemplo <code>id</code>, <code>clientId</code>, <code>customerId</code>, <code>status</code>, <code>brand</code>, <code>holderName</code>, <code>createdAt</code>, <code>updatedAt</code>, <code>expirationMonth</code>, <code>expirationYear</code>, <code>merchants</code>, <code>sellers</code>, <code>fingerprint</code>), o objeto de retorno traz os objetos aninhados <code>tokens</code> e <code>transactionRequests</code>.

***

## card

Retorna um único cartão pelo <code>id</code> a partir do novo índice <code>card</code>.

<table>
  <thead>
    <tr>
      <td><strong>QUERY : OBJETO DE RETORNO</strong></td>
      <td><strong>card: CardV2Connection</strong></td>
    </tr>
  </thead>

  <thead>
    <tr>
      <td><strong>ARGUMENTO : TIPO</strong></td>
      <td><strong>DESCRIÇÃO</strong></td>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>id: <b>String</b></td>
      <td>ID do cartão a ser consultado</td>
    </tr>
  </tbody>
</table>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.