Sub-contas - Andamento do cadastro
Visão Geral
Mostra em que pé está o credenciamento de uma sub-conta: o status, o passo do cadastro, cada documento exigido e o estado dele, e a última mudança de status (para onde, quando e quem). É o que a plataforma consulta quando a sub-conta não avança: um cadastro parado, documentos recusados ou pedidos de novo, uma suspensão.
Requisição
HTTP
GET /v1/marketplace/sub-accounts/{companyId}/onboardingResposta
Sucesso (200 OK)
JSON
{
"id": "bus_01hqzvsub1",
"status": "awaiting-documents",
"reviewDueAt": "2026-10-22T12:00:00.000Z",
"onboarding": { "currentStep": "6", "isCompleted": true, "completedAt": "2026-10-17T15:20:11.000Z" },
"documents": {
"documentType": "cnpj",
"complete": false,
"requirements": [
{
"key": "identity",
"subject": "holder",
"required": true,
"status": "rejected",
"alternatives": [
{ "key": "cnh_front+cnh_back", "status": "rejected", "documents": [ { "type": "cnh_front", "status": "rejected", "rejectionReason": "image_unreadable" }, { "type": "cnh_back", "status": "approved" } ] },
{ "key": "rg_front+rg_back", "status": "missing", "documents": [ { "type": "rg_front", "status": "missing" }, { "type": "rg_back", "status": "missing" } ] }
]
},
{ "key": "cnpj_card", "subject": "company", "required": true, "status": "approved", "alternatives": [ { "key": "cnpj_card", "status": "approved", "documents": [ { "type": "cnpj_card", "status": "approved" } ] } ] }
]
},
"lastStatusChange": { "from": "analyzing", "to": "awaiting-documents", "by": "staff", "at": "2026-10-18T10:02:45.000Z" }
}| Campo | Descrição |
|---|---|
status | O status da sub-conta (pending, analyzing, awaiting-documents, active, blocked, disabled) |
reviewDueAt | Até quando a análise responde, quando há um prazo; null fora da análise |
onboarding.currentStep · isCompleted · completedAt | O passo em que o cadastro está, se foi fechado (passo 6) e quando |
documents.documentType | cpf ou cnpj, ou null antes do passo 1 |
documents.complete | Toda exigência obrigatória tem uma alternativa enviada ou aprovada |
documents.requirements[] | Cada exigência: key (o que é), subject (holder = a pessoa, company = a empresa), required, status (approved > pending > rejected > missing) e as alternatives[] — uma alternativa completa basta; cada documento dela traz type, status e, quando recusado, rejectionReason |
lastStatusChange | A última transição: from, to, at e by — staff (a análise da Selectwin), provider (o provedor de pagamento), seller (o próprio vendedor, ao enviar o cadastro ou os documentos), platform (a sua plataforma, por suspensão ou reabilitação) ou system. null sem histórico |
Como usar
status: "pending"comonboarding.isCompleted: true— o vendedor terminou, mas faltou um dado essencial e o cadastro não entrou na análise. Peça que complete pelo link (gere um novo, se o anterior venceu).status: "awaiting-documents"— veja emdocuments.requirements[]quais estãorejectedoumissinge peça exatamente esses ao vendedor.status: "analyzing"— aguardeseller.approvedouseller.refused;reviewDueAtdiz até quando.status: "disabled"comlastStatusChange.by: "platform"— foi a sua plataforma que suspendeu; reabilite quando quiser. Comby: "staff", a suspensão é da Selectwin.
Erros
| HTTP | error.code | Quando |
|---|---|---|
| 404 | subAccountNotFound | O companyId não é uma sub-conta da sua plataforma |
Atualizado em 21 de outubro de 2026