> ## Documentation Index
> Fetch the complete documentation index at: https://laas.mippo.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Enviar dados de KYC para triagem de compliance

> Envie dados de KYC e PEP do usuário final para executar triagem AML e checagem de sanções antes de habilitar transações Pix para stablecoin.

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

**X-Mippo-API-Key** `string` *required*

Sua API key.

**cpf** `string` *required*

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

**biometricHash** `string` *required*

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

**personType** `string` (default: PF)

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

**partnerKycToken** `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.

```json Request theme={null}
{
  "cpf": "123.456.789-09",
  "biometricHash": "sha256:abc123def456",
  "personType": "PF",
  "partnerKycToken": "your_vendor_token"
}
```

## Response

**success** `boolean`

Sempre `true` em respostas 2xx.

**data.token** `string`

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

**data.status** `string`

`APPROVED` | `PENDING` | `REJECTED`

**data.riskTier** `string`

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

**data.expiresAt** `string`

Timestamp ISO 8601 de quando o token de KYC expira.

```json Response (200) theme={null}
{
  "success": true,
  "data": {
    "token": "kyc_1719000000_abc123",
    "status": "APPROVED",
    "riskTier": "STANDARD",
    "expiresAt": "2026-07-24T00:00:00.000Z"
  }
}
```

```json Response (422 — rejected) theme={null}
{
  "success": false,
  "error": {
    "code": "KYC_REJECTED",
    "message": "Client failed compliance screening.",
    "details": { "reason": "SANCTIONS_HIT" }
  }
}
```

> [!NOTE]
>
> 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.