Voltar

Como implementar o uso do token no Cartão Virtual

        31 de maio, 2022

Olá!

Neste artigo, você terá acesso às especificações de implementação para uso do token do Cartão Virtual, que é gerado no aplicativo Unimed Cliente. 

Esse token pode ser confrontado como forma de validar as informações do Cartão Virtual que é apresentado pelo beneficiário em substituição ao cartão físico. 

Vale lembrar que o usuário logado no aplicativo Unimed Cliente já teve seu cadastrado validado no PTU A1300. Caso a Unimed queira impedir o uso do Cartão Virtual, é necessário atualizar o PTU excluindo esse beneficiário imediatamente.

Desse modo, a validação via token é mais uma das ações de segurança para a Unimed e seu uso é opcional. 

 

1. Sistemas de gestão


O serviço que disponibilizará as informações do beneficiário que são geradas pelo token deve ser implementado seguindo as especificações apresentadas neste artigo. Vamos lá?

 

1.1. Integração e autenticação

  • A comunicação para a integração é realizada via serviço REST – JSON
  • A autenticação para acesso ao serviço deve ser realizada utilizando Usuário e Senha (basic authentication). A Estação Inova Portal irá fornecer o “Usuário” e “Senha”

                                     >> usuário: portalunimed
                                     >> senha: portal001

  • Utilize os seguintes endpoints, de acordo com o ambiente, para chamar o serviço de consulta do token:
    a. Homologação: https://api-preproducao.portalunimed.com.br/tokens/v1/consultatoken/
    b. Produção: https://api.unimed.coop.br/tokens/v1/consultatoken/
     

1.2. Regras para trocas de informações entre serviço do aplicativo e sistema de gestão da Unimed Federação/Singular

  • O encode na consulta do serviço deve ser "UTF-8"
  • Quando o serviço estiver indisponível, será retornado na requisição status 500
  • Nos parâmetros de entrada o serviço, devem-se utilizar os dados enviados por meio do body da requisição
  • Content-type da requisição deve ser application/json
  • Não utilizar o FormData para enviar os dados da requisição

 

1.2.1. Objeto token Cartão Virtual

  • Solicita dados do token gerado

 

1.2.2 Parâmetros de Entrada

Exemplo de requisição:
 



GET /tokens/v1/consultatoken/<tokenCartaoVirtual> HTTP/1.1

https://api-preproducao.portalunimed.com.br/tokens/v1/

Authorization: Basic cG9ydGFsdW5pbWVkOnBvcnRhbDAwMQ==

 

1.2.3 Retorno

 

 

Exemplo de retorno de token válido no Json:

{
"_id": "5ba1469d5bc8f2091959e63c", "nomeBene¿ciario":"João da Silva", "data":"2018/09/17 20:16:30-03", "cartao":"05000000000000001",
"tokenBene¿ciario": "A3S1WE44J9"
}

Exemplo de retorno de token expirado ou que não existe:
{
"Token expirado ou inexistente"
}


2. Regras de negócio


a) Quando o token pesquisado não existir ou já expirou, o retorno de Json será “Token expirado ou inexistente”.

b) Após 2 minutos do momento da geração do token, ele vai expirar em tela, mas pode ser consultado em até 10 minutos, qualquer tempo superior, e o retorno será “Token expirado ou inexistente”.

c) Quando o serviço de consulta estiver indisponível, será retornado na requisição status 500.


Espero ter ajudado! Até mais!

 

Ficou com outras dúvidas?

> Pesquise pelo que precisa aqui na Central de Ajuda, ou
> Abra um chamado para nossa equipe em: Canal do Colaborador > Aplicativos > GIU > Sistema de Gestão de Demandas > Abertura de Chamados > Sistemas e Aplicações