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

# Visão geral

<Frame>
  <img alt="Visão geral do Painel de dados Malga" lightAlt="Visão geral do Painel de dados Malga" darkAlt="Visão geral do Painel de dados Malga" src="https://mintcdn.com/malga/gkKFDsvWcgLjJtMs/assets/images/dashboard/insights/overview-dashboard-light.webp?fit=max&auto=format&n=gkKFDsvWcgLjJtMs&q=85&s=4d0176e4e389bd345be229fb08db9069" className="dark:hidden" width="4260" height="2208" data-path="assets/images/dashboard/insights/overview-dashboard-light.webp" />

  <img alt="Visão geral do Painel de dados Malga" lightAlt="Visão geral do Painel de dados Malga" darkAlt="Visão geral do Painel de dados Malga" src="https://mintcdn.com/malga/gkKFDsvWcgLjJtMs/assets/images/dashboard/insights/overview-dashboard-dark.webp?fit=max&auto=format&n=gkKFDsvWcgLjJtMs&q=85&s=4ea05e30872a0e39bf9e2d5f85e9929a" className="hidden dark:block" width="4260" height="2208" data-path="assets/images/dashboard/insights/overview-dashboard-dark.webp" />
</Frame>

Na parte superior apresentamos a visão geral das cobranças no período selecionado, com base na data de atualização da cobrança (`updated_at` ) e na moeda (`currency`). Essa seção apresenta as seguintes métricas:

#### Total das cobranças

Exibe o valor financeiro total e a quantidade de cobranças realizadas no período selecionado. Este número representa o total de vendas ou pedidos processados pela loja.

#### Cobranças autorizadas

Mostra o valor financeiro total e a quantidade de cobranças pré-autorizadas e autorizadas dentro do período selecionado.

#### Cobranças recusadas

Indica o valor financeiro total e a quantidade de cobranças que foram recusadas no período, considerando as transações com status de falha (`failed` ).

#### 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
  * Chargedback

  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>

#### Taxa de aprovação por dia

Disponível no gráfico de linha do tempo, apresenta a taxa de aprovação diária no período selecionado. Em cada ponto do gráfico, é possível visualizar:

* A taxa de aprovação do dia;
* A quantidade de cobranças aprovadas, detalhadas por status: autorizada, pré-autorizada, cancelada, estornada e chargedback;
* A quantidade de cobranças recusadas;
* E o total de cobranças processadas naquele dia.

A taxa de aprovação é calculada com base na <strong>data da última atualização da cobrança</strong>. Isso significa que, se uma cobrança aprovada for posteriormente cancelada, estornada ou sofrer chargedback, ela deixa de ser considerada no dia da autorização e passa a ser contabilizada no dia da atualização de status.

#### Cobranças por status

Distribuição percentual do volume de cobranças por status, dentro do período selecionado. Para cada status, é possível consultar a quantidade de cobranças e o valor financeiro correspondente.

***

Na sequencia, é possível conferir os principais métodos e provedores de pagamento responsáveis pelas cobranças da sua loja, conforme descrito abaixo:

<Frame>
  <img alt="Visão métodos de pagamentos e provedores" lightAlt="Visão métodos de pagamentos e provedores" darkAlt="Visão métodos de pagamentos e provedores" src="https://mintcdn.com/malga/zw_w0ef1taXHyV2N/assets/images/dashboard/insights/performance/method-providers--light.png?fit=max&auto=format&n=zw_w0ef1taXHyV2N&q=85&s=170fa91078e1eb3f6de3cae0565321e0" className="dark:hidden" width="3586" height="1518" data-path="assets/images/dashboard/insights/performance/method-providers--light.png" />

  <img alt="Visão métodos de pagamentos e provedores" lightAlt="Visão métodos de pagamentos e provedores" darkAlt="Visão métodos de pagamentos e provedores" src="https://mintcdn.com/malga/zw_w0ef1taXHyV2N/assets/images/dashboard/insights/performance/method-providers-dark.png?fit=max&auto=format&n=zw_w0ef1taXHyV2N&q=85&s=6ded14271d41a751a158a1f97d23b08d" className="hidden dark:block" width="3613" height="1518" data-path="assets/images/dashboard/insights/performance/method-providers-dark.png" />
</Frame>

#### Métodos de pagamento

Exibe as cobranças autorizadas — incluindo os status de <strong>pré-autorizada</strong>, <strong>autorizada</strong>, <strong>cancelada</strong>, <strong>estornada</strong> e <strong>chargedback</strong> — agrupadas por método de pagamento. Os dados são apresentados em ordem decrescente de volume, considerando os 6 (seis) principais métodos de pagamento. Para cada um, são exibidas as seguintes métricas:

* **Volume %** por método de pagamento sobre o total de cobranças autorizadas;
* **Quantidade** de cobranças autorizadas no método;
* **Valor** financeiro do valor monetário autorizado por método;

#### Provedores de pagamento

Apresenta as cobranças autorizadas (<strong>pré-autorizada</strong>, <strong>autorizada</strong>, <strong>cancelada</strong>, <strong>estornada</strong> e <strong>chargedback</strong>) por provedor de pagamento, ordenadas de forma decrescente conforme o volume dos 6 (seis) principais provedores da sua loja. Para cada provedor, são apresentadas:

* **Volume %** por provedor de pagamento sobre o total de cobranças autorizadas;
* **Aprovação** representa a taxa geral percentual de autorização de cobranças naquele provedor, correspondendo à soma das cobranças aprovadas — ou seja, todas as cobranças que, em algum momento, foram autorizadas ou pré-autorizadas — sobre o total de cobranças processadas pelo provedor no período selecionado.
* **Quantidade** de cobranças aprovadas no provedor;
* **Valor** financeiro correspondente ao valor monetário aprovado por provedor;

<Note>
  **Provedores de pagamento**

  No Painel de Dados do **ambiente de produção** (ambiente online) do Dashboard, são exibidas as cobranças dos provedores de pagamento do fluxo, excluindo o provedor sandbox e antifraude.

  No **ambiente de testes** (sandbox), são exibidos os dados de cobranças de provedores e sandbox, excluindo o provedor antifraude.

  [Confira os métodos e provedores de pagamento suportados pela Malga.](/documentations/type-tables/payment-methods-by-providers)
</Note>

***

<Frame>
  <img alt="Visão geral das cobranças" lightAlt="Visão geral das cobranças" darkAlt="Visão geral das cobranças" src="https://mintcdn.com/malga/gkKFDsvWcgLjJtMs/assets/images/dashboard/insights/overview-brand-declined-light.png?s=b36c1bab8611f8023f4a7101b388d4d5" className="dark:hidden" width="2844" height="1488" data-path="assets/images/dashboard/insights/overview-brand-declined-light.png" />

  <img alt="Visão geral das cobranças" lightAlt="Visão geral das cobranças" darkAlt="Visão geral das cobranças" src="https://mintcdn.com/malga/gkKFDsvWcgLjJtMs/assets/images/dashboard/insights/overview-brand-declined-dark.png?s=9ccf9fc150c1118240fe909aab8c9904" className="hidden dark:block" width="2844" height="1488" data-path="assets/images/dashboard/insights/overview-brand-declined-dark.png" />
</Frame>

#### Bandeira de cartão

Apresenta as cobranças autorizadas (com os status de <strong>pré-autorizada</strong>, <strong>autorizada</strong>, <strong>cancelada</strong>, <strong>estornada</strong> e <strong>chargedback</strong>) por bandeira de cartão, ordenadas de forma decrescente pelo volume de cobranças nas 6 (seis) principais bandeiras de cartão.

As métricas representam:

* **Volume %** por bandeira de cartão sobre o total de cobranças aprovadas;
* **Aprovação** representa a taxa geral percentual de autorização de cobranças naquela bandeira, correspondendo à soma das cobranças aprovadas — ou seja, todas as cobranças que, em algum momento, foram autorizadas ou pré-autorizadas — sobre o total de cobranças processadas pelo provedor no período selecionado.
* **Quantidade** de cobranças aprovadas na bandeira;
* **Valor** financeiro, correspondente ao valor monetário aprovado por bandeira;

#### Detalhes de cobranças recusadas

Neste bloco, são apresentados os principais motivos de recusa das cobranças com status recusada (`failed`), correspondendo ao `declinedCode`retornado pelo provedor de pagamento e tratado pela Malga.

A listagem dos motivos é exibida em ordem decrescente, começando por aquele com maior volume de recusas. Para cada motivo, são apresentados:

* **Quantidade** de cobranças recusadas;
* **Valor** financeiro total associado às recusas daquele motivo.

#### Tratamento dos motivos de recusa

Para facilitar a análise dos <strong>motivos de recusa</strong>, tratamos a listagem de `declinedCode`recebidos dos provedores para o Painel, correspondendo às mensagens da tabela abaixo.

[Saiba mais](/documentations/type-tables/declined-code) sobre os <strong>motivos de recusa</strong> em nossa documentação.

| **Motivo de recusa do Painel de Dados**                    | **Provider error (Declined code)**                                        |
| ---------------------------------------------------------- | ------------------------------------------------------------------------- |
| Cartão bloqueado                                           | blocked\_card                                                             |
| Cartão cancelado                                           | canceled\_card                                                            |
| Cartão com a segurança comprometida                        | security\_violation                                                       |
| Cartão com código de segurança inválido                    | invalid\_cvv / invalid\_security\_code                                    |
| Cartão com data inválida                                   | invalid\_data                                                             |
| Cartão com limite insuficiente                             | insufficient\_funds                                                       |
| Número do cartão inválido                                  | invalid\_card\_number / invalid\_number                                   |
| Cartão com restrição                                       | restricted\_card                                                          |
| Cartão com restrições identificadas                        | pick\_up\_card / pickup\_card / pin\_retry\_exceeded / pin\_try\_exceeded |
| Cartão com PIN inválido                                    | invalid\_pin                                                              |
| Cartão expirado                                            | expired\_card                                                             |
| Cartão inválido para o tipo da cobrança realizada          | transaction\_not\_allowed                                                 |
| Cartão reportado como perdido                              | lost\_card / card\_reported\_lost                                         |
| Cartão reportado como roubado                              | stolen\_card / card\_reported\_stolen                                     |
| Cobrança com fraude confirmada                             | fraud\_confirmed                                                          |
| Cobrança com suspeita de fraude                            | fraud\_suspect                                                            |
| Cobrança não permitida pelo cartão                         | not\_permitted                                                            |
| Cobrança recusada por merchant inválido no provedor        | invalid\_merchant                                                         |
| Cobrança recusada por quantidade de parcelas inválida      | invalid\_installment                                                      |
| Credencial inválida                                        | invalid\_credential / invalid\_credentials                                |
| Erro de processamento no provedor                          | not\_found / request\_not\_sent / timeout / generic / try\_again          |
| Erro de processamento no provedor por falha de contrato    | api\_error / processing\_error / bad\_request                             |
| Erro interno na Malga                                      | internal\_error / requestStatus.internal\_error                           |
| Falha de contato com o emissor do cartão                   | issuer\_not\_available                                                    |
| Função do cartão incompatível com a cobrança realizada     | card\_not\_supported / card\_cannot\_make\_this\_charge                   |
| Motivo de recusa não transmitido pelo provedor             | denied\_reason\_not\_available / service\_not\_allowed                    |
| Recebedor de split inválido                                | invalid\_seller                                                           |
| Valor da cobrança não permitido pelo provedor              | invalid\_charge\_amount / invalid\_amount                                 |
| Falha na autenticação 3DS2                                 | failed\_authentication / authentication\_error                            |
| Tentativas de autenticação 3DS2 indisponíveis pelo emissor | authentication\_attempts\_unavailable\_by\_issuer                         |
| Erro de autenticação 3DS2 sem desafio                      | authentication\_error\_without\_challenge                                 |
| Autenticação 3DS2 indisponível                             | authentication\_unavailable                                               |
| Status (pares) da autenticação inválido                    | invalid\_pares                                                            |
| Emissor não consegue realizar a autenticação               | unable\_to\_perform\_authentication                                       |
| Titular do cartão não concluiu a autenticação 3DS2         | cardholder\_not\_complete\_authentication                                 |

### Filtros

<Frame>
  <img alt="Visão geral do Painel de dados Malga" lightAlt="Visão geral do Painel de dados Malga" darkAlt="Visão geral do Painel de dados Malga" src="https://mintcdn.com/malga/51XjfXmHAqLSJHla/assets/images/release/2024-10-07/painel-filtros-light.gif?s=ef3d14dedf014eff9b6340c30cfbdd2a" className="dark:hidden" width="2844" height="1488" data-path="assets/images/release/2024-10-07/painel-filtros-light.gif" />

  <img alt="Visão geral do Painel de dados Malga" lightAlt="Visão geral do Painel de dados Malga" darkAlt="Visão geral do Painel de dados Malga" src="https://mintcdn.com/malga/51XjfXmHAqLSJHla/assets/images/release/2024-10-07/painel-filtros-dark.gif?s=f4f2216604f2a97f39e995cbb6264dc2" className="hidden dark:block" width="2844" height="1488" data-path="assets/images/release/2024-10-07/painel-filtros-dark.gif" />
</Frame>

Através dos filtros de período, moeda, subconta e método de pagamento, é possível filtrar a visualização dos dados do painel, conforme descrito abaixo:

* **Período** em que uma ou mais cobranças foram criadas
* **Método de pagamento** das cobranças processadas
* **Provedor de pagamento** responsável pelo processamento da cobrança
* **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** é possível selecionar uma subconta para visualizar somente as cobranças processadas por aquela conta na Malga, facilitando a visão de operações e filiais.

<Note>
  **Filtro por período**

  O filtro por período corresponde à data de atualização da cobrança na loja (`updated_at`), estando disponíveis cobranças no ambiente online (produção) e no sandbox (ambiente de testes) do Dashboard;

  Estão disponíveis todos os dados desde a primeira cobrança processada pela loja com a Malga, atualizados aproximadamente a cada 30 minutos;

  Também é possível consultar e extrair os dados em arquivo .csv no menu de [Cobranças](https://dashboard.malga.io/app/charges) e da [Analytics API](/analytics/intro).
</Note>
