> ## 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. # Visão geral Visão geral do Painel de dados Malga Visão geral do Painel de dados Malga 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 cobranças aprovadas, em relação ao total de cobranças criadas no período selecionado. **Cobranças aprovadas** São consideradas aprovadas as cobranças que foram autorizadas ou pré-autorizadas pelo emissor, mesmo que tenham mudado de status posteriormente. 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. **Fórmula de cálculo** Taxa de aprovação = (Cobranças aprovadas / Total de cobranças) × 100 #### 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 chargeback; * A quantidade de cobranças recusadas; * E o total de cobranças processadas naquele dia. A taxa de aprovação é calculada com base na data da última atualização da cobrança. Isso significa que, se uma cobrança aprovada for posteriormente cancelada, estornada ou sofrer chargeback, 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 sequência, é possível conferir os principais métodos e provedores de pagamento responsáveis pelas cobranças da sua loja, conforme descrito abaixo: Visão métodos de pagamentos e provedores Visão métodos de pagamentos e provedores #### Métodos de pagamento Exibe as cobranças autorizadas — incluindo os status de pré-autorizada, autorizada, cancelada, estornada e chargeback — 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 (pré-autorizada, autorizada, cancelada, estornada e chargeback) 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; **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) *** Visão geral das cobranças Visão geral das cobranças #### Bandeira de cartão Apresenta as cobranças autorizadas (com os status de pré-autorizada, autorizada, cancelada, estornada e chargeback) 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 motivos de recusa, 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 motivos de recusa 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 Visão geral do Painel de dados Malga Visão geral do Painel de dados Malga Através dos filtros de período, moeda, subconta e método de pagamento, recebedor e, na visão Empresa, subconta, é 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** (somente na visão Empresa): é 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. Na visão de uma subconta, esse filtro não aparece, porque o contexto já está definido pelo seletor do menu lateral. * **Recebedor**: filtre as cobranças pelo recebedor do split. Disponível nas duas visões. **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). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.