Marketplace - Credenciamento pela sua própria tela

#Visão Geral

O link de credenciamento abre uma página hospedada pela Selectwin. Se a sua plataforma prefere que o vendedor preencha o cadastro dentro do seu produto, use os mesmos passos pela API: o token do link é a credencial, e cada chamada leva o token no caminho, sem chave de API.

GET  /v1/marketplace/kyc/{token}                                    valida o link e devolve o nome da sub-conta
GET  /v1/marketplace/kyc/{token}/onboarding                         o cadastro como está (passo atual, o que falta)
GET  /v1/marketplace/kyc/{token}/onboarding/document-types          tipos de documento que o passo 1 pode escolher
GET  /v1/marketplace/kyc/{token}/onboarding/document-requirements   o que o passo 3 tem de entregar e em que pé está
POST /v1/marketplace/kyc/{token}/onboarding/invite-code/validate    confere um código de convite sem consumir
POST /v1/marketplace/kyc/{token}/assets/uploads                     pede uma URL de upload para um documento
POST /v1/marketplace/kyc/{token}/assets/uploads/{assetId}/confirm   confirma o upload
POST /v1/marketplace/kyc/{token}/onboarding/step-1 … step-6         os seis passos

Os corpos de cada passo estão na referência OpenAPI (operações submitKycStep1 a submitKycStep6); abaixo, o que cada um faz e os campos que importam.

#Precauções

• O token é uma credencial. Guarde-o só no seu servidor e nunca o exponha no navegador do vendedor nem em logs. Se a sua tela roda no navegador, o seu backend faz as chamadas.
• O link vale 7 dias e só para uma sub-conta ainda não ativa. Gerar um novo link invalida o anterior.
• Os passos são os mesmos do cadastro normal: cada envio grava e pode ser reenviado para corrigir, até o passo 6, que fecha o cadastro e o põe em análise.
• Os uploads têm limite por hora por sub-conta (429 kycUploadLimitReached).
• Dados de pessoas (CPF, nascimento, endereço) são dados pessoais: colete só o que o passo pede e trate conforme a LGPD.

#Os passos

#Documentos: o fluxo de upload

1. GET …/onboarding/document-requirements — para cada exigência (identity, selfie, proof_of_address_company…), as alternativas aceitas e o status de cada uma.
2. POST …/assets/uploads com { filename, contentType, byteSize } — responde a URL assinada e o assetId. Envie o arquivo para a URL.
3. POST …/assets/uploads/{assetId}/confirm — confirma.
4. POST …/onboarding/step-3 com documents: [{ documentType, assetId }].

A resposta de document-requirements traz também captureQuality: a régua que uma foto de documento deve atingir (resolução, nitidez, exposição) para não ser recusada na análise. Use-a para avisar o vendedor enquanto ele ainda pode fotografar de novo.

#Depois do passo 6

Acompanhe como no fluxo pelo link: seller.analyzing → seller.approved (a sub-conta fica active) ou seller.refused; se a análise pedir documentos de novo, seller.kycRequired e a sub-conta volta a awaiting-documents. A plataforma lê o estado a qualquer momento em Andamento do cadastro, sem o token.

#Erros