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

# Performance

Ao realizar o login em nosso [Dashboard](https://dashboard.malga.io/app/i), a aba de performance será exibida no menu lateral esquerdo. Na visão de uma subconta, a aba mostra diretamente os dados da subconta ativa no seletor de contexto. Na visão Empresa, é necessário selecionar uma subconta para visualizar os dados da aba.

<Info>
  Esta aba exibe informações de performance do fluxo de crédito, sendo necessário ter ao menos uma cobrança processada com método crédito para visualizá-la.
</Info>

<Frame>
  <img alt="Performance" lightAlt="Performance" darkAlt="Performance" src="https://mintcdn.com/malga-develop/3r_KPRAz4zE5SPep/assets/images/dashboard/insights/performance-demo-light.gif?s=9e679cf21217a895079781e1a947228c" className="dark:hidden" width="1838" height="970" data-path="assets/images/dashboard/insights/performance-demo-light.gif" />

  <img alt="Performance" lightAlt="Performance" darkAlt="Performance" src="https://mintcdn.com/malga-develop/3r_KPRAz4zE5SPep/assets/images/dashboard/insights/performance-demo-dark.gif?s=514aaa2d11334da7a851d3ba6549fd18" className="hidden dark:block" width="1835" height="970" data-path="assets/images/dashboard/insights/performance-demo-dark.gif" />
</Frame>

## Filtros disponíveis

Na aba de performance, você confere as informações de cobranças processadas em cada subconta selecionada levando em conta os filtros de:

* **Período** em que uma ou mais cobranças foram criadas
* **Moeda**: em casos de vendas em uma única moeda, ela será automaticamente aplicada no painel, e quando houver cobranças em diferentes moedas, é necessário selecionar a moeda desejada
* **Subconta**: na visão de uma subconta, os dados seguem o seletor de contexto. Na visão Empresa, é necessário selecionar uma subconta (Merchant) para visualizar as cobranças processadas por aquela conta na Malga. Somente subcontas com transações de **crédito** podem ser visualizadas nesta aba.

## Detalhes sobre a Taxa de Aprovação

A taxa de aprovação representa o percentual de <strong>cobranças aprovadas</strong>, em relação ao total de cobranças criadas no período selecionado.

<Note>
  **Cobranças aprovadas**

  São consideradas aprovadas as cobranças que foram <strong>autorizadas</strong> ou <strong>pré-autorizadas</strong> pelo emissor, <strong>mesmo que tenham mudado de status posteriormente</strong>. Entre os status possíveis de uma cobrança aprovada estão:

  * Autorizada
  * Pré-autorizada
  * Cancelada
  * Estornada
  * Chargeback

  Esse conceito permite uma análise mais realista da performance de autorização, mesmo em cenários em que parte das cobranças autorizadas eventualmente não são concluídas com sucesso.
</Note>

<Info>
  **Fórmula de cálculo**

  <strong>Taxa de aprovação</strong> = (Cobranças aprovadas / Total de cobranças) × 100
</Info>

Exibimos uma visão detalhada da taxa de aprovação em diferentes cenários. Veja:

#### Taxa de aprovação

<Frame>
  <img alt="Taxa de aprovação por retentativa" lightAlt="Taxa de aprovação por retentativa" darkAlt="Taxa de aprovação por retentativa" className="mx-auto dark:hidden" src="https://mintcdn.com/malga-develop/ASQm_R3pzPrDMmp4/assets/images/dashboard/appr-rate-light.webp?fit=max&auto=format&n=ASQm_R3pzPrDMmp4&q=85&s=3d5bd94a76779faaced1dce5cba8fc97" width="1338" height="1137" data-path="assets/images/dashboard/appr-rate-light.webp" />

  <img alt="Taxa de aprovação por retentativa" lightAlt="Taxa de aprovação por retentativa" darkAlt="Taxa de aprovação por retentativa" className="mx-auto hidden dark:block" src="https://mintcdn.com/malga-develop/ASQm_R3pzPrDMmp4/assets/images/dashboard/appr-rate-dark.webp?fit=max&auto=format&n=ASQm_R3pzPrDMmp4&q=85&s=910f646ba6c6a947804e4be338e61fb9" width="1338" height="1137" data-path="assets/images/dashboard/appr-rate-dark.webp" />
</Frame>

Nesse primeiro bloco, você consegue visualizar:

* A taxa de aprovação geral da subconta atual
* A taxa de aprovação na primeira tentativa de cobrança
* A taxa de aprovação em relação ao somatório de todas as outras tentativas, excluindo a primeira.

<Tip>
  Passando o mouse sobre os gráficos, uma tooltip é aberta, informando a quantidade de cobranças **autorizadas** e **recusadas**.
</Tip>

#### Taxa de aprovação por provedor e por tentativa

<Frame>
  <img alt="Taxa de aprovação por provedor e por tentativa" lightAlt="Taxa de aprovação por provedor e por tentativa" darkAlt="Taxa de aprovação por provedor e por tentativa" className="mx-auto dark:hidden" src="https://mintcdn.com/malga-develop/ASQm_R3pzPrDMmp4/assets/images/dashboard/insights/approval-rate-by-attempts-light.png?fit=max&auto=format&n=ASQm_R3pzPrDMmp4&q=85&s=404a33bff45753d516e8597532375c94" width="2476" height="1518" data-path="assets/images/dashboard/insights/approval-rate-by-attempts-light.png" />

  <img alt="Taxa de aprovação por provedor e por tentativa" lightAlt="Taxa de aprovação por provedor e por tentativa" darkAlt="Taxa de aprovação por provedor e por tentativa" className="mx-auto hidden dark:block" src="https://mintcdn.com/malga-develop/ASQm_R3pzPrDMmp4/assets/images/dashboard/insights/approval-rate-by-attempts-dark.png?fit=max&auto=format&n=ASQm_R3pzPrDMmp4&q=85&s=eec88843c0e9a1f6bb99414e967405cd" width="2492" height="1518" data-path="assets/images/dashboard/insights/approval-rate-by-attempts-dark.png" />
</Frame>

Neste segundo bloco, apresentamos um gráfico de linha, que permite visualizar as cobranças por provedor (representadas pelas linhas) em cada tentativa, destacando a taxa de aprovação ao longo do tempo. No lado superior direito do gráfico também é possível filtrar para exibir a visão da tentativa desejada.

<Tip>
  Passando o mouse sobre as linhas, uma tooltip é aberta, informando a **quantidade e valor total de cobranças autorizadas** em cada dia e provedor.
</Tip>

### Cobranças recuperadas

<Frame>
  <img alt="Cobranças recuperadas" lightAlt="Cobranças recuperadas" darkAlt="Cobranças recuperadas" className="mx-auto dark:hidden" src="https://mintcdn.com/malga-develop/ASQm_R3pzPrDMmp4/assets/images/dashboard/insights/recovery-light.png?fit=max&auto=format&n=ASQm_R3pzPrDMmp4&q=85&s=c3e743dc20790111175e7ec10d8857a2" width="1338" height="1137" data-path="assets/images/dashboard/insights/recovery-light.png" />

  <img alt="Cobranças recuperadas" lightAlt="Cobranças recuperadas" darkAlt="Cobranças recuperadas" className="mx-auto hidden dark:block" src="https://mintcdn.com/malga-develop/ASQm_R3pzPrDMmp4/assets/images/dashboard/insights/recovery-dark.png?fit=max&auto=format&n=ASQm_R3pzPrDMmp4&q=85&s=ed594f3ce9e8cf032c9ee4dff8206163" width="1338" height="1137" data-path="assets/images/dashboard/insights/recovery-dark.png" />
</Frame>

Representa o valor das cobranças que foram recuperadas após uma primeira tentativa de pagamento não autorizada, seja na segunda, terceira ou quarta tentativa.

#### Visão "Aprovado" x Visão "Recebido"

Você pode alternar entre duas formas de visualizar os dados:

* **Aprovado**: considera todas as cobranças que foram autorizadas ou pré-autorizadas, independentemente de terem sido estornadas, canceladas ou sofrido chargeback depois. É a visão ideal para acompanhar a conversão e a performance do seu fluxo de pagamento.
* **Recebido**: considera apenas as cobranças que de fato resultaram em recebimento de valor (ou seja, que não foram estornadas, canceladas ou que sofreram chargeback). É útil para analisar a entrada real de receita no caixa.

Essas visões fornecem perspectivas complementares: uma foca na conversão (<strong>aprovado</strong>), e a outra no impacto financeiro real (<strong>recebido</strong>).

As seguintes informações podem ser visualizadas nesse bloco:

* Volume financeiro recuperado
* Total de cobranças recuperadas
* Volume financeiro e quantidade de cobranças recuperadas em cada retentativa

<Tip>
  Passando o mouse sobre as barras, uma tooltip é aberta, informando naquela tentativa:

  * Taxa de aprovação
  * Total de cobranças aprovadas (na visão “Aprovado”)
  * Total de cobranças autorizadas (na visão “Recebido”)
  * Total das cobranças que foram retentadas
</Tip>

### Histórico de fluxos inteligentes

<Frame>
  <img alt="Histórico de fluxos inteligentes" lightAlt="Histórico de fluxos inteligentes" darkAlt="Histórico de fluxos inteligentes" src="https://mintcdn.com/malga-develop/ASQm_R3pzPrDMmp4/assets/images/dashboard/insights/performance/flow-history-light.webp?fit=max&auto=format&n=ASQm_R3pzPrDMmp4&q=85&s=ad2142bf04e906ad65ed581076493001" className="dark:hidden" width="2466" height="1518" data-path="assets/images/dashboard/insights/performance/flow-history-light.webp" />

  <img alt="Histórico de fluxos inteligentes" lightAlt="Histórico de fluxos inteligentes" darkAlt="Histórico de fluxos inteligentes" src="https://mintcdn.com/malga-develop/ASQm_R3pzPrDMmp4/assets/images/dashboard/insights/performance/flow-history-dark.webp?fit=max&auto=format&n=ASQm_R3pzPrDMmp4&q=85&s=cef7aba7fb0676166439b926526f97b7" className="hidden dark:block" width="2474" height="1518" data-path="assets/images/dashboard/insights/performance/flow-history-dark.webp" />
</Frame>

Na tabela de **fluxos inteligentes**, é possível identificar o histórico de todos os fluxos criados naquela subconta. Trazendo as seguintes informações de cada fluxo:

* Data de criação
* Nome do fluxo inteligente
* Quantidade de cobranças processadas
* Taxa de aprovação

<Info>
  O fluxo ativo no momento é representado pela badge verde de **ativo** ao lado de seu nome na tabela. Se o merchant selecionado tiver autenticação **3DS2 Malga**, é possível que **mais de um fluxo esteja ativo**.
</Info>


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