Exibir código-fonte para KYC - Tenure

=Know Your Costumer - Tenure=

<br>

===Descrição da API===

<br>

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. 

<br>

===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.

*S'''coring 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:

<br>

====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. 
<br>

<br>

Exemplo de '''Request body''':
<syntaxhighlight lang="json">
{
  "phoneNumber": "+34629255833", 
  "referenceDate": "2024-01-01"
}
</syntaxhighlight>
<br>

====Saídas====
Se bem-sucedido, retorna um objeto JSON com as seguintes informações:

*'''tenureDateCheck:''' verdadeiro quando a assinatura móvel identificada possui um período válido desde a tenureDate, falso caso contrário.

*'''contractType:''' tipo de contrato (ex.: PAYG - prepaid (pay-as-you-go) account, PAYM - contract account e Business), quando disponível.

<br>

*Exemplo de '''Response 200 OK''':
<syntaxhighlight lang="json">
{
  "tenureDateCheck": true,
  "contractType": "PAYM"
}
</syntaxhighlight>
<br>

===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.