Utilizando o construtor de cartões virtuais
Construtor de cartões virtuais
ID: CONF-PAINEL-CARTAOVIRTUAL-001
Tags: cartaovirtual, cartaovirtual-visaogeral, cartaovirtual-requisitos, cartaovirtual-criandonovocartao, cartaovirtual-disponibilizandocartao, cartaovirtual-faq, cartaovirtual-transcricao
Requisitos
Para avançar nesta funcionalidade é obrigatório os métodos de Autenticação habilitados na sua plataforma:
Login
Primeiro acesso
Recuperar senha
Relogin
Uma imagem de cartão precisa respeitar as proporções indicadas pela aplicação (900 x 530 pixels);
Visão geral
O Construtor de Cartão Virtual é uma ferramenta inovadora desenvolvida pela Mobile Saúde para permitir a criação, personalização e gerenciamento de cartões virtuais de forma rápida, segura e eficiente. Projetado para atender às necessidades das Operadoras e seus beneficiários, o construtor oferece uma interface intuitiva que facilita a geração de cartões virtuais personalizados, com opções avançadas de configuração.
Com essa solução, é possível definir parâmetros como segmentação, abrangência, carências e muito mais, garantindo maior controle e autonomia nas parametrizações.
Ideal para Operadoras que buscam oferecer uma experiência moderna e segura aos seus beneficiários, o Construtor de Cartão Virtual é a escolha certa para quem deseja inovar no mercado de saúde digital, proporcionando flexibilidade, escalabilidade e conformidade com os mais altos padrões de segurança.
Processo de criação de um novo cartão
Para criar um novo cartão virtual:
Acesse a funcionalidade indo em: Ferramentaria > “Construtor de Cartão Virtual”;
Selecione a opção “Novo” para criar um novo modelo de cartão;
Na exibição de tela de “Novo modelo de cartão” é possivel:
Criar um novo modelo do zero neste caso deixando a opção:
“Criar modelo a partir de qual modelo”, com a opção “nenhum”;
Criar um novo modelo utilizando um já criado, indo na opção:
“Criar modelo a partir de qual modelo”, selecionando um cartão que já foi previamente criado “nenhum”;
Será solicitado agora que você efetue o login e senha de um beneficiário pois o cartão;
Atenção: O nome dos modelos de cartão devem ser iguais aos que são retornados nos arquivos de carga de beneficiários ou pelo web-service de integração.
Após entrar na funcionalidade de construtor de cartões virtuais:
Nas abas: Frente e verso insira a imagem no formato que é solicitado pela aplicação
Insira e posicione os componentes:
Texto fixo: Para necessidades de ter um componente fixo no cartão imutável como por exemplo “Nome”, “Data de nascimento”
Dados variáveis: Para que sejam posicionados nos locais onde o dado pode variár dependendo do beneficiário que estará logado acessando o cartão virtual.
Estrutura de JSON que pode ser utilizada para preencher os componente de dados variáveis, exemplo:
Para que um cartão virtual exiba a descrição do grau de parentesco selecione o caminho no componente varíavel: dadosDoPlano.grauParentesco.descricao que neste caso será exibido “Companheiro(a)";
Para que um cartão virtual exiba a descrição do CNS (Cartão Nacional de Saúde) selecione o caminho no componente varíavel: cartao.numeroCns que neste caso será exibido “910947674019880";
Para que um cartão virtual exiba a data de nascimento selecione o caminho no componente varíavel: dadosPessoais.dataNascimento que neste caso será exibido “Ranniêr Reis";
Para que um cartão virtual exiba a chave única do beneficiário logado selecione o caminho no componente varíavel: usuarioLogado.chaveUnica que neste caso será exibido “11111111111";
Para que um cartão virtual exiba uma opção que não existe na estrutura de autenticação padrão da Mobile Saúde, utilize o objeto “Custom” para retornar (como chave e valor) por exemplo “tipoSanguíneo” == “AB+”;
Posicione os componentes corretamente conforme o layout da Operadora
Clique em “Salvar” para que as alterações tenham efeito.
Importante: Para validar o cartão virtual na plataforma é necessário efetuar o logout e o login na plataforma.
Parâmetros do cartão virtual
Aba Dashboard: Onde é possível configurar os parametros:
nome - Nome de exibição da funcionalidade na Dashboard do App e Portal
corIcone - Define a cor do ícone que será exibido na Dashboard do App e Portal
corLabel - Define a cor do texto do nome da funcionalidade na Dashboard do App e Portal
escondeParaVisitante - Define se a funcionalidade deve ser exibida ou não para usuários que acessam com perfil Visitante. Visitante é o perfil do usuário que acessa o aplicativo sem se logar, True = Esconde a funcionalidade para o usuário do tipo Visitante, False = Exibe a funcionalidade para o usuário do time Visitante
loginObrigatorio - Define se é obrigatório realizar login para acessar esta funcionalidade, True = A aplicação irá exigir o login do usuário para acessar esta funcionalidade, False = A aplicação irá permitir acesso de usuários não logados.
icone - Define o ícone que será exibido para esta funcionalidade na Dashboard e TabBar do App e do Portal
funcionalidade_interna - Indica se a funcionalidade é do tipo interna enão será exibida na dashboard do beneficiario.
perfilUsuario - Define o perfil de usuário para injeção de dados na funcionalidade, injeção do parametro integracaoPerfil no acionamento das integrações, disponibilização de dados especificos do perfil no formulário, registro no perfil indica no registro de ocorrência.
Aba Parâmetros: Onde é possível configurar os parametros:
tituloErroCarregamento - Define o titulo de erro de carregamento de um cartão virtual - Valor padrão: Erro no carregamento
textoErroCarregamento - Define a mensagem de erro de carregamento do cartão virtual - Valor padrão: Desculpe, houve um erro no carregamento de seu cartão. Toque para carregar novamente ou reinicie o aplicativo
tituloErroCartaoNaoCadastrado - Define o titulo de erro cartão não cadastrado - valor padrao: Cartão não cadastrado
labelBotaoErroCartaoNaoCadastrado - Define a label do botão de erro de cartão não cadastrado.A ação do botão redireciona para funcionalidades de contatos - valor padrao: Fale conosco
labelBotaoErroCarregamento - Define o label do botão de erro de carregamento - valor padrao: Tentar novamente
cartaoVersoInformativoCooperativas - Define o texto informativo no verso do cartão referente a cooperativas - valor padrao: Eventuais alterações ocorridas na rede de prestadores poderão ser consultadas no www.unimed.coop.br e no tel. (99) 99876-1234
cartaoVersoInformativoANS - Define o texto informativo sobre a ANS presente no verso do cartão - valor padrao: Disque-ANS 0800 701 9656 www.ans.gov.br
cartaoVersoInformativoSACCooperativas - Define o numero do SAC presente no verso do cartão virtual - valor padrao:0800 123 456
corFundoTelaCartao - Define a cor do fundo da tela de exibição do cartão - valor padrao: #136055
corHeaderTelaCartao - Define a cor de fundo do header de navegação da tela de exibição do cartão - valor padrao: #00995D
textoOcorrencia - Define o texto do relato da ocorrência
idTipoOcorrencia - Define o tipo de ocorrência de auto-atendimento da funcionalidade
exibeCompartilhar - Define se o cartão virtual pode ou não ser compartilhado no Aplicativo, o compartilhamento gera uma imagem da frente e verso do cartão que pode ser compartilhada por qualquer outro app - valor padrao: false
textoErroCartaoNaoCadastrado - Define a mensagem de erro de cartão não cadastrado - valor padrao: Desculpe, seu cartão não está cadastrado. Entre em contato conosco que iremos resolver
tokenAlgoritmo - Define o algoritmo de encriptação, para geração do token. Podendo assumir os valores sha1, sha256 e sha512 - valor padrao: sha1
tokenDigitos - Define a quantidade de dígitos que o token poderá ter. Obrigatoriamente, é necessário ser de 6 a 8 dígitos - valor padrao: 8
tokenPeriodo - Define o período de validade do token. O tempo deve ser em segundos - valor padrao: 1800
corFundoQRCode - Define a cor de fundo de exibição do QRCODE - valor padrao: #A4C842
tituloTokenGeradoSucesso - Define o titulo da mensagem de token gerado com sucesso - valor padrao: Token gerado com sucesso!
mensagemTokenGeradoSucesso - Define a mensagem após gerar o token com sucesso - valor padrao: Apresente este token no atendimento
urlNTPServer - Define a url do servidor NTP para obter o horário da internet necessário para gerar o token do cartão - valor padrao: time.google.com
tituloAlertaSemConexao - Define o titulo do alerta de geração de token sem conexão com a internet - valor padrao: Sem Conexão
mensagemAlertaSemConexao - Define a mensagem de alerta de geração de token sem conexão com a internet - valor padrao: Por não existir conexão com a internet, o token foi calculado com base no horário do seu dispositivo. O token pode estar inválido caso seu horário esteja incorreto.
tipoEncondingSeed - Define o tipo de encoding do base32 usado no seedOpções válidas: ascii, base64, hex, latin1, utf8 - valor padrao: hex
tituloCarenciaVazia - Define o titulo da mensagem quando não há carências a cumprir - valor padrao: Sem carências
mensagemCarenciaVazia - Define a mensagem quando não há carências a cumprir - valor padrao: Seu contrato não possui carências a cumprir
utilizaToken - Define a utilização do token TOTP do cartão padrão - valor padrao: False
tempoLogTokenCartao - Define o tempo em dias em que o log do token do cartão deve permanecer na base de dados - valor padrao: 30
cartaoUnimedWebAlerta - Texto alerta para abertura do cartão virtual na Web, este parâmetro define a mensagem exibida no alerta, já que ainda não existe o Cartão virtual web - valor padrao: Para acessar o seu cartão Unimed, utilize o App
exibeQRCodeCartaoUnimed - Define a exibição do QRCode do cartão Unmimed - valor padrao: true
Aba Embutir: Onde é possível configurar os parametros:
Para incorporar uma funcionalidade da Plataforma do Beneficiário web no seu site ou área restrita do beneficiário, utilize o script disponibilizado. Basta utilizar o SDK responsável por instanciar e carregar a funcionalidade, definir um elemento no DOM como container para exibição e o script de carregamento da funcionalidade. Antes de utilizar a funcionalidade certifique-se que você possui uma origem cadastrada em Configurações > Segurança > Domínios e IPs de Origem, já que a funcionalidade só pode ser executada dentro de uma origem cadastrada.
Funcionalidades que dependem da integração de login precisam receber como parâmetro o TOKEN de identificação do beneficiário obtido no momento do login, consulte nossa documentação para mais informações.
Além do script disponibilizado, o SDK conta ainda com eventos avançados que podem ser utilizado por sua aplicação:
Exemplo de código para ser embedado que é disponibilizado na aba embutir:
Disponibilizando seu cartão virtual nos Apps, Portal do beneficiário ou Embutindo no seu site
Para disponibilizar o cartão virtual nos Apps e no Portal do beneficiário:
Acesse o configurador público > Funcionalidades > Configurador de Funcionalidades > Sandbox (editar), na aba “Meus Serviços” selecione a opção do cartão virtual.
Realize todas as parametrizações que achar necessárias como exposto: nome, icone e etc.
E mova a funcionalidade para “Funcionalidades Ativas”
Vá até “Sincronizar com App” e acesse seu app para verificar as alterações
Para disponibilizar o cartão virtual no seu site:
Acesse o configurador público > Funcionalidades > Configurador de Funcionalidades > Sandbox (editar), na aba “Meus Serviços” selecione a opção do cartão virtual.
Realize todas as parametrizações que achar necessárias como exposto: nome, icone e etc.
Capture todo o cógido que está sendo exibido na aba “Embutir”, lembre-se de cadastrar a origem.
A funcionalidade de cartão virtual estará disponibilizada no seu site.
Resolução de problemas e dúvidas em geral
Dúvida-1: Como configurar outro cartão virtual (multi-cartões)?
Solução: Para que outros cartões sejam apresentados corretamente é necessário configurar mais deum contrato para cada beneficiário, é preciso que retorne um “modeloCartao” diferente para cada contrato da estrutura de login do beneficiário.
Exemplo: O contrato 1 está recebendo o “modeloCartao” modelo01 já o contrato 2 precisará ser configurado para receber o “modeloCartao” modelo02
Atenção*: Mesmo que o layout de cartão seja igual para ambos os contratos, será preciso retornar do Web-service um “modeloCartao” diferente configurado no Construtor de Cartão Virtual, conforme ensinado no “Processo de criação de um novo cartão”.
Atenção**: O nome dos modelos de cartão devem ser iguais aos que são retornados nos arquivos de carga de beneficiários ou pelo web-service de integração.
Dúvida-2: Como configurar TOTP?
O TOTP é um método de autenticação baseado no tempo que fornece uma camada adicional de segurança, garantindo que cada beneficiário tenha um token único para acessar suas informações.
A funcionalidade de Token TOTP oferecida pela Mobile Saúde é uma medida eficaz para aumentar a segurança na autenticação de beneficiários. Certifique-se de seguir os procedimentos recomendados para gerar o SEED e o Token TOTP de forma adequada.
Para saber mais clique aqui para este ler este artigo na web.
Solução: O Token TOTP é gerado utilizando a fórmula especificada na RFC6238, seguindo os seguintes parâmetros:
SEED: O SEED único de cada beneficiário deve ser fornecido no webservice de login.
tokenAlgoritmo: Define o algoritmo de criptografia para gerar o token. Podendo assumir os valores sha1, sha256 e sha512.
tokenDigitos: Define a quantidade de dígitos que o token terá, variando de 6 a 8 dígitos.
tokenPeriodo: Define o período de validade do token, especificado em segundos.
tipoEncondingSeed: Define o tipo de codificação do SEED usado, com opções válidas, como ascii, base64, hex, latin1 e utf8.
Atenção*: A Mobile Saúde recomenda que o tipoEncodingSeed seja o hex, que é um “padrão” de mercado. Ao modificar este parâmetro, tenha certeza do que está fazendo.
Atenção**: Todos os parâmetros entre as plataformas da Mobile Saúde e da Operadora precisam necessáriamente estarem IGUAIS, caso contrário resultará em gerações de Token diferentes entre as plataformas mesmo sendo geradas ao mesmo tempo, revise todos os parametros.
Problema-1: Ao acessar cartão virtual, alguns beneficiários não são exibidos.
Solução*: Acesse a funcionalidade de validador de integração e simule um login com o usuário/senha que está com problemas.
Verifique se o validador detecta alguma inconsistência (erro). Se o login for rejeitado, corrija o problema detectado e tente novamente.
Solução**: Acesse a central de logs e localize o evento de login do beneficiário.
Verifique se o beneficiário que está faltando está sendo listado no array de beneficiários. Caso não esteja, verifique o porque em sua API. Corrija sua API, valide-a novamente no validador de integração e uma vez validado, verifique se o app exibiu o cartão.
Solução***: Acesse a central de logs e localize o evento de login do beneficiário.
Verifique se o beneficiário que está faltando está com o atributo apresentaCartaoVirtual está com conteúdo true. Se não estiver, corrija sua API, valide-a novamente no validador de integração e uma vez validado, verifique se o app exibiu o cartão.
Solução****: Acesse a central de logs e localize o evento de Acesso a funcionalidade referente ao método de login do beneficiário ou acesso ao cartão.
Verifique se o beneficiário em questão possui direitos de visualizar seu cartão conforme documentação dessa API. Se não possuir estiver, corrija sua API, valide-a novamente no validador de integração e uma vez validado, verifique se o app exibiu o cartão.
Transcrição de um treinamento prático
metadados
título: Cartão virtual
id: CONF-PAINEL-CARTAOVIRTUAL-001
categoria: Painel Público
subcategoria: Construtor de cartão virtual
tags: [cartaovirtual, cartaovirtual-visaogeral, cartaovirtual-requisitos, cartaovirtual-criandonovocartao, cartaovirtual-disponibilizandocartao, cartaovirtual-faq, cartaovirtual-transcricao]
relacionados: []
última_atualização: 2025-01-31
Related content
Mobile Saúde - Mosia Omnichannel