Spoke da Mastercard
Integre a instância ServiceNow à sua conta Mastercard para habilitar o acesso ao pacote de APIs de Mastercard, Mastercom e Mastercom Extended, para resolução de contestação de cartão. Essa integração permite que você execute tarefas como pesquisar transações, criar sinistros e processar estornos.
Solicitar aplicativos na Store
Acesse o site ServiceNow Store para ver todos os aplicativos disponíveis e obter informações sobre como enviar solicitações para a loja. Para obter informações sobre notas de versão cumulativa para todos os aplicativos liberados, consulte as ServiceNow Store notas de versão do histórico de versão.
Assinatura do Integration Hub
Este spoke exige uma assinatura Integration Hub. Para obter mais informações, consulte Cronogramas jurídicos - Integration Hub visão geral.
Versão do spoke
Spoke da Mastercard v2.0.1 é a versão mais recente.
Versão compatível
Este spoke foi criado para Mastercom v6.
Principais recursos
Spoke da Mastercard permite que um Flow Designer crie fluxos de trabalho usando ações que invocam Mastercom e Mastercom Extended. Isso inclui a capacidade de:
- Pesquisar transações
- Criar sinistros e estornos
- Colabore com os comerciantes para evitar estornos
- Monitorar contestações durante todo o ciclo de vida da contestação
- Acelere o processo de gestão de contestação de ponta a ponta
- Gerencie contestações de transações originais limpas do Sistema de mensagem única com Mastercom Extended
Requisitos do spoke
- Assinatura do Integration Hub
- Mastercard detalhes de configuração, como certificado, alias de chave, chave do consumidor e senha do armazenamento de chaves
Dependências do spoke
Certifique-se de que estes plug-ins dependentes estejam instalados:
- ServiceNow Integration Hub Tempo de execução (com.glide.hub.integration.runtime)
- ServiceNow Integration Hub 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 da Mastercard fornece ações para simplificar a resolução de contestações 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. Ao usar APIs Mastercom/Mastercom Extended, é recomendável usar uma solução de tokenização. Isso envolve o uso de um construtor de solicitação para criar solicitações com segurança e um analisador de resposta para lidar com respostas de API criptografadas.
Tabela 1. Mastercom aações com informações confidenciais Categoria Ação Descrição Transações Consultar construtor de solicitação de detalhes de autorização da transação Permite que os emissores pesquisem detalhes de autorização para a transação original envolvida no sinistro depois que o emissor cria um sinistro. Consultar analisador da resposta de detalhes de autorização da transação Consultar construtor de solicitação de detalhes de compensação da transação Permite que os emissores recuperem detalhes de compensação da transação original envolvida no sinistro. Os adquirentes também podem usar isso para recuperar detalhes de compensação associados a uma transação original. Consultar analisador de resposta da transação dos detalhes de compensação Consultar construtor de solicitação de transações Permite que os emissores pesquisem informações sobre uma transação original. Um emissor pode usar essas informações para realizar uma ação na transação original, como criar um sinistro. Consultar analisador de resposta de transações Sinistros Consultar construtor de solicitação de sinistros em uma fila Permite que os emissores recuperem uma lista de declarações na fila dentro do construtor de solicitação de intervalo de datas. Consultar analisador de resposta de sinistros em uma fila Consultar construtor de solicitação de detalhes do sinistro por ID do sinistro Permite que emissores e adquirentes recuperem detalhes de um sinistro existente, incluindo todos os casos aos quais o sinistro esteja associado. Consultar analisador da resposta de detalhes do sinistro por ID do sinistro Tabela 2. Mastercom Extended ações com informações confidenciais Categoria Ação Descrição Mastercom Extended Gestão de sinistros Consultar construtor de solicitação de detalhes do sinistro por ID - Estendido O Construtor de solicitações produz a carga da solicitação para esta ação. Use este endpoint para recuperar detalhes de um sinistro existente. Pesquisar detalhes do sinistro por analisador de resposta de ID - Estendido Analisa a resposta da pesquisa. Use este endpoint para recuperar detalhes de um sinistro existente. Consultar construtor de solicitação de detalhes do sinistro - Estendido O Construtor de solicitações produz a carga da solicitação para esta ação. Use este endpoint para recuperar uma lista de declarações. Pesquisar analisador de resposta de detalhes do sinistro - Estendido Analisa a resposta do searchClaim. Use este endpoint para recuperar uma lista de declarações. Mastercom Extended - Gestão de transações Pesquisar construtor de solicitação de transações - Estendido O Construtor de solicitações produz a carga da solicitação para esta ação. Use este endpoint para pesquisar transações. Consultar analisador de resposta de transações - Estendido Analisa a resposta da pesquisa. Use este endpoint para pesquisar transações. Mastercom Extended - Gestão de documentos de arquivamento de casos Pesquisar documentos processados por ID de caso Construtor de solicitação - Estendido Construtor de solicitações para recuperar documentos processados associados à API de casos. Use este endpoint para recuperar todos os documentos de um caso. Os documentos incluem todos os documentos anexados por qualquer parte. Pesquisar documentos processados por analisador de resposta de ID de caso - Estendido Analisa a resposta de Recuperar documentos processados associados a casos. Use este endpoint para recuperar todos os documentos de um caso. Os documentos incluem todos os documentos anexados pelo remetente, destinatário ou ambos. Mastercom Extended - Gestão de documentos Pesquisar documentos processados por ID de documento concluído Construtor de solicitação - Estendido Construtor de solicitações para API de recuperação de documentos processados. Use este endpoint para recuperar documentos processados. Pesquisar documentos processados por analisador de resposta de ID de documento concluído - Estendido Analisador de resposta para endpoint da API Recuperar documentos processados. Use este endpoint para recuperar documentos processados. O exemplo a seguir ilustra a visão geral da solução quando ela se integra a uma solução de tokenização:
- Ações com informações não confidenciais - Você pode invocar diretamente essas APIs Mastercom/Mastercom Extended da sua instância ServiceNow.
Tabela 3. Mastercom aações com informações não confidenciais Categoria Ação Descrição Mastercom Gestão de estornos Confirmar estornos Confirma que um estorno ou segunda representação move o sinistro da fila Não trabalhada para a fila Trabalhada. Criar estorno Cria estornos e segundas apresentações com a opção de carregar documentos de suporte. Carregar dados para estornos Obtém informações sobre um possível primeiro estorno ou segunda apresentação antes de criar o estorno. Consultar documentos de estorno Recupera documentos no formato necessário associado ao tipo de estorno. Consultar status da imagem do estorno Recupera documentos com um status (concluído, pendente, com falha, indisponível ou documento não aplicável) para estornos. Pesquisar status de estornos Recupera o status de documentos para uma lista específica de IDs de sinistro e IDs de estorno.Nota:Emissores e adquirentes podem enviar no máximo 2.000 IDs de estorno em uma única solicitação.Reverter estorno Reverte um estorno existente quando o emissor ou adquirente criar um estorno por engano. Atualizar estorno Atualiza os estornos existentes com memorandos ou documentos. Mastercom Gestão de sinistros Criar reclamação Uuse este endpoint para criar uma reclamação, o que é necessário antes de criar uma solicitação de recuperação ou um primeiro estorno. Executar ação em uma reclamação existente Uuse este endpoint para executar operações (reabrir ou fechar) em um sinistro existente. Mastercom Gestão de fraudes Criar fraude Cria um item de fraude quando o emissor determina que uma transação foi fraudulenta. Nota:O Mastercom permite que os emissores criem itens de fraude no banco de dados de fraudes e perdas. No entanto, os emissores devem usar a aplicação Fraude e Perda para fazer atualizações adicionais nos itens de fraude.Consultar informações relacionadas a fraudes Uuse este endpoint para obter informações relacionadas a fraudes associadas a um sinistro antes de criar um item de fraude para o sinistro. Mastercom Gestão de filas Consultar nomes de filas Recupera uma lista de nomes de fila. Tabela 4. Mastercom Extended ações com informações não confidenciais Categoria Ação Descrição Mastercom Extended - Gestão de documentos de arquivamento de casos Anexar documento por ID de caso - Estendido Use este endpoint para anexar um novo documento a um caso existente quando o documento anterior falhar. O status de processamento do documento pode ser recuperado do endpoint GET /cases/documents/attributes. Pesquisar status de documentos associados a casos - Estendido Use este endpoint para recuperar o status de processamento de documentos associados a casos. Mastercom Extended - Gestão de arquivamento de casos Criar caso de pré-arbitragem/arbitragem - Estendido Use este endpoint para criar um caso de pré-arbitragem ou arbitragem. Pesquisar detalhes do caso por ID - Estendido Use este endpoint para recuperar detalhes de um caso existente, fornecendo informações abrangentes sobre o caso. Atualizar caso de pré-arbitragem/arbitragem - Estendido Use este endpoint para atualizar ou responder a um caso de pré-arbitragem ou arbitragem. Atualizar caso de pré-conformidade/conformidade - estendido Use este endpoint para atualizar ou responder a um caso de pré-conformidade ou conformidade. Mastercom Extended - Gestão de estornos Criar reversão de estorno - estendido Use este endpoint para reverter estornos existentes. Mastercom Extended Gestão de sinistros Criar sinistro - Estendido Use este endpoint para criar uma nova reclamação. Criar caso de pré-conformidade/conformidade - estendido Use este endpoint para criar um caso de pré-conformidade ou conformidade. Mastercom Extended - Gestão de disputas Iniciar uma contestação por ID do sinistro - Estendido Use este endpoint para iniciar uma contestação. No momento, somente a criação de um estorno é compatível. Mastercom Extended - Gestão de documentos Anexar documentos por ID do sinistro e ID do evento - Estendido Use este endpoint para anexar documentos carregados anteriormente a eventos de contestação existentes. Verificar detalhes do documento - Estendido Use este endpoint para obter os detalhes da documentação anexada aos eventos, incluindo o status. Carregar documentos - Estendido Use este endpoint para carregar documentos.
Para ver detalhes sobre restrições de arquivo, consulte a seção Tutoriais e Guias das Especificações da API Estendida do Mastercom.
Mastercom Extended - Gestão de filas Pesquisar sinistros em uma fila por fluxo de ID - Estendido Use este endpoint para recuperar uma lista de declarações em uma fila dentro de um intervalo de datas especificado. Pesquisar fila por ID - Estendido Use este endpoint para recuperar campos em uma fila específica. Pesquisar fluxo de filas - Estendido Use este endpoint para recuperar uma lista de filas e seus campos. Mastercom Extended - Gestão de definição de relatório Pesquisar campos de relatório - Estendido Use este endpoint para recuperar campos em um relatório específico. Pesquisar fluxo de campos de relatório - Estendido Use este endpoint para recuperar uma lista de relatórios e seus campos. Mastercom Extended - Gestão de relatórios Criar um relatório - Estendido Use este endpoint para solicitar a criação do relatório. OBSERVAÇÃO: o sistema requer pelo menos 120 segundos para gerar um relatório. Pesquisar relatório concluído - Estendido Use este endpoint para recuperar um relatório concluído. Pesquisar status do relatório - Estendido Use este endpoint para recuperar o status de um relatório específico. Pesquisar fluxo de relatórios - Estendido Use este endpoint para obter um status de relatório e reportCompletedId. Mastercom Extended - Gestão de representações Atualizar representação por ID do sinistro e ID do evento - Estendido Use este endpoint para confirmar uma representação, que move a declaração para a fila Trabalhada. Os emissores podem realizar outras ações em sinistros confirmados.
Requisitos de aliases de conexão e credencial
Integration Hub 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 informações sobre como configurar o spoke, consulte Configurar spoke da Mastercard.