Skip to main content
GET
Esta rota mostra a situação atual de uma subconta (SubMerchant) específica: dados da empresa, status no credenciamento, datas de aprovação ou inativação e métricas de volume e split. É a forma de confirmar, a qualquer momento, se um vendedor já pode transacionar.

Quando usar

Antes de chamar

Parâmetros de caminho

string
required
Identificador único da subconta. Ex.: 36OO3bcGjhPjjF3tzrqOGcmQuKo.

Respostas

string
Identificador único da subconta. Ex.: 36OO3bcGjhPjjF3tzrqOGcmQuKo.
string
Nome fantasia. Ex.: Loja Exemplo.
Razão social. Ex.: LOJA EXEMPLO LTDA.
string
CNPJ, só com dígitos. Ex.: 11222333000181.
number
Faturamento médio mensal informado no cadastro. O contrato descreve o campo como “decimal as string”, mas o tipo declarado é number. Ex.: 5000.
number
Ticket médio informado no cadastro. O contrato descreve o campo como “decimal as string”, mas o tipo declarado é number. Ex.: 100.
string
Tipo de produto vendido: digital, physical ou both.
string
Site da subconta (formato uri). Ex.: https://loja.exemplo.com.br.
string
Identificador do gateway ligado à subconta. Ex.: 36O08tjxJCxtEFApVPyWbryktP3.
string | null
Data e hora da aprovação (formato date-time). Ex.: 2026-10-21T14:02:51.762Z.
string | null
Data e hora da inativação (formato date-time). Ex.: null.
string
Status atual: active, pending, pre_approved, correcting, inactive, rejected ou blocked.
object
Métricas agregadas da subconta.
string
E-mail de contato (formato email). Ex.: [email protected].
string
Descrição dos produtos ou serviços. Ex.: Roupas e acessórios femininos.
string | null
Nome que aparece na fatura do cartão do cliente. Ex.: null.
string
Data e hora de criação (formato date-time). Ex.: 2026-10-20T18:45:52.988Z.
number
Total de vendas da subconta. Ex.: 0.
O contrato desta rota não informa quais campos são sempre presentes. Trate qualquer campo como possivelmente ausente.

O que fazer em cada status

O motivo de uma recusa ou de um pedido de correção chega no campo rejectionReason do aviso de status, descrito em Webhooks de conta. Esta rota não devolve esse campo.
Para o negócio: antes de liberar um vendedor para vender na sua plataforma, confira se o status é active. Uma subconta que ainda não foi aprovada não está apta a transacionar.

Erros comuns

Veja também

Listar subcontas

Todas as subcontas, com filtros.

Chaves de API da subconta

Chaves para cobrar em nome do vendedor.

Subcontas e KYC

Ciclo de credenciamento.

Webhooks de conta

Avisos de mudança de status.