KYC - Tenure

Know Your Costumer - Tenure

Descrição da API

A API “Know Your Customer Tenure” (KYC Tenure) permite verificar há quanto tempo um número de telefone está associado ao seu atual usuário na operadora móvel, fornecendo assim um indicador robusto de estabilidade e confiança da identidade móvel. O principal objetivo é aumentar o grau de confiança em processos KYC, combater fraudes e otimizar tomadas de decisão automatizadas, sem a necessidade de compartilhar dados sensíveis além do tempo de vínculo do usuário ao número.

Casos de uso

• Onboarding digital e abertura de contas: valida a estabilidade do número informado, reduzindo riscos de fraudes em cadastros iniciais.

• Análise e prevenção de fraudes: identifica tentativas de fraude que usam números recém ativados ou de curta duração.

• Scoring de crédito: avalia a confiabilidade do cliente usando a antiguidade do número como sinal de estabilidade.

• Serviços financeiros e seguros: aprimora a análise de risco em concessão de crédito e contratação de seguros.

• Enriquecimento de modelos de risco de identidade: incorpora a informação de tempo do vínculo do número para decisões automatizadas e mais precisas.

Funcionalidade da API

Esta API opera sobre o padrão CAMARA/Open Gateway e oferece um endpoint dedicado para verificação de tenure geralmente via request do tipo:

POST /checkTenure

No corpo da requisição, são enviados:

• phoneNumber: número do telefone do usuário a ser verificado.
• referenceDate: data referência em que se deseja saber se o número estava ativo.

Entradas

O corpo da solicitação do endpoint é um objeto JSON com os seguintes parâmetros:

• phoneNumber: O identificador de assinatura da rede (ou seja, o número de telefone do assinante).

• Exemplo de Request body:

<syntaxhighlight lang="json"> {

 pogpogpgo

} </syntaxhighlight>

Saídas

Se bem-sucedido, um objeto JSON será retornado contendo os seguintes dados:

• Exemplo de Response 200 OK:

<syntaxhighlight lang="json"> {

 pogpogpog

} </syntaxhighlight>

Considerações

A API prioriza a privacidade dos usuários, informando apenas se o critério de tempo de vínculo do número foi atendido, sem revelar dados sensíveis. Sua lógica é flexível, permitindo ajustar o tempo mínimo de associação que deve ser considerado adequado — por exemplo, sinalizando números com menos de 30 dias de uso. Além disso, sua padronização facilita a integração entre diferentes operadoras e sistemas ao redor do mundo, tornando a adoção global mais simples. Outra vantagem é a possibilidade de integrações diretas com soluções de KYC, detecção de troca de SIM card ou ferramentas antifraude, ampliando o valor no ecossistema digital.