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

# Painel de Dados

O **Painel de Dados** do [Dashboard](https://dashboard.malga.io/app/insights) Malga apresenta as informações de vendas e performance dos pagamentos realizados na sua loja, simplificando a gestão e análise das operações.

Através do painel, é possível obter a **visão consolidada das cobranças autorizadas e recusadas** por período, com dados organizados por **status**, divisão por **provedores de pagamento**, **taxa de aprovação** geral e diária, além da listagem dos principais motivos de recusa de transação.

Acesse o **Painel de Dados** [neste link](https://dashboard.malga.io/app/insights).

<img src="https://mintcdn.com/malga-develop/ykhDb0_GUvxS5LEk/assets/images/dashboard/insights/insights-pt-br.png?fit=max&auto=format&n=ykhDb0_GUvxS5LEk&q=85&s=b125e72978f9f8885a90812cea1b654a" alt="Painel de Dados Malga" width="2874" height="1586" data-path="assets/images/dashboard/insights/insights-pt-br.png" />

## Filtros por moeda, subconta e período

Através dos filtros de moeda, subconta (merchant) e período, é possível filtrar a visualização dos dados do Painel, conforme descrito abaixo:

* **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 usando o atalho na barra superior ou no menu lateral;
* **Subconta**: é possível selecionar uma subconta (Merchant) para visualizar somente as cobranças processadas por aquela conta na Malga, facilitando a visão de operações e filiais;

<img src="https://mintcdn.com/malga-develop/ykhDb0_GUvxS5LEk/assets/images/dashboard/insights/insights-header-filter-pt-br.png?fit=max&auto=format&n=ykhDb0_GUvxS5LEk&q=85&s=d984f365d8090c66e40e74345db457c7" alt="Barra superior com atalhos" width="2498" height="204" data-path="assets/images/dashboard/insights/insights-header-filter-pt-br.png" />

<img src="https://mintcdn.com/malga-develop/ykhDb0_GUvxS5LEk/assets/images/dashboard/insights/insights-sidebar-pt-br.png?fit=max&auto=format&n=ykhDb0_GUvxS5LEk&q=85&s=94e82714ba54c3079aa1d6d9b9955f88" alt="Menu lateral com filtros" width="2870" height="1622" data-path="assets/images/dashboard/insights/insights-sidebar-pt-br.png" />

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

  * O filtro por período corresponde à{" "}
    <ins>data de criação da cobrança</ins> na loja (created\_at), estando
    disponíveis cobranças no ambiente online (produção) e no sandbox (ambiente de
    testes) do Dashboard;
  * É possível{" "}
    <ins>filtrar as cobranças em um intervalo de até 31 dias</ins>, a partir do
    dia anterior (d-1), e também com os atalhos pré-estabelecidos (este mês, esta
    semana, mês anterior);
  * Estão disponíveis{" "}
    <ins>todos os dados desde a primeira cobrança</ins> processada na loja
    utilizando a Malga;
  * Os dados apresentados correspondem ao{" "}
    <ins>padrão d-1</ins>, ou seja, trazem as informações das cobranças criadas
    até o dia anterior. 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).
</Info>

## Visão geral das cobranças

Na parte superior do painel, apresentamos a **Visão geral das cobranças** no período pela sua data de criação (<code>created\_at</code>) e moeda (<code>currency</code>), com as seguintes métricas:

* **Total das cobranças** - valor total financeiro e quantidade de cobranças realizadas no período selecionado, correspondendo ao total de vendas ou pedidos da loja;
* **Cobranças autorizadas** - valor total financeiro e quantidade de cobranças pré-autorizadas e autorizadas no período selecionado;
* **Cobranças recusadas** - valor total financeiro e quantidade de cobranças recusadas no período selecionado, contemplando o status falha (failed);
* **Taxa de aprovação geral** - taxa percentual de aprovação das cobranças pré-autorizadas e autorizadas sobre o total de cobranças criadas no período;
* **Taxa de aprovação por dia** - apresentada no gráfico de linha do tempo, representa a taxa de aprovação por dia no período selecionado, contemplando todos os métodos e provedores de pagamento somados. Em cada ponto do gráfico, é possível visualizar a taxa de aprovação, quantidade de cobranças autorizadas, recusadas e o total de cada dia;
* **Cobranças por status** - apresentando o volume % por status das cobranças realizadas no período selecionado. Em cada status, é possível visualizar a quantidade de cobranças e o total financeiro correspondente;

<img src="https://mintcdn.com/malga-develop/ykhDb0_GUvxS5LEk/assets/images/dashboard/insights/insights-charges-resume-pt-br.png?fit=max&auto=format&n=ykhDb0_GUvxS5LEk&q=85&s=5b6b1c5ff1a161e429c81b01fffd3dce" alt="Visão geral das cobranças no Painel de Dados Malga" width="2462" height="1504" data-path="assets/images/dashboard/insights/insights-charges-resume-pt-br.png" />

## Detalhes de cobranças autorizadas

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

### Principais métodos de pagamento

Apresenta as **cobranças autorizadas** (com os status de pré-autorizada e autorizada) por método de pagamento, ordenadas de forma decrescente pelo volume de cobranças nos 6 (seis) principais métodos de pagamento. As métricas representam:

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

### Principais provedores

Apresenta as **cobranças autorizadas** (com os status de pré-autorizada e autorizada) por provedor de pagamento, ordenadas de forma decrescente pelo volume dos 6 (seis) principais provedores da sua loja. As métricas representam:

* **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 pré-autorizadas e autorizadas sobre o total de cobranças processadas pelo provedor no período selecionado (soma das cobranças pré-autorizadas, autorizadas e com falha);
* **Quantidade** de cobranças autorizadas no provedor;
* **Total** financeiro do valor monetário autorizado por provedor;

<img src="https://mintcdn.com/malga-develop/ykhDb0_GUvxS5LEk/assets/images/dashboard/insights/insights-providers-list-pt-br.png?fit=max&auto=format&n=ykhDb0_GUvxS5LEk&q=85&s=ad0d4920ff08d4c62ef0aa28eab4ed2e" alt="Visão de cobranças autorizadas por método e por provedor de pagamento" width="794" height="313" data-path="assets/images/dashboard/insights/insights-providers-list-pt-br.png" />

<Info>
  **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.](/api-reference/type-tables/payment-methods-by-providers)
</Info>

## Detalhes de cobranças recusadas

No bloco de **Detalhes de cobranças recusadas**, são apresentados os principais motivos de recusa das cobranças do método crédito com status recusada (<code>failed</code>), correspondendo ao <code>declinedCode</code> retornado pelo provedor de pagamento e tratado pela Malga.

Os dados são ordenados de forma decrescente pelo motivo de perda com maior volume de cobranças. Ao lado de cada motivo, na listagem de **Principais motivos de recusa**, são exibidas a quantidade de cobranças e o total financeiro monetário das cobranças recusadas por aquele motivo.

<img src="https://mintcdn.com/malga-develop/ykhDb0_GUvxS5LEk/assets/images/dashboard/insights/insights-denied-reason-list-pt-br.png?fit=max&auto=format&n=ykhDb0_GUvxS5LEk&q=85&s=20470c07720abffeb1385f1b694a6568" alt="Principais motivos de recusa das cobranças perdidas" width="1308" height="816" data-path="assets/images/dashboard/insights/insights-denied-reason-list-pt-br.png" />

## Tratamento dos motivos de recusa

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

[Saiba mais sobre os **motivos de recusa** em nossa documentação.](/api-reference/type-tables/declinedCode)

| **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 credenciais inválidas                       | invalid\_credential / invalid\_credentials              |
| Cartão com data inválida                               | invalid\_data                                           |
| Cartão com limite insuficiente                         | insufficient\_funds                                     |
| Cartão com número 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                           |
| Cartão com senha inválida                              | 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 internacional não permitida pelo cartão       | service\_not\_allowed                                   |
| 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                                    |
| Erro no provedor por falha de contrato                 | processing\_error / bad\_request                        |
| Erro genérico no provedor                              | generic / try\_again                                    |
| 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 |
| Limite máximo atingido nas tentativas da senha         | pin\_retry\_exceeded / pin\_try\_exceeded               |
| Motivo de recusa não transmitido pelo provedor         | denied\_reason\_not\_available                          |
| Valor da cobrança não permitido pelo provedor          | invalid\_charge\_amount / invalid\_amount               |

<Info>
  INFORMAÇÕES GERAIS DO PAINEL

  * **Acesso pelo Dashboard:** O
    painel está disponível no ambiente online (produção) e no ambiente de testes
    (sandbox), nos idiomas português (pt-br) e inglês (eng-us);
  * **Painel
    exclusivo para usuários administradores:** O painel de dados possui acesso
    restrito aos administradores da conta da sua empresa, listados no menu
    Usuários do Dashboard. Avise o nosso time de atendimento caso precise realizar
    alguma alteração nos administradores e usuários da sua conta;
  * **Indisponibilidade do Painel:** Realizamos a atualização diária dos dados
    entre 1h e 4h (UTC-3), período no qual o Painel de Dados{" "}
    <ins>permanece indisponível para acesso</ins>;
  * Através da [Analytics
    API](/analytics/intro), é possível realizar consultas na base de cobranças e
    obter as métricas do Painel e o retorno completo sobre o processamentos dos
    provedores. Saiba mais sobre os cálculos disponíveis na API [neste
    release](/release-notes/2023-10-06-Release-Notes).
</Info>
