Visa Spoke
Integre a instância ServiceNow® ao spoke do Visa para invocar continuamente as APIs do Visa no Visa Resolve Online (VROL) para o processo de contestação de cartão Visa. Você pode usar o spoke para pesquisar transações, colaborar com comerciantes, gerenciar contestações e executar outras funções com segurança aprimorada.
Assinatura do IntegrationHub
Este spoke requer uma assinatura do Hub de integração. Para obter mais informações, consulte Programações jurídicas - Visão geral do IntegrationHub.
Versão do spoke
O Visa spoke v1.0.0 é a versão mais recente.
Principais recursos
O recurso inclui a criação de ações para invocar APIs Visa por meio do VROL (Visa Resolve Online) para gerenciar o processo de contestação de cartão de ponta a ponta. Isso inclui tarefas como:
- Recuperar informações aprimoradas da transação
- Executar pesquisas de transação
- Iniciar a criação de casos de contestação
- Enviar questionário de visto
- Iniciar pré-arbitragem e arbitragem em casos de contestação existentes
Requisitos do spoke
Assinatura do IntegrationHub
Dependências do spoke
Certifique-se de que estes plug-ins dependentes estejam instalados:
- ServiceNow IntegrationHub Tempo de execução (com.glide.hub.integration.runtime)
- ServiceNow IntegrationHub Etapa de ação - REST (com.glide.hub.action_step.rest)
Nota:
Alguns desses plug-ins são recursos licenciáveis e exigem licenças apropriadas, se usados fora da implementação do spoke.
Ações do spoke
O spoke Visa fornece ações para invocar APIs Visa no VROL (Visa Resolve Online) para gerenciar todo o processo de contestação de cartão. As ações disponíveis incluem:
- Ações com informações confidenciais - Essas ações contêm informações confidenciais no corpo da solicitação e da resposta. É recomendável usar uma solução de tokenização ao invocar essas APIs VROL.Importante:É altamente recomendável desabilitar os logs de execução de fluxo para APIs Visa que contenham dados de informações de identificação pessoal (PII). Para fazer isso, você precisa definir a propriedade com.snc.process_flow.reporting.level em Propriedades do sistema como DESLIGADO.
Tabela 1. Ações com informações confidenciais Categoria Ação Descrição Gestão digital de informação de pedidos Construtor de solicitação de consulta de compra do titular do cartão Produz a carga de solicitação para CardholderPurchaseInquiry. Esta API fornece aos usuários da Interface de sistemas em tempo real (RTSI) a capacidade de solicitar informações adicionais do comerciante sobre uma transação. Também pode ser usado para recuperar informações de compra para transações que não sejam da VisaNet. Analisador de resposta de consulta de compra do titular do cartão Analisa a resposta de CardholderPurchaseInquiry. Esta API fornece aos usuários da Interface de sistemas em tempo real (RTSI) a capacidade de solicitar informações adicionais do comerciante sobre uma transação. Também pode ser usado para recuperar informações de compra para transações que não sejam da VisaNet. Gestão de consultas sobre transações Consultar construtor de solicitação de detalhes de todas as transações Permite que os usuários recuperem detalhes de todos os relatórios programados para a organização do usuário ou para um relatório específico que o usuário deseje saber. Pesquisar analisador de resposta de detalhes de todas as transações Analisa a resposta de getAllTransDetails. Os emissores podem usar esta API como método alternativo para recuperar detalhes completos da transação usando de 1 a 10 IDs de transação da VisaNet como parâmetros de pesquisa. Consultar detalhes da transação do construtor de solicitação de caso Produz a carga de solicitação para getTransactionsFromCase. Os emissores podem usar esta API para obter os detalhes de TI da transação "selecionada" no caso. ou seja, a transação original que está sendo contestada. Além disso, ele retorna resumos das transações "selecionadas" e "não selecionadas" retornadas da pesquisa de TI que também são armazenadas com o caso. Consultar detalhes da transação do analisador de resposta de caso Analisa a resposta de getTransactionsFromCase. Os emissores podem usar esta API para obter os detalhes de TI da transação "selecionada" no caso. ou seja, a transação original que está sendo contestada. Além disso, ele retorna resumos das transações "selecionadas" e "não selecionadas" retornadas da pesquisa de TI que também são armazenadas com o caso. Consultar detalhes da transação do construtor de solicitação Produz a carga de solicitação para getTransDetails. Os emissores podem usar esta API para obter dados em nível de detalhe para a transação retornada. Consultar analisador de resposta de detalhes da transação Analisa a resposta de getTransDetails. Os emissores podem usar esta API para obter dados em nível de detalhe para a transação retornada. Consultar construtor de solicitação de resultados de consulta de transação Produz a carga de solicitação para getTransInquiryResults. Isso aceitará um ID de evento de consulta de transação (TI) e retornará informações de resumo da transação. Consultar analisador de resposta dos resultados da consulta de transação Analisa a resposta de getTransInquiryResults. Isso aceitará um ID de evento de consulta de transação (TI) e retornará informações de resumo da transação. Enviar construtor de solicitação de consulta de transação múltipla Produz a carga de solicitação para submitMultiTranInquiry. Isso fornecerá um método alternativo para pesquisar transações usando de 1 a 10 IDs de transação da VisaNet como parâmetros de pesquisa. Enviar analisador de resposta de consulta de transação múltipla Analisa a resposta de submitMultiTranInquiry. Isso fornecerá um método alternativo para pesquisar transações usando de 1 a 10 IDs de transação da VisaNet como parâmetros de pesquisa. Enviar construtor de solicitação de consulta de transação Produz a carga de solicitação para submitTranInquiry. Esta ação será usada para pesquisar transações usando um conjunto de critérios de pesquisa. Enviar analisador de resposta de consulta de transação Produz a carga de solicitação para submitTranInquiry. Esta ação será usada para pesquisar transações usando um conjunto de critérios de pesquisa. Gestão de relatórios de fraude Enviar construtor de solicitação de relatório de fraude Produz a carga de solicitação para SubmitFraudReport. Esta API permite que um usuário envie um relatório de fraude para o Visa Resolve Online (VROL), incluindo todos os dados de fraude necessários, conforme listado na Planilha de elemento de interface (IES). Enviar analisador de resposta de relatório de fraude Analisa a resposta para SubmitFraudReport. Esta API permite que um usuário envie um relatório de fraude para o Visa Resolve Online (VROL), incluindo todos os dados de fraude necessários, conforme listado na Planilha de elemento de interface (IES). Pesquisar construtor de solicitação de detalhes do pedido de contestação Esta ação cria a carga de entrada para a API getDisputeFiling Details. Pesquisar analisador de resposta de detalhes do pedido de contestação Analisa a resposta de getDisputeFilingDetails. O getDisputeFilingDetails é usado para recuperar a mensagem com o arquivamento de caso de contestação e os detalhes da imagem junto com o tipo de item de arquivamento de contestação. Pesquisar construtor de solicitação de detalhes do relatório de fraude Permite que os usuários solicitem informações adicionais em tempo real sobre um relatório de fraude enviado anteriormente. Pesquisar analisador de resposta de detalhes de relatório de fraude Esta ação analisa o corpo da resposta retornado pelo sistema VROL após chamar a API para obter detalhes do relatório de fraude. Gestão financeira de contestação Consultar construtor de solicitação de detalhes de consultoria financeira da contestação Produz a carga de solicitação para a API GetDisputeFinancialAdviceDetails. Ele permite que os usuários da Interface de sistemas em tempo real (RTSI) solicitem os dados de aconselhamento financeiro da contestação. Pesquisar analisador de resposta de detalhes de aconselhamento financeiro de contestação Analisa a resposta da API GetDisputeFinancialAdviceDetails. Ele permite que os usuários da Interface de sistemas em tempo real (RTSI) solicitem os dados de aconselhamento financeiro da contestação. Consultar construtor de solicitação de detalhes financeiros de contestação Produz a carga de solicitação para a API GetDisputeFinancialDetails. Esta API recupera detalhes financeiros da contestação em um caso para o adquirente ou emissor. Consultar analisador de resposta de detalhes financeiros da contestação Analisa a resposta da API GetDisputeFinancialDetails. Esta API recupera detalhes financeiros da contestação em um caso para o adquirente ou emissor. Gestão de casos Enviar construtor de solicitação de criação de caso manual Analisa a resposta para SubmitFraudReport. Esta API permite que um usuário envie um relatório de fraude para o Visa Resolve Online (VROL), incluindo todos os dados de fraude necessários, conforme listado na Planilha de elemento de interface (IES). Enviar analisador de resposta de criação de caso manual Produz a carga de solicitação para a API SubmitManualCaseCreation. Ele permite que um usuário crie um caso sem transações. Consultar construtor de solicitação de detalhes de caso Produz a carga de solicitação para GetCaseDetails. Esta API permite que um usuário solicite detalhes de um caso VROL específico, incluindo informações de transação, jurisdição de contestação, tipo de caso e outros campos relacionados ao caso, ao fornecer o VisaCaseNumber e o MemberRole. As informações retornadas na resposta dependem da função do usuário que faz a solicitação e do estágio e estado em que o caso está Consultar analisador de resposta de detalhes de caso Analisa a resposta para GetCaseDetails. Esta API permite que um usuário solicite detalhes de um caso VROL específico, incluindo informações de transação, jurisdição de contestação, tipo de caso e outros campos relacionados ao caso, ao fornecer o VisaCaseNumber e o MemberRole. As informações retornadas na resposta dependem da função do usuário que faz a solicitação e do estágio e estado em que o caso está. Gestão de questionário Consultar criador de solicitação de detalhes da notificação de aceitação Produz a carga de solicitação para GetAcceptanceNotificationDetails. Esta API fornece aos usuários da Interface de sistemas em tempo real (RTSI) a capacidade de recuperar os detalhes da notificação de aceitação para contestações ou respostas de contestação que foram aceitas e encerradas. Consultar analisador de resposta de detalhes da notificação de aceitação Analisa a resposta de GetAcceptanceNotificationDetails. Esta API fornece aos usuários da Interface de sistemas em tempo real (RTSI) a capacidade de recuperar os detalhes da notificação de aceitação para contestações ou respostas de contestação que foram aceitas e encerradas. Consultar construtor de solicitação de detalhes de contestação Produz a carga de solicitação para getDisputeDetails. Os emissores podem usar essa API para solicitar que os dados do questionário de contestação sejam retornados em formato de imagem, bem como em XML. Consultar analisador de resposta de detalhes de contestação Analisa a resposta de getDisputeDetails. Os emissores podem usar essa API para solicitar que os dados do questionário de contestação sejam retornados em formato de imagem, bem como em XML. Consultar construtor de solicitação de detalhes de resposta de contestação Produz a carga de solicitação para GetDisputePreArbResponseDetails. Esta API permite que os usuários da Interface de sistemas em tempo real (RTSI) solicitem que os dados do questionário de resposta pré-arbitragem sejam retornados em formato de imagem, bem como em XML Consultar analisador de resposta de detalhes da resposta da contestação Produz a carga de solicitação para GetDisputePreArbResponseDetails. Esta API permite que os usuários da Interface de sistemas em tempo real (RTSI) solicitem que os dados do questionário de resposta pré-arbitragem sejam retornados em formato de imagem, bem como em XML. Gestão de filas Pesquisar construtor de solicitação de fila Produz a carga de solicitação para a API GetQueue. Esta API obtém informações sobre qualquer fila especificada durante o ciclo de vida da contestação, como fila de colaboração de entrada e formulários de contestação rejeitados. Pesquisar analisador de resposta da fila Analisa a resposta da API GetQueue. Esta API obtém informações sobre qualquer fila especificada durante o ciclo de vida da contestação, como fila de colaboração de entrada e formulários de contestação rejeitados. Gestão de abertura de casos Consultar construtor de solicitação de detalhes da mensagem de contestação Produz a carga de solicitação para GetContactMessageDetails. Esta API fornece aos usuários da Interface de sistemas em tempo real (RTSI) a capacidade de solicitar que os dados do questionário da mensagem de contato sejam retornados em formato de imagem, bem como em XML. Consultar analisador de resposta dos detalhes da mensagem de contestação Analisa a resposta de GetContactMessageDetails. Esta API fornece aos usuários da Interface de sistemas em tempo real (RTSI) a capacidade de solicitar que os dados do questionário da mensagem de contato sejam retornados em formato de imagem, bem como em XML. A imagem retornada estará no formato TIFF ou PDF. Para recuperar a contestação como uma imagem, o usuário deve definir<IncludeDisputeAsImageInd> = verdadeiro. Consultar construtor de solicitação de detalhes da resposta da mensagem de contestação Produz a carga de solicitação para getContactMessageResponseDetails. Esta ação permite que os usuários da Interface de sistemas em tempo real (RTSI) recuperem os detalhes de uma resposta de mensagem de contato. Pesquisar analisador de resposta dos detalhes da resposta da mensagem de contestação Analisa a resposta de getContactMessageResponseDetails. Esta ação permite que os usuários da Interface de sistemas em tempo real (RTSI) recuperem os detalhes de uma resposta de mensagem de contato. Gestão de solicitações de hiperpesquisa Construtor de solicitação de HyperSearch Produz a carga de solicitação para o HyperSearch. Esta API aceita parâmetros de correspondência de caso e retorna informações sobre todos os casos encontrados. Analisador de resposta de HyperSearch Analisa a resposta do HyperSearch. Esta API aceita parâmetros de correspondência de caso e retorna informações sobre todos os casos encontrados. Gestão de filas de lote Pesquisar construtor de solicitação da fila de lote Produz a carga de solicitação para a API GetBatchQueue. Esta API recupera transações da fila de lote RTSI fornecida. Pesquisar analisador de resposta da fila em lote Analisa a resposta da API GetBatchQueue. Esta API recupera transações da fila de lote RTSI fornecida. Gestão de filas de lote Pesquisar construtor de solicitação da fila de lote Produz a carga de solicitação para a API GetBatchQueue. Esta API recupera transações da fila de lote RTSI fornecida. Pesquisar analisador de resposta da fila em lote Analisa a resposta da API GetBatchQueue. Esta API recupera transações da fila de lote RTSI fornecida. Gestão pré-arbitragem de contestação Pesquisar construtor de solicitação de detalhes da resposta pré-arbitragem de contestação Analisa a resposta para GetDisputePreArbResponseDetails. Esta API permite que os usuários da Interface de sistemas em tempo real (RTSI) solicitem que os dados do questionário de resposta pré-arbitragem sejam retornados em formato de imagem, bem como em XML. A imagem retornada estará no formato TIFF ou PDF. Para recuperar a contestação como uma imagem, o usuário deve definir<IncludeDisputeAsImageInd> = verdadeiro. Os dados da imagem serão retornados no grupo <Image> em SIGetDisputePreArbResponseDetailsResponse Pesquisar analisador da resposta de detalhes da resposta pré-arbitragem de contestação Produz a carga de solicitação para GetDisputePreArbResponseDetails. Esta API permite que os usuários da Interface de sistemas em tempo real (RTSI) solicitem que os dados do questionário de resposta pré-arbitragem sejam retornados em formato de imagem, bem como em XML. Consultar construtor de solicitação de detalhes de pré-arbitragem de contestação Produz a carga de solicitação para a API GetDisputePreArbDetails. Para solicitar que os dados do questionário pré-arbitragem sejam retornados em formato de imagem, bem como em XML Consultar analisador de resposta de detalhes da pré-arbitragem da contestação Analisa a resposta da API GetDisputePreArbDetails. Para solicitar que os dados do questionário de pré-arbitragem sejam retornados em formato de imagem, bem como em XML. Gestão de listas de arquivo de exceção Consultar construtor de solicitação de exceção de consulta Esta ação cria a carga da solicitação para a API que faz a consulta sobre a exceção. Pesquisar analisador de resposta de exceção de consulta Esta ação analisa o corpo da resposta retornado pelo sistema VROL após chamar a API Pesquisar exceção de consulta. Pesquisar construtor de solicitação de detalhes da exceção Esta ação cria a carga da solicitação para a API getExceptionDetails. Pesquisar analisador de resposta de detalhes da exceção Esta ação analisa o corpo da resposta retornado pelo sistema VROL após chamar a API getExceptionDetails. Enviar construtor de solicitação de exceção Produz a carga de solicitação para submitException. Os emissores podem usar submitExceptionRequest para adicionar, atualizar ou excluir uma lista de arquivos de exceção de um caso novo ou existente. Também é usado para reparar uma lista de arquivos de exceção rejeitada. Enviar analisador de resposta de exceção Analisa a resposta de submitException. Os emissores podem usar submitExceptionRequest para adicionar, atualizar ou excluir uma lista de arquivos de exceção de um caso novo ou existente. Também é usado para reparar uma lista de arquivos de exceção rejeitada. Gestão de taxas diversas Consultar construtor de solicitação de detalhes de taxa diversa Produz a carga de solicitação para getMiscFeeDetails. GetMiscFeeDetailsRequest permite que os clientes solicitem detalhes para uma taxa diversa. Consultar analisador de resposta de detalhes da taxa diversa Analisa a resposta de getMiscFeeDetailsRequest. GetMiscFeeDetailsRequest permite que os clientes solicitem detalhes para uma taxa diversa. Enviar construtor de solicitação de taxa diversa Produz a carga de solicitação para a API SubmitMiscFee. Ele permite que os clientes solicitem uma taxa diversa com dados. Enviar analisador de resposta de taxa diversa Analisa a resposta da API SubmitMiscFee. Ele permite que os clientes solicitem uma taxa diversa com dados. Gestão de programas de monitoramento de fraudes Pesquisar construtor de solicitação de detalhes do GMFP Esta ação cria a carga da solicitação para a API GetGMFPDetails Pesquisar analisador de resposta de detalhes de GMFP Esta ação analisa o corpo da resposta retornado pelo sistema VROL após chamar a API Detalhes do GMFP. - Ações com informações não confidenciais - Você pode invocar diretamente essas APIs Visa da sua instância ServiceNow.
Tabela 2. Ações com informações não confidenciais Categoria Ação Descrição Gestão financeira de contestação Iniciar contestação com base em transação ou caso Permite que os usuários iniciem uma contestação com base em transação ou caso. Mudar de status da disputa Analisa a resposta de CardholderPurchaseInquiry. Esta API fornece aos usuários da Interface de sistemas em tempo real (RTSI) a capacidade de solicitar informações adicionais do comerciante sobre uma transação. Também pode ser usado para recuperar informações de compra para transações que não sejam da VisaNet Gestão de casos Pesquisar imagem Recupera uma imagem adicionada a um caso recém-criado. Carregar imagem UploadImage é usado para adicionar uma imagem a um caso. Atualizar status de resolução do caso Permite que um usuário atualize o status de resolução de um caso. Isso pode encerrar o caso, dependendo da mudança de status feita Criar caso a partir de transação Os emissores usam essa API para criar um caso a partir de uma solicitação de consulta de transação. Gestão de questionário Enviar questionário de contestação Esta ação permite que os usuários da Interface de sistemas em tempo real (RTSI) enviem ou salvem o questionário de contestação. Pesquisar status do questionário de contestação de pacote de fraudes Fornece aos usuários da Interface de sistemas em tempo real (RTSI) a capacidade de recuperar detalhes de uma contestação de pacote de fraude enviada. Enviar questionário de contestação de pacote de fraudes Fornece aos usuários da Interface de sistemas em tempo real (RTSI) a capacidade de enviar ou salvar o questionário de contestação de pacote de fraudes. Esta solicitação pode incluir imagens. Gestão de filas de lote Marcar item da fila de lote como lido Marca transações como lidas para removê-las da fila de lotes da interface de sistemas em tempo real (RTSI). Gestão de filas Ignorar GMFP Permite que o emissor altere o status da transação do VFMP para “Ignorada”, enviando uma solicitação usando o GMFPItemID, depois que ele revisar cada transação do Visa Fraud Monitoring Program (VFMP) na fila. Fechar taxa diversa Fornece a funcionalidade para remover transações de taxa diversas. Fechar mensagem Fornece a funcionalidade para remover transações de mensagem de solicitação de prova de publicação (RPP). Gestão de consultas sobre transações Fechar transação Esta ação é usada para fechar determinadas transações e removê-las de suas respectivas filas. Selecionar transações associadas AssociatedTransSelection permite que os usuários confirmem ou refutem as associações de algumas ou de todas as transações associadas em um grupo a uma transação selecionada em um caso. Consultar lista de transações associadas Permite que os usuários recuperem uma lista de transações associadas fornecendo o ID do grupo de transações associadas. Pesquisar seleção de transação associada Permite que os usuários confirmem ou refutem as associações de algumas ou de todas as transações associadas em um grupo a uma transação selecionada em um caso. Gestão pré-arbitragem de contestação Criar pré-arbitragem da disputa Inicia a criação de uma pré-arbitragem usando esta API. Criar resposta à pré-arbitragem da disputa Fornece aos usuários da Interface de sistemas em tempo real (RTSI) a capacidade de responder a uma pré-arbitragem. Gestão de abertura de casos Enviar resposta da mensagem do contato SubmitContactMessageResponse permite que os usuários da Interface de sistemas em tempo real (RTSI) enviem uma resposta a uma mensagem de contato. Enviar registro de contestação Envie uma solicitação de registro de caso de contestação, retirada ou recurso. Gestão de distribuição de relatório Pesquisar saída de relatório Permite que os usuários recuperem o relatório de uma data de execução específica no formato CSV. Consultar programação ativa Permite que os usuários recuperem detalhes de todos os relatórios programados para a organização do usuário ou para um relatório específico que o usuário deseje saber. Gestão de filas de lote Marcar item da fila de lote como lido Marca transações como lidas para removê-las da fila de lotes da interface de sistemas em tempo real (RTSI).
Requisitos de aliases de conexão e credencial
IntegrationHub O usa aliases para gerenciar informações de conexão e de credencial e credenciais de OAuth. O uso de um alias elimina a necessidade de configurar várias credenciais e perfis de informações de conexão ao usar vários ambientes. Se as informações de conexão ou de credencial forem alteradas, não será necessário atualizar nenhuma ação que use a conexão.
Para obter mais informações sobre como configurar o spoke, consulte Configurar Spoke Visa..