Skip to main content
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.

KYC e onboarding (via Idwall)

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.
Recomendação: registre seu webhook no evento user_onboarded (veja 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.

Tokenização de cartões de crédito

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.
Passo a passo com o script, os parâmetros e os cartões de teste em Tokenizar cartão.