Spoke do Visa

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 17 min. de leitura
  • Integrar o. ServiceNow instância com Spoke do Visa Invocar perfeitamente APIs Visa no Visa Resolve Online (VROL) para o processo de contestação do 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 Cronogramas jurídicos - Visão geral do IntegrationHub.

    Versão do spoke

    Visto spoke v 1.2.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:
    • Recupere informações de transação aprimoradas
    • 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 litígio 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

    . Spoke do 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. Você deve usar uma solução de tokenização ao invocar essas APIs do VROL.
      Importante:
      Você deve desabilitar os logs de execução de fluxo para APIs Visa que contêm dados de informações de identificação pessoal (PII). Para fazer isso, defina a propriedade com.snc.process_flow.reporting.level Em Propriedades do sistema para 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 carga de solicitação para CardholderPurchaseQuery. 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. Ele também pode ser usado para recuperar informações de compra de transações não VisaNet.
      Analisador de resposta de consulta de compra do titular do cartão Analisa a resposta de CardholderPurchaseQuery. 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. Ele também pode ser usado para recuperar informações de compra de transações não 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 agendados 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 um método alternativo para recuperar detalhes completos da transação para transações usando 1 a 10 IDs de transação VisaNet como parâmetros de pesquisa.
      Consultar detalhes da transação do construtor de solicitação de caso Produz 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 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 paylod de solicitação para getTransInquiryResults. 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. 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 paylod de solicitação para o envio MultiTranInquiry. Isso fornecerá um método alternativo para pesquisar transações usando de 1 a 10 IDs de transação VisaNet como parâmetros de pesquisa.
      Enviar analisador de resposta de consulta de transação múltipla Analisa a resposta do submitMultiTranInquiry. Isso fornecerá um método alternativo para pesquisar transações usando de 1 a 10 IDs de transação VisaNet como parâmetros de pesquisa.
      Enviar construtor de solicitação de consulta de transação Produz carga de solicitação para o envio TranInquiry. 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 paylod de solicitação para o envio TranInquiry. 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 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 listados na planilha de elemento de interface (IES).
      Enviar analisador de resposta de relatório de fraude Analisa a resposta do 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 listados 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 disputa Analisa a resposta de getDisputeFilingDetails. GetDisputeFilingDetails é usado para recuperar a mensagem com o arquivamento do 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 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 de 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 de contestação.
      Consultar construtor de solicitação de detalhes financeiros de contestação Produz carga de solicitação para a API GetDisputeFinancialDetails. Esta api recupera detalhes financeiros de contestação em um caso para adquirente ou emissor.
      Consultar analisador de resposta de detalhes financeiros da contestação Analisa a resposta da API GetDisputeFinancialDetails. Esta API recupera detalhes financeiros de contestação em um caso para adquirente ou emissor.
      Gestão de casos Enviar construtor de solicitação de criação de caso manual Analisa a resposta do 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 listados na planilha de elemento de interface (IES).
      Enviar analisador de resposta de criação de caso manual Produz 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 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 VisaCaseNumber e MemberRole. As informações retornadas na resposta dependem da função do usuário que faz a solicitação e em qual fase e estado o caso está atualmente
      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 VisaCaseNumber e MemberRole. As informações retornadas na resposta dependem da função do usuário que faz a solicitação e em qual fase e estado o caso está atualmente.
      Gestão de questionário Consultar criador de solicitação de detalhes da notificação de aceitação Produz 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ções 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ções que foram aceitas e encerradas.
      Consultar construtor de solicitação de detalhes de contestação Produz carga de solicitação para getDisputeDetails. Os emissores podem usar esta 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 esta 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 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 de pré-arbitragem sejam retornados em formato de imagem, bem como em XML
      Consultar analisador de resposta de detalhes da resposta da contestação Produz 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 de pré-arbitragem sejam retornados em formato de imagem, bem como em XML.
      Gestão de filas Pesquisar construtor de solicitação de fila Produz 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 rejeitada.
      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 rejeitada.
      Gestão de abertura de casos Consultar construtor de solicitação de detalhes da mensagem de contestação Produz 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 "verdadeiro" como "verdadeiro" (<IncludeDisputeAsImageInd>).
      Consultar construtor de solicitação de detalhes da resposta da mensagem de contestação Produz paylod 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 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 carga de solicitação para a API GetBatchQueue. Esta API recupera transações da fila em lote RTSI fornecida.
      Pesquisar analisador de resposta da fila em lote Analisa a resposta da API GetBatchQueue. Esta API recupera transações da fila em lote RTSI fornecida.
      Gestão de filas de lote Pesquisar construtor de solicitação da fila de lote Produz carga de solicitação para a API GetBatchQueue. Esta API recupera transações da fila em lote RTSI fornecida.
      Pesquisar analisador de resposta da fila em lote Analisa a resposta da API GetBatchQueue. Esta API recupera transações da fila em 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 de 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 "verdadeiro" como "verdadeiro" (<IncludeDisputeAsImageInd>). Os dados da imagem serão retornados no <Image>Grupo em SIGetDisputePreArbResponseDetalhsResponse
      Pesquisar analisador da resposta de detalhes da resposta pré-arbitragem de contestação Produz 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 de 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 carga de solicitação para a API GetDisputePreArbDetails. Solicitar que os dados do questionário de 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. 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 Pesquisar construtor de solicitação de exceção de consulta Essa ação cria a carga de solicitação para a API que pergunta sobre a exceção.
      Pesquisar analisador de resposta de exceção de consulta Esta ação analisa o retorno do corpo da resposta pelo sistema VROL após chamar a exceção de consulta de pesquisa de API.
      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 paylod de solicitação para o submitException. Os emissores podem usar o submitExceptionRequest para adicionar, atualizar ou excluir uma listagem de arquivos de exceção de um caso novo ou existente. Também é usado para reparar uma listagem de arquivos de exceção rejeitada.
      Enviar analisador de resposta de exceção Analisa a resposta do submitException. Os emissores podem usar o submitExceptionRequest para adicionar, atualizar ou excluir uma listagem de arquivos de exceção de um caso novo ou existente. Também é usado para reparar uma listagem de arquivos de exceção rejeitada.
      Gestão de taxas diversas Consultar construtor de solicitação de detalhes de taxa diversa Produz paylod de solicitação para getMiscFeeDetails. GetMiscFeeDetalhsRequest permite que os clientes solicitem detalhes para uma taxa diversa.
      Consultar analisador de resposta de detalhes da taxa diversa Analisa a resposta de getMiscFeeDetalhsRequest. GetMiscFeeDetalhsRequest permite que os clientes solicitem detalhes para uma taxa diversa.
      Enviar construtor de solicitação de taxa diversa Produz 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 de solicitação para a API GetGMPFDetails
      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 do seu ServiceNow instância.
      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 disputa a partir de uma transação ou caso.
      Mudar de status da disputa Analisa a resposta de CardholderPurchaseQuery. 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. Ele também pode ser usado para recuperar informações de compra de transações não 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.
      Baixar e anexar imagem Baixa e anexa um Visa imagem do caso para a. ServiceNow registro.
      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 esta API para criar um caso com base em uma solicitação de consulta de transação.
      Gestão de questionário Enviar questionário de disputa Esta ação permite que os usuários da Interface de sistemas em tempo real (RTSI) enviem ou salvem o questionário de disputa.
      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 disputa 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 do pacote de fraude. Esta solicitação pode incluir imagem(ns).
      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).
      Aceitar contestação Aceita a responsabilidade de contestação ou aceita a decisão do outro lado e remove a transação de contestação da fila.
      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 AssociatedTranSelection permite que os usuários confirmem ou rejeitem as associações de algumas ou 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 associado.
      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 agendados para a organização do usuário ou para um relatório específico que o usuário deseje saber.
      Gestão de filas em 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 usa aliases para gerenciar conexões e informações de credenciais 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 da Visa..