Enviar dados de KYC para triagem de compliance

Envia os dados de identidade de um cliente para triagem de sanções (COAF, OFAC, ONU), verificação de PEP e avaliação de risco de wallet via Sumsub. Retorna um token de KYC utilizado nas chamadas de transação subsequentes.

Request

string

obrigatório

Sua API key.

string

obrigatório

CPF brasileiro em qualquer formato: 123.456.789-09 ou 12345678909.

string

obrigatório

Hash SHA-256 dos dados biométricos coletados no seu fluxo de onboarding. Formato: sha256:<hex>.

string

padrão:"PF"

"PF" (pessoa física) ou "PJ" (pessoa jurídica / titular de CNPJ).

string

Apenas para o Modelo 2 (cliente via plataforma). Passe seu próprio token de KYC; a Supercosmos executa uma análise independente por cima.

Request

{
  "cpf": "123.456.789-09",
  "biometricHash": "sha256:abc123def456",
  "personType": "PF",
  "partnerKycToken": "your_vendor_token"
}

Response

boolean

Sempre true em respostas 2xx.

string

Token de KYC. Envie para POST /v1/laas/transactions/initiate. Válido por 24 horas.

string

APPROVED | PENDING | REJECTED

string

STANDARD | HIGH | PEP — determina qual auth challenge é retornado ao iniciar a transação.

string

Timestamp ISO 8601 de quando o token de KYC expira.

Response (200)

{
  "success": true,
  "data": {
    "token": "kyc_1719000000_abc123",
    "status": "APPROVED",
    "riskTier": "STANDARD",
    "expiresAt": "2026-07-24T00:00:00.000Z"
  }
}

Response (422 — rejected)

{
  "success": false,
  "error": {
    "code": "KYC_REJECTED",
    "message": "Client failed compliance screening.",
    "details": { "reason": "SANCTIONS_HIT" }
  }
}

Mesmo no Modelo 2, a Supercosmos executa sua própria triagem de sanções de forma independente. Enviar um partnerKycToken não dispensa as verificações da Supercosmos.

Visão geral

KYC

Transações

Acesso

Enviar dados de KYC para triagem de compliance

Request

Response

​Request

​Response

Request

Response