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

# Validação de identidade e segurança

> KYC via Idwall, cartão só tokenizado.

A arquitetura de onboarding e pagamentos da Ticto delega responsabilidades críticas a microserviços e parceiros especializados. É fundamental entender os dois pilares a seguir para integrar operações financeiras com sucesso através do Nexus.

<h2 id="kyc-e-onboarding-via-idwall">
  KYC e onboarding (via Idwall)
</h2>

Para que os usuários realizem operações financeiras restritas no ecossistema (como antecipações e saques), é obrigatória a validação de identidade (Know Your Customer).

**Como funciona:** A análise biométrica e documental é realizada de forma automatizada por nossa parceira Idwall, garantindo a conformidade antifraude. Todo o fluxo de captura de documentos e reconhecimento facial é feito através de um processo guiado, acessível via iframe (interface embarcada) fornecido pela parceira.

**Implementação via API Nexus:** A API não recepciona o upload de imagens ou documentos brutos (como fotos do RG ou selfies). O endpoint de onboarding requer apenas o envio do token gerado pela Idwall, emitido logo após o usuário finalizar a etapa guiada no iframe. A validação desse token e a aprovação do cadastro ocorrem de forma assíncrona pela API.

<Tip>
  **Recomendação:** registre seu webhook no evento `user_onboarded` (veja [Webhooks](/guia/webhooks)). Assim que o motor da Idwall finalizar a checagem com sucesso, nossa API disparará o webhook, indicando que o produtor está validado e apto a sacar os fundos.
</Tip>

<h2 id="tokenizacao-de-cartoes-de-credito">
  Tokenização de cartões de crédito
</h2>

Para assegurar a conformidade irrestrita com a norma PCI-DSS, a plataforma impede o tráfego em claro de dados sensíveis do titular do cartão nos endpoints base do Nexus.

**Como funciona:** Um serviço especializado de front-end da Ticto atua isoladamente como tokenizador. Quando um cliente informa seu número de cartão de crédito no checkout, este módulo seguro intercepta a requisição e converte esses dados (PAN e CVV) em um token opaco (`card_token` ou `code`).

**Implementação via API Nexus:** No fluxo do `POST /financial/checkout` para operações do tipo `credit_card`, a API não aceita o número bruto do cartão. O parceiro precisa enviar o token providenciado pelo nosso serviço de tokenização dentro do campo `card_token` ou `card_code`. O sistema da Ticto se comunicará com o core de pagamentos para destokenizar o hash em ambiente PCI-Compliance e finalizar a autorização junto à adquirente.

<Tip>
  Passo a passo com o script, os parâmetros e os cartões de teste em [Tokenizar cartão](/guia/tokenizacao-cartao).
</Tip>


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