Pular para o conteúdo principal
O Supercosmos for Platforms oferece três modelos de KYC/AML. Escolha o que se encaixa na sua estrutura de compliance atual. O fluxo de liquidação da transação (Pix → stablecoin) é idêntico nos três modelos; apenas a etapa de KYC muda. Cada plataforma é responsável por avaliar as próprias obrigações regulatórias.
Todos os diagramas de sequência abaixo mostram as chamadas de método do SDK à esquerda e os endpoints da API subjacentes à direita. O SDK é apenas uma camada fina — você pode chamar a API REST diretamente, se preferir.

​
Modelo 1 — Direct Onboard

O Supercosmos executa todo o fluxo de KYC/AML. Seu aplicativo coleta CPF, selfie e endereço da carteira; o Supercosmos cuida do restante. Ideal para plataformas que estão lançando sem um fornecedor de KYC já contratado. Quem executa o KYC: Supercosmos
No sandbox, use o CPF 000.000.001-91 para forçar riskTier: "HIGH" e exercitar o caminho de prova de vida.

​
Modelo 2 — Client via Platform

Sua plataforma já executa o KYC com um fornecedor próprio (por exemplo, Idwall, unico check ou Sumsub diretamente). O Supercosmos aceita seu token de KYC, aplica uma triagem independente de sanções e KYT e então emite o próprio kycToken para prosseguir. Quem executa o KYC: Plataforma (principal) + Supercosmos (triagem independente)
Um partnerKycToken não dispensa a triagem independente do Supercosmos. Se o Supercosmos detectar uma correspondência em listas de sanções que seu fornecedor não capturou, kyc.submit retorna KYC_REJECTED com reason: "SANCTIONS_HIT". Veja as Notas de Compliance para detalhes.

​
Modelo 3 — Shared Onboard

As duas camadas contribuem para o KYC. Seu aplicativo coleta CPF e dados básicos; o Supercosmos coleta a biometria (via Sumsub WebSDK embedado na sua interface). Um cruzamento dos dois conjuntos de dados produz o resultado conjunto de KYC. Quem executa o KYC: Plataforma (CPF + documento) + Supercosmos (biometria + prova de vida)
No modo Shared, o Supercosmos gera um applicantId no Sumsub para você quando kyc.submit é chamado. Basta enviar o biometricHash — o SDK cuida do embedding do Sumsub automaticamente.

​
Estados da transação

Independentemente do modelo, toda transação percorre a mesma máquina de estados após o KYC ser aprovado: Faça polling em mippo.transactions.status(transactionId) ou escute os webhooks — veja o guia de Webhooks para a referência dos eventos.