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

# KYC

> Endpoints de verificação de identidade (KYC) para pessoa física e jurídica: propostas, envio de documentos, validação de CPF e consulta de status.

Os endpoints de KYC tratam da verificação de identidade de pessoas físicas e jurídicas. Exigem autenticação por token JWT.

<Info>
  No SDK, esses endpoints estão no recurso `client.kyc`. Veja a [Referência de Métodos](/pt-BR/sdks/method-reference).
</Info>

## Visão geral

| Método (SDK)      | Descrição                                      |
| ----------------- | ---------------------------------------------- |
| `naturalProposal` | Cria proposta de KYC para pessoa física.       |
| `legalProposal`   | Cria proposta de KYC para pessoa jurídica.     |
| `documentUrl`     | Obtém a URL para envio de documentos.          |
| `check`           | Consulta o status da verificação.              |
| `cpfValidate`     | Valida um CPF.                                 |
| `userData`        | Retorna os dados do usuário associados ao KYC. |

## Proposta de pessoa física

Cria uma proposta de KYC para pessoa física.

<ParamField header="Authorization" type="string" required>
  `Bearer <tokenJWT>`
</ParamField>

<RequestExample>
  ```ts SDK theme={null}
  const proposal = await client.kyc.naturalProposal({ /* dados da pessoa física */ });
  ```
</RequestExample>

## Proposta de pessoa jurídica

Cria uma proposta de KYC para pessoa jurídica.

<ParamField header="Authorization" type="string" required>
  `Bearer <tokenJWT>`
</ParamField>

<RequestExample>
  ```ts SDK theme={null}
  const proposal = await client.kyc.legalProposal({ /* dados da pessoa jurídica */ });
  ```
</RequestExample>

## URL de envio de documentos

Retorna a URL para envio dos documentos de verificação.

<RequestExample>
  ```ts SDK theme={null}
  const { url } = await client.kyc.documentUrl({ /* parâmetros */ });
  ```
</RequestExample>

## Consultar status

Consulta o status atual da verificação de KYC.

<RequestExample>
  ```ts SDK theme={null}
  const status = await client.kyc.check();
  ```
</RequestExample>

## Validar CPF

Valida um CPF informado.

<RequestExample>
  ```ts SDK theme={null}
  const result = await client.kyc.cpfValidate({ cpf: '000.000.000-00' });
  ```
</RequestExample>

## Dados do usuário

Retorna os dados do usuário associados ao processo de KYC.

<RequestExample>
  ```ts SDK theme={null}
  const data = await client.kyc.userData();
  ```
</RequestExample>

<Warning>
  Alguns fluxos de pagamento exigem KYC aprovado. Um `403` pode indicar KYC pendente. Consulte os limites por nível de verificação na sua conta.
</Warning>