> ## 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.
# Subcontas
Através da página **Gerenciar subcontas** do Dashboard Malga, acessada pelo seletor de contexto no topo do menu lateral, é possível conferir informações básicas, visualizar os provedores ativos, além de editar e atribuir nomes personalizados para as subcontas (merchants) da sua empresa. Isso facilita a gestão dos provedores e métodos habilitados para o fluxo inteligente de pagamentos e a identificação de cada subconta no seletor e nos filtros.
O antigo item **Subcontas** do menu lateral foi substituído pelo botão **Gerenciar subcontas**, no rodapé do [seletor de contexto](/documentations/dashboard/context-selector). O endereço da página continua o mesmo.
## Listagem de Subcontas
Em **Gerenciar subcontas**, exibimos a **listagem de subcontas** desta conta, ordenadas pela data de atualização mais recente. Na listagem, são apresentadas as seguintes informações:
* Data de atualização;
* Nome da subconta;
* ID do merchant (subconta);
* Provedores ativos;
* Métodos de pagamento.
No campo de busca, localizado no canto superior direito da página, é possível encontrar uma subconta específica pelo nome.
## Detalhes de uma Subconta
Ao clicar em uma subconta na listagem, você pode visualizar os detalhes da subconta. Na página de detalhes, são exibidos:
* Nome da subconta;
* Merchant ID (identificador da subconta);
* MCC cadastrado;
* Métodos de pagamento ativos;
* Datas de criação e de última atualização da subconta;
* Provedores ativos.
### Provedores ativos no detalhe da subconta
Ao clicar na “setinha” no provedor, são exibidas as seguintes informações relacionadas ao provedor naquela subconta:
* Nome do provedor;
* ID do provedor;
* Status;
* Data de ativação;
* Métodos de pagamento ativos.
## Status da subconta
Toda subconta tem um campo `status` que indica se ela está ativa (`true`) ou inativa (`false`). Esse estado é gerenciado exclusivamente pela API — não há edição pelo Dashboard.
O `status` é informativo. Uma subconta inativa **continua processando transações normalmente**: desativá-la não bloqueia cobranças, links de pagamento ou assinaturas.
Não confunda o `status` da subconta com:
* O **Status do provedor**, exibido no detalhe da subconta, que se refere à conexão com aquele provedor;
* A **exclusão da subconta**, feita pelo endpoint de deleção, que remove a subconta da listagem.
### Como o status é definido e atualizado
| Operação | Comportamento |
| - | - |
| Criação de subconta | O campo `status` é opcional. Quando omitido, a subconta é criada como ativa (`true`). |
| Atualização de subconta | Envie apenas o campo `status` para ativar (`true`) ou desativar (`false`) a subconta. |
| Listagem e detalhe | O campo `status` é retornado em todas as respostas de subconta. |
### Exemplos de requisição
```bash Criar subconta inativa theme={null}
curl --request POST 'https://api.malga.io/v1/merchants' \
--header 'X-Client-Id: YOUR_CLIENT_ID' \
--header 'X-Api-Key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
"name": "Minha Loja",
"mcc": "4789",
"status": false,
"providers": [
{
"name": "SandboxProvider",
"priority": 1,
"credentials": {
"type": "SANDBOX",
"apiKey": "YOUR_PROVIDER_API_KEY"
}
}
]
}'
```
```bash Ativar subconta theme={null}
curl --request PATCH 'https://api.malga.io/v1/merchants/MERCHANT_ID' \
--header 'X-Client-Id: YOUR_CLIENT_ID' \
--header 'X-Api-Key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
"status": true
}'
```
```bash Desativar subconta theme={null}
curl --request PATCH 'https://api.malga.io/v1/merchants/MERCHANT_ID' \
--header 'X-Client-Id: YOUR_CLIENT_ID' \
--header 'X-Api-Key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
"status": false
}'
```
Contrato completo do endpoint de criação de subcontas.
Contrato completo do endpoint de atualização de subcontas.
## Renomear Subcontas
Confira o **passo a passo para nomear as Subcontas:**
Clique no nome da empresa no topo do menu lateral, selecione **Gerenciar subcontas** no rodapé do seletor e clique na subconta que deseja nomear.
Na tela de detalhes da subconta, através do botão Editar localizado no canto superior direito, será habilitada a edição do campo de nome
Digite o nome personalizado que deseja atribuir e clique em Salvar
Ao retornar para listagem de Subcontas, ela estará ordenada pela atualização mais recente;
A partir daí, o **nome da sua subconta** estará refletido no seletor de contexto do menu lateral, na área de Fluxos Inteligentes, através da qual é possível editar e publicar alterações no fluxo de pagamentos da sua loja, no filtro de subconta (visão Empresa), no detalhe e na exportação de cobranças e na área de Links de pagamento.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.