> ## 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. # Repasses > O que a página Repasses do Dashboard mostra, quando e onde o repasse cai na conta e como acompanhar cada repasse pela API. O **repasse** é a transferência do seu saldo para a sua conta bancária, e é sempre automático. A página **Repasses**, no menu **Financeiro** do [Dashboard Malga](https://dashboard.malga.io/), mostra a posição do seu saldo e todos os repasses já criados. Para entender a diferença entre recebível e repasse, veja a [introdução ao Financeiro](https://docs.malga.io/documentations/dashboard/financeiro/intro.md). ## Listagem de repasses ![Listagem de repasses](https://mintcdn.com/malga/m4Lp6Ez2CCzbt0OA/assets/images/dashboard/financeiro/payouts/payouts-list-light.png?fit=max\&auto=format\&n=m4Lp6Ez2CCzbt0OA\&q=85\&s=befbd49c32ecf8b7d4b2290a726abdfc) Por padrão, a listagem mostra os últimos 7 dias. Use o **filtro de período** para consultar outras datas. Clique em uma linha para abrir o detalhe do repasse. ## Saldos | Card | O que mostra | | - | - | | **Saldo a receber** | Tudo o que você ainda vai receber na conta bancária de vendas aprovadas: o que já liquidou e não foi repassado, mais o que ainda vai liquidar | | **Saldo reserva** | Valor retido como garantia. Não entra nos repasses nem nos outros saldos | | **Próximo repasse** | Previsão do valor e da data do próximo repasse, conforme a sua política de repasse | O saldo da sua empresa não é a soma dos saldos dos recebedores, nem no Dashboard nem na API. Para ver o saldo de um recebedor, abra o detalhe dele em **Recebedores** ou consulte a API com `sellerId`. ## Status | No Dashboard | Status na API | O que significa | | - | - | - | | Em andamento | `pending` | Lote criado, aguardando a data de pagamento | | Pago | `paid` | Valor transferido para a conta de recebimento | | Falha | `failed` | A transferência foi tentada e não se concluiu. O motivo vem em `error.reason` | | Não aparece | `offset` | O lote fechou com saldo zero ou negativo e foi usado para abater saldo devedor | O status `offset` vale para a API e para os relatórios. No Dashboard, ele não é uma linha da listagem de repasses: o valor entra como **Saldo negativo anterior** na composição do repasse que quitou a dívida. ## Detalhe do repasse O detalhe do repasse explica como o valor depositado foi formado. **Composição do repasse:** cada linha é um valor que somou ou descontou do repasse, até chegar ao que foi depositado. | Linha | O que é | | - | - | | **Valor bruto** | Soma do valor bruto dos recebíveis que liquidaram neste repasse | | **Taxas** | MDR e, quando houver, taxa de antecipação desses recebíveis | | **Tarifas** | Serviços cobrados por uso, como antifraude e autenticação 3DS | | **Estornos e chargebacks** | Valores de vendas desfeitas depois de liquidadas, já com a taxa devolvida | | **Ajustes** | Correções lançadas pela Malga. É a única linha que pode ser positiva | | **Saldo negativo anterior** | Desconto de um ciclo anterior que fechou com saldo negativo | | **Taxa de saque** | Valor fixo cobrado por transferência, um por repasse | | **Depositado na conta** | O valor que chegou à sua conta bancária | Linhas sem valor não aparecem. Um repasse sem tarifas, por exemplo, não mostra a linha **Tarifas**. **Recebíveis do repasse:** lista cada parcela que liquidou neste repasse. Clique na linha para abrir o detalhe da cobrança. * Um recebível com **cancelamento parcial** aparece pelo valor que de fato liquidou. * Recebíveis **totalmente cancelados** não aparecem e não entram no valor bruto. * **Estornos e chargebacks** não aparecem na lista, porque o recebível deles liquidou em um repasse anterior. Eles estão na linha correspondente da composição. **Pela cobrança:** o caminho inverso também funciona. No detalhe de uma cobrança, a aba **Recebíveis** mostra os recebíveis que aquela venda gerou, com a data prevista, o status de cada um e se o repasse já foi pago. Quando o repasse já existe, clique na linha para abrir o detalhe dele. > [!NOTE] > > O detalhe do repasse é um retrato do dia em que ele foi feito. Se a cobrança sofrer um estorno depois, o repasse já pago não muda: o estorno entra como desconto em um repasse futuro. Para ver o estado atual da venda, abra o detalhe da cobrança. ## Quando e onde o repasse cai ### Horários Os repasses são feitos apenas em dias úteis bancários. O horário depende do método de pagamento: | Método | Horário do repasse | | - | - | | Pix | 18h | | Cartão de crédito | A partir das 7h50 | ### Conta de recebimento | De quem | Onde está a conta | Como trocar | | - | - | - | | **Sua empresa** | Cadastrada na contratação do Provedor Malga | Pelo suporte da Malga | | **Recebedor** | Campo `bankAccount` do recebedor | [PATCH /v1/sellers/\{id}](https://docs.malga.io/api-reference/sellers/atualizacao-de-recebedor-pelo-id.md) | O titular da conta precisa ser o mesmo documento do recebedor. Veja [Recebedores](https://docs.malga.io/documentations/split/seller.md). No Dashboard, a conta de destino aparece completa na listagem de repasses. ## Pela API Não há webhook de repasse, de ordem nem de antecipação. Acompanhe pela API de payouts, pelo lote. **1. Liste os lotes do dia.** Para um recebedor específico, envie também `sellerId`. ```bash theme={null} curl --location 'https://api.malga.io/v1/payouts/payment-batches?paymentDate=2026-10-14&status=pending,paid,failed' \ --header 'X-Client-Id: YOUR_CLIENT_ID' \ --header 'X-Api-Key: YOUR_API_KEY' ``` **2. Veja as ordens de cada lote.** ```bash theme={null} curl --location 'https://api.malga.io/v1/payouts/payment-batches/BATCH_ID/orders?limit=100' \ --header 'X-Client-Id: YOUR_CLIENT_ID' \ --header 'X-Api-Key: YOUR_API_KEY' ``` **3. Repita até o status final.** Consulte de novo os lotes `pending` mais tarde no dia. > [!TIP] > > Não use o `updatedAt` da ordem para saber se ela entrou num lote: o vínculo ao lote não altera esse campo. Acompanhe pelo lote, como acima. ### Endpoints | Ação | Endpoint | | - | - | | Saldo disponível e a receber | [GET /v1/payouts/balance](https://docs.malga.io/api-reference/payouts/consultar-saldo-de-payouts.md) | | Listar repasses (lotes) | [GET /v1/payouts/payment-batches](https://docs.malga.io/api-reference/payouts/listar-payment-batches.md) | | Consultar um repasse | [GET /v1/payouts/payment-batches/\{id}](https://docs.malga.io/api-reference/payouts/consultar-payment-batch-pelo-id.md) | | Ordens de um repasse | [GET /v1/payouts/payment-batches/\{id}/orders](https://docs.malga.io/api-reference/payouts/listar-ordens-de-um-payment-batch.md) | | Listar ordens | [GET /v1/payouts/orders](https://docs.malga.io/api-reference/payouts/listar-ordens.md) | | Consultar uma ordem | [GET /v1/payouts/orders/\{id}](https://docs.malga.io/api-reference/payouts/consultar-ordem-pelo-id.md) | Todas as rotas são de leitura e aceitam `sellerId` para filtrar por recebedor. Sem `sellerId`, `orders` traz só as ordens da sua conta. ## Links e documentações úteis * [Introdução ao Financeiro](https://docs.malga.io/documentations/dashboard/financeiro/intro.md) * [Extrato](https://docs.malga.io/documentations/dashboard/financeiro/statement.md) * [Relatório de repasses](https://docs.malga.io/relatorio-de-repasses-detalhe-por-transacao-do-lote.md) * [API de Payouts](https://docs.malga.io/api-reference/payouts/listar-payment-batches.md) > [!NOTE] > > **Suporte Malga** > > Acione o nosso time pelo e-mail [suporte@malga.io](mailto:suporte@malga.io) para dúvidas sobre repasses, saldo e recebíveis. ## Related topics - [Listar repasses](https://docs.malga.io/api-reference/payouts/listar-payment-batches.md) - [Out 19, 2026 - Repasses e recebíveis no Dashboard](https://docs.malga.io/release-notes/2026-10-19-Release-Notes.md) - [Resumo de repasses (consolidado por lote)](https://docs.malga.io/resumo-de-repasses-consolidado-por-lote.md) - [Out 13, 2026 - Relatórios de repasses no Dashboard](https://docs.malga.io/release-notes/2026-10-13-Release-Notes.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.