Confira a documentação técnica da API KYC Tenure
Detalhes da solução
- Versão da API: Know Your Customer Tenure 0.1.0
- Autor: TIM Brazil
Para outros detalhes, confira o Swagger da API.
Conheça as funcionalidades
Operações do Device Swap:
Match
Confirma se o cliente estava ativo na operadora na data desejada e informa o tipo de contrato (Pré, Pós ou Empresarial).
Descubra os retornos da API
Retornos de sucesso
- Status: 200
- tenureDateCheck: true
- contractType: 'PAYG' (pré pago)
- Status: 200
- tenureDateCheck: true
- contractType: 'PAYM' (pós pago/controle)
- Status: 200
- tenureDateCheck: true
- contractType: 'Business' (corporativo)
status: 200
tenureDateCheck: false
Retornos de erro
- Status: 400
- Code: INVALID_ARGUMENT
- Message: 'Client specified an invalid argument, request body or query param'
- Status: 400
- Code: OUT_OF_RANGE
- Message:‘Client specified an invalid range.'
- Status: 401
- Code: UNAUTHENTICATED
- Message: ‘Request not authenticated due to missing, invalid, or expired credentials’
- Status: 401
- Code: AUTHENTICATION_REQUIRED
- Message: ‘Request not authenticated due to missing, invalid, or expired credentials.’
- Status: 403
- Code: PERMISSION_DENIED
- Message: ‘Client does not have sufficient permissions to perform this action’
- Status: 404
- Code: IDENTIFIER_NOT_FOUND
- Message: ‘The phone number provided is not associated with a customer account’
- Status: 422
- Code: SERVICE_NOT_APPLICABLE
- Message: ‘The service is not applicable for the provided phone number’
- Status: 422
- Code: MISSING_IDENTIFIER
- Message: ‘No phone number has been provided’
- Status: 422
- Code: UNNECESSARY_IDENTIFIER
- Message: ‘An explicit phone number has been provided when one is already associated with the access token’
Download API Swagger