Etapa 03 - Solicitação de Análise

Pré-condição

O Onboarding precisa estar com todos os documentos obrigatórios enviados. Caso tenha dúvidas, consulte através do endpoint de consulta de credenciamento:

GET /v1/marketplaces/{marketplace_id}/onboarding/{onboarding_id}

Resposta

{
  "onboarding_id": "UUI",
  "status": "WAITING_APPROVAL_REQUEST",
  "profile_id": "UUID",
  "documents": {
    "uploaded": [ { "type": "SELFIE" } ],
    "pending": [ "CNH_FRONT", "CNH_BACK" ]
  }
}

Solicitar análise

POST /v1/marketplaces/{marketplace_id}/onboarding/{onboarding_id}/approval

Resposta

O que acontece depois

A análise roda em segundo plano. Você é notificado do resultado por webhook:

• ✅ Aprovado → onboarding.approved
• ❌ Recusado → onboarding.rejected

Regras de negócio relevantes

⏱️ SLA de análise

• ≤ 3 minutos em 90% dos casos (MEI/ME/EPP/LTDA)

• Até 3 dias úteis para S/A (ou LTDA com S/A na cadeia)

🚫 Divergência QSA → REJECTED

• Não há estado de correção — é preciso iniciar novo credenciamento

📋 Envio de documentos NÃO muda o status

• O profile fica WAITING_APPROVAL_REQUEST até você solicitar a aprovação

Consultar status de um credenciamento

GET /v1/marketplaces/{marketplace_id}/onboarding/{onboarding_id}

Resposta

{
  "onboarding_id": "17d9e827-...",
  "marketplace_id": "f8c2bfb8-...",
  "status": "WAITING_REQUIRED_DOCUMENTS",
  "documents": {
    "uploaded": [ { "id": "doc-1", "type": "SELFIE" } ],
    "pending": [ "CNH_FRONT", "CNH_BACK" ]
  },
  "external_reference_id": "uuid-gerado-pelo-marketplace",
  "created_at": "2026-10-14T12:00:00Z",
  "updated_at": "2026-10-14T12:00:04Z"
}

Campos da Resposta

• status — estado atual (veja Estados do Credenciamento)
• documents.uploaded[] — documentos já recebidos
• documents.pending[] — tipos obrigatórios ainda não enviados

Para mais informações sobre o status do credenciamento, consulte Estados do Credenciamento.