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

# Glossário

> Glossário de termos GraphQL usados na Analytics API da Malga, incluindo schema, queries, mutations, tipos, campos, argumentos e diretivas.

<img src="https://mintcdn.com/malga/bFW0-6WF_tj4QsJS/assets/images/analytics/glossary.png?fit=max&auto=format&n=bFW0-6WF_tj4QsJS&q=85&s=fa98659d9f7c059dbb0650f8109ab0c0" alt="Analytics API" width="827" height="375" data-path="assets/images/analytics/glossary.png" />

<AccordionGroup>
  <Accordion title="Objeto [type]">
    Cada parte de um esquema em GraphQL é um tipo de objeto, que consiste em uma lista de campos e o valor de cada campo.
  </Accordion>

  <Accordion title="Esquema [schema]">
    O esquema (schema), ou sistema de tipos (types), é a base de qualquer serviço em GraphQL e descreve o escopo de todas as entidades (types) e consultas (queries) disponíveis pela API.

    Com o esquema, é possível realizar a validação de cada requisição enviada, além de permitir a relação de consultas de introspecção, possibilitando o entendimento das entidades descritas no esquema.
  </Accordion>

  <Accordion title="Consulta [queries]">
    A consulta (query) descreve como é feita a leitura dos dados em GraphQL e como a operação irá retornar os dados do servidor, permitindo a consulta de diferentes entidades em cada requisição.

    Na Analytics API da Malga, estão disponíveis as entidades de Charges, Cards, Dashboard, Authorization Rate e Subacquirer.
  </Accordion>

  <Accordion title="Campo [field]">
    Cada campo corresponde a uma unidade de dados que é retornada dentro do objeto.
  </Accordion>

  <Accordion title="Argumento [argument]">
    Os campos de um objeto em GraphQL podem ser descritos como uma função que retorna um valor e que aceitam argumentos pré-definidos, onde cada argumento pode ser qualquer campo que não seja um objeto.

    Na Analytics API Malga, disponibilizamos argumentos como filtros por ID e status de transação, que podem ser aplicados aos conjuntos de dados das entidades.
  </Accordion>

  <Accordion title="Subacquirer — feature">
    A <b>feature</b> identifica o contexto do saldo do subadquirente. Valores possíveis: <code>NUPAY</code>, <code>SUBACQUIRER</code>, <code>GENERAL</code> e <code>SUBACQUIRER\_PREPAYMENT</code>. O padrão é <code>SUBACQUIRER</code>.
  </Accordion>

  <Accordion title="Subacquirer — seller / sellerId">
    O <b>seller</b> é o recebedor cadastrado para split de pagamentos. O argumento <code>sellerId</code> filtra o saldo de um seller específico. Quando omitido, a consulta resolve para o <b>client master</b> (o client cujo <code>reference\_client\_id</code> não está associado a um seller), e não para a soma de todos os sellers.
  </Accordion>

  <Accordion title="Subacquirer — reconciled_order">
    Ordens conciliadas (<code>subacquirer\_reconciled\_order</code>) que compõem o saldo. O sinal é definido pelo <code>order\_type</code>: <code>authorization</code> soma como crédito; <code>void</code> e <code>charge\_back</code> subtraem como débito. A disponibilidade versus o pendente é determinada pela <code>payment\_scheduled\_at</code>.
  </Accordion>

  <Accordion title="Subacquirer — reconciled_adjustment">
    Ajustes conciliados (<code>subacquirer\_reconciled\_adjustment</code>) aplicáveis às features suportadas, somados ao saldo.
  </Accordion>

  <Accordion title="Subacquirer — payment_batch">
    Lotes de pagamento (<code>subacquirer\_payment\_batch</code>) pendentes (status <code>pending</code> ou <code>failed</code>), somando o <code>final\_balance</code> ao saldo.
  </Accordion>

  <Accordion title="Subacquirer — carry-forward">
    Saldo de arraste (<code>subacquirer\_balance</code>): apenas o registro mais recente por <code>(payment\_method, payment\_arrangement)</code> é considerado, evitando duplicar históricos.
  </Accordion>
</AccordionGroup>


## Related topics

- [Glossário 3DS](/documentations/3ds2-malga/glossario-3ds.md)
- [Começando em 3DS2 Malga](/documentations/3ds2-malga/intro.md)