| (2 revisões intermediárias pelo mesmo usuário não estão sendo mostradas) | |||
| Linha 12: | Linha 12: | ||
===Casos de uso=== | ===Casos de uso=== | ||
*Onboarding digital e abertura de contas: valida a estabilidade do número informado, reduzindo riscos de fraudes em cadastros iniciais. | *'''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. | *'''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. | *'''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. | *'''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=== | ===Funcionalidade da API=== | ||
| Linha 28: | Linha 28: | ||
====POST /checkTenure==== | ====POST /checkTenure==== | ||
No corpo da requisição, são enviados: | No corpo da requisição, são enviados: | ||
'''*referenceDate:''' data referência em que se deseja saber se o número estava ativo. | *'''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> | ||
<br> | <br> | ||
Exemplo de '''Request body''': | |||
<syntaxhighlight lang="json"> | <syntaxhighlight lang="json"> | ||
{ | { | ||
| Linha 48: | Linha 49: | ||
Se bem-sucedido, retorna um objeto JSON com as seguintes informações: | 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. | *'''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. | *'''contractType:''' tipo de contrato (ex.: PAYG - prepaid (pay-as-you-go) account, PAYM - contract account e Business), quando disponível. | ||
<br> | <br> | ||
Edição atual tal como às 16h52min de 19 de setembro de 2025
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.
Exemplo de Request body: <syntaxhighlight lang="json"> {
"phoneNumber": "+34629255833", "referenceDate": "2024-01-01"
}
</syntaxhighlight>
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.
- Exemplo de Response 200 OK:
<syntaxhighlight lang="json"> {
"tenureDateCheck": true, "contractType": "PAYM"
}
</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.