Subcontas

Através da área de Subcontas do Dashboard Malga, é possível conferir informações básica, 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 simplifica a utilização dos filtros.

Listagem de Subcontas

No menu de Subcontas no Dashboard Malga, 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

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"
        }
      }
    ]
  }'

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
  }'

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
  }'

Criação de novo merchant

Contrato completo do endpoint de criação de subcontas.

Atualizar configurações de merchant

Contrato completo do endpoint de atualização de subcontas.

Renomear Subcontas

Confira o passo a passo para nomear as Subcontas:

Acesse subcontas

Acesse o menu e selecione a subconta que deseja nomear

Clique em editar

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

Escolha um novo nome

Digite o nome personalizado que deseja atribuir e clique em Salvar

Pronto!

Ao retornar para listagem de Subcontas, ela estará ordenada pela atualização mais recente;

A partir daí, o nome da sua subconta estará refletido na área de Fluxos Inteligentes, através da qual é possível editar e publicar alterações no fluxo de pagamentos da sua loja, e também nos filtros, detalhe e exportação de cobranças e também na área de Links de pagamento.

Comece na Malga

Conexões

Guias

Serviços adicionais

Listagem de Subcontas

Detalhes de uma Subconta

Provedores ativos no detalhe da subconta

Status da subconta

Como o status é definido e atualizado

Exemplos de requisição

Criação de novo merchant

Atualizar configurações de merchant

Renomear Subcontas

​Listagem de Subcontas

​Detalhes de uma Subconta

​Provedores ativos no detalhe da subconta

​Status da subconta

​Como o status é definido e atualizado

​Exemplos de requisição

Criação de novo merchant

Atualizar configurações de merchant

​Renomear Subcontas

Listagem de Subcontas

Detalhes de uma Subconta

Provedores ativos no detalhe da subconta

Status da subconta

Como o status é definido e atualizado

Exemplos de requisição

Renomear Subcontas