Mastercard-Spoke

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 8 Minuten Lesedauer

    • Integrieren Sie die Instanz ServiceNow mit Ihrem Konto Mastercard, um den Zugriff auf die API-Suite von MastercardMastercom und Mastercom Extendedfür die Lösung von Kartenkonflikten zu aktivieren. Mit dieser Integration können Sie Aufgaben wie das Durchsuchen von Transaktionen, das Erstellen von Ansprüchen und das Verarbeiten von Ausgleichen ausführen.

    Apps im Store anfordern

    Besuchen Sie die ServiceNow Store-Website, um alle verfügbaren Apps anzuzeigen und Informationen zum Senden von Anforderungen an den Store zu erhalten. Kumulative Informationen zum Release für alle veröffentlichten Apps finden Sie in den Release-Hinweisen zum ServiceNow Store-Versionsverlauf.

    IntegrationHub-Abonnement

    Diese Spoke erfordert ein IntegrationHub-Abonnement. Weitere Informationen finden Sie unter Gesetzliche Zeitpläne – IntegrationHub Übersicht.

    Spoke-Version

    Mastercard-Spoke v2.0.1 ist die neueste Version.

    Unterstützte Version

    Diese Spoke wurde für Mastercom v6erstellt.

    Schlüsselfunktionen

    Mastercard-Spoke ermöglicht es einem Flow Designer, Workflows mit Aktionen zu erstellen, die Mastercom und Mastercom Extendedaufrufen. Dazu gehört die Fähigkeit:
    • Suchen Sie nach Transaktionen
    • Erstellen Sie Ansprüche und Ausgleiche
    • Arbeiten Sie mit Händlern zusammen, um Ausgleiche zu verhindern
    • Überwachen Sie Konflikte während des gesamten Konfliktlebenszyklus
    • Beschleunigen Sie den End-to-End-Konfliktmanagementprozess
    • Verwalten Sie Konflikte für gelöschte ursprüngliche Transaktionen des Einzelnachrichtensystems mit Mastercom Extended

    Spoke-Anforderungen

    • IntegrationHub-Abonnement
    • Mastercard -Konfigurationsdetails, z. B. Zertifikat, Schlüsselalias, Verbraucherschlüssel und Schlüsselspeicher-Passwort

    Spoke-Abhängigkeiten

    Stellen Sie sicher, dass diese abhängigen Plugins installiert sind:
    • ServiceNow IntegrationHub Runtime (com.glide.hub.integration.runtime)
    • ServiceNow IntegrationHub Action Step - REST (com.glide.hub.action_step.rest)
    Hinweis:
    Einige dieser Plugins sind lizenzierbare Funktionen und erfordern entsprechende Lizenzen, wenn sie außerhalb der Spoke-Implementierung verwendet werden.

    Spoke-Aktionen

    Mastercard-Spoke bietet Aktionen zur Vereinfachung der Lösung von Kartenkonflikten. Folgende Aktionen sind verfügbar:
    • Aktionen mit vertraulichen Informationen : Diese Aktionen enthalten vertrauliche Informationen im Anforderungs- und Antworttext. Für die Verwendung Mastercomvon /Mastercom Extended -APIs wird die Verwendung einer Tokenisierungslösung empfohlen. Dies beinhaltet die Verwendung eines Anforderungsgenerators zum sicheren Erstellen von Anforderungen und eines Antwortparsers zum Verarbeiten verschlüsselter API-Antworten.
      Tabelle : 1. Mastercom eine-Aktionen mit vertraulichen Informationen
      Kategorie Aktion Beschreibung
      Transaktionen Autorisierungsdetails für Anforderungs-Builder der Transaktion nachschlagen Ermöglicht es den Ausstellern, nach Autorisierungsdetails für die ursprüngliche Transaktion zu suchen, die an dem Anspruch beteiligt war, nachdem der Aussteller einen Anspruch erstellt hat.
      Autorisierungsdetails für Antwortparser der Transaktion durchsuchen
      Sucht nach Clearing-Details für den Anforderungs-Builder für Transaktionen Ermöglicht den Ausstellern, Clearing-Details für die ursprüngliche Transaktion abzurufen, die an der Forderung beteiligt war. Erwerber können hiermit auch Clearing-Details abrufen, die einer ursprünglichen Transaktion zugeordnet sind.
      Clearing-Details für Antwortparser für Transaktionen nachschlagen
      Anforderungs-Builder für Transaktionen nachschlagen Ermöglicht den Ausstellern, nach Informationen zu einer ursprünglichen Transaktion zu suchen. Ein Aussteller kann diese Informationen verwenden, um eine Aktion für die ursprüngliche Transaktion auszuführen, z. B. um einen Anspruch zu erstellen.
      Antwortparser für Transaktionen nachschlagen
      Ansprüche Ansprüche in einem Warteschlangen-Anforderungs-Bilder nachschlagen Ermöglicht den Ausstellern, eine Liste der Ansprüche in der Warteschlange innerhalb des Datumsintervall-Anforderungsgenerators abzurufen.
      Ansprüche in einer Antwortparser-Warteschlange nachschlagen
      Anspruchs-ID: Eindeutiger Bezeichner für den Anspruch. Ermöglicht Ausstellern und Erwerbern, Details für einen vorhandenen Anspruch abzurufen, einschließlich aller Fälle, denen der Anspruch zugeordnet ist.
      Antwortparser für Anspruchsdetails nach Anspruchs-ID nachschlagen
      Tabelle : 2. Mastercom Extended -Aktionen mit vertraulichen Informationen
      Kategorie Aktion Beschreibung
      Mastercom Extended Anspruchsverwaltung Schadenfalldetails nach ID-Anforderungs-Builder suchen – Erweitert Der Anforderungsgenerator erstellt die Anforderungsnutzlast für diese Aktion. Verwenden Sie diesen Endpunkt, um Details für einen vorhandenen Anspruch abzurufen.
      Schadenfalldetails nach ID suchen – Antwortparser – Erweitert Analysiert die Antwort aus der Suche. Verwenden Sie diesen Endpunkt, um Details für einen vorhandenen Anspruch abzurufen.
      Nach Schadenfalldetails suchen – Anforderungs-Builder – Erweitert Der Anforderungsgenerator erstellt die Anforderungsnutzlast für diese Aktion. Verwenden Sie diesen Endpunkt, um eine Liste von Ansprüchen abzurufen.
      Nach Antwortparser für Anspruchsdetails suchen – Erweitert Analysiert die Antwort von „searchClaim“. Verwenden Sie diesen Endpunkt, um eine Liste von Ansprüchen abzurufen.
      Mastercom Extended - Transaktionsmanagement Anforderungs-Builder für Transaktionen suchen – erweitert Der Anforderungsgenerator erstellt die Anforderungsnutzlast für diese Aktion. Verwenden Sie diesen Endpunkt, um nach Transaktionen zu suchen.
      Antwortparser für Transaktionen suchen – Erweitert Analysiert die Antwort aus der Suche. Verwenden Sie diesen Endpunkt, um nach Transaktionen zu suchen.
      Mastercom Extended Dokumentverwaltung für Falleinreichung Verarbeitete Dokumente nach Fall-ID suchen – Anforderungs-Builder – Erweitert Anforderungsgenerator zum Abrufen verarbeiteter Dokumente, die der Fall-API zugeordnet sind. Verwenden Sie diesen Endpunkt, um alle Dokumente aus einem Fall abzurufen. Die Dokumente enthalten alle angehängten Dokumente einer beliebigen Partei.
      Verarbeitete Dokumente nach Fall-ID suchen – Antwortparser – Erweitert Analysiert die Antwort zum Abrufen verarbeiteter Dokumente, die Fällen zugeordnet sind. Verwenden Sie diesen Endpunkt, um alle Dokumente aus einem Fall abzurufen. Die Dokumente enthalten alle Dokumente, die vom Absender und/oder Empfänger angehängt wurden.
      Mastercom Extended Dokumentenmanagement Verarbeitete Dokumente nach Anforderungs-Builder für abgeschlossene IDs für Dokumente suchen – erweitert Anforderungsgenerator für die API zum Abrufen verarbeiteter Dokumente. Verwenden Sie diesen Endpunkt, um verarbeitete Dokumente abzurufen.
      Verarbeitete Dokumente nach „Dokument abgeschlossene ID“ suchen – Antwortparser – erweitert Antwortparser für „Verarbeitete Dokumente abrufen“-API-Endpunkt. Verwenden Sie diesen Endpunkt, um verarbeitete Dokumente abzurufen.

      Das folgende Beispiel veranschaulicht die Lösungsübersicht bei Integration mit einer Tokenisierungslösung: Übersicht über die Tokenisierungslösung.

    • Aktionen mit nicht vertraulichen Informationen : Sie können diese Mastercom-/Mastercom Extended - APIs direkt über Ihre ServiceNow -Instanz aufrufen.
      Tabelle : 3. Mastercom - und-Aktionen mit nicht vertraulichen Informationen
      Kategorie Aktion Beschreibung
      Mastercom Ausgleichsverwaltung Ausgleiche bestätigen Bestätigt einen Ausgleich, oder eine zweite Wiedervorlage verschiebt den Anspruch aus der Warteschlange „Unbearbeitet“ in die Warteschlange „Bearbeitet“.
      Ausgleich erstellen Erstellt Ausgleiche und zweite Präsentationen mit der Option zum Hochladen von Begleitdokumenten.
      Daten für Ausgleiche laden Ruft Informationen über einen potenziellen ersten Ausgleich oder eine zweite Präsentation ab, bevor der Ausgleich erstellt wird.
      Ausgleichsdokumente suchen Ruft Dokumente im erforderlichen Format ab, die dem Ausgleichstyp zugeordnet sind.
      Status von Ausgleichsbildern suchen Ruft Dokumente mit einem Status (abgeschlossen, ausstehend, fehlgeschlagen, nicht verfügbar oder Dokument nicht anwendbar) für Ausgleiche ab.
      Status von Ausgleichen nachschlagen
      Ruft den Status von Dokumenten für eine bestimmte Liste von Anspruchs-IDs und Ausgleichs-IDs ab.
      Hinweis:
      Aussteller und Erwerber können maximal 2.000 Ausgleichs-IDs in einer einzigen Anforderung senden.
      Ausgleich rückgängig machen Macht einen vorhandenen Ausgleich rückgängig, wenn der Aussteller irrtümlich einen Ausgleich erstellt.
      Ausgleich aktualisieren Aktualisiert vorhandene Ausgleiche mit Memos oder Dokumenten.
      Mastercom Anspruchsverwaltung Anspruch erstellen Verwenden Sie diesen Endpunkt, um eine Forderung zu erstellen, die vor dem Erstellen einer Abrufanforderung oder eines erstenAusgleichs erforderlich ist.
      Maßnahmen für vorhandenen Anspruch ergreifen Sieverwenden diesen Endpunkt, um Vorgänge (erneut öffnen oder schließen) für einen vorhandenen Anspruch auszuführen.
      Mastercom Betrugsmanagement Betrug erstellen Erstellt ein Betrugselement, wenn der Aussteller feststellt, dass eine Transaktion betrügerisch war.
      Hinweis:
      Mit Mastercom können Aussteller Betrugselemente in der Betrugs- und Verlustdatenbank erstellen. Aussteller müssen jedoch die Anwendung „Betrug und Verlust“ verwenden, um weitere Aktualisierungen an Betrugselementen vorzunehmen.
      Betrugsbezogene Informationen suchen Sieverwenden diesen Endpunkt, um mit einem Anspruch verknüpfte betrügerische Informationen zu erhalten, bevor Sie ein Betrugselement für den Anspruch erstellen.
      Mastercom Warteschlangenverwaltung Warteschlangennamen suchen Ruft eine Liste von Warteschlangennamen ab.
      Tabelle : 4. Mastercom Extended -Aktionen mit nicht sensiblen Informationen
      Kategorie Aktion Beschreibung
      Mastercom Extended Dokumentverwaltung für Falleinreichung Dokument nach Fall-ID anhängen – erweitert Verwenden Sie diesen Endpunkt, um ein neues Dokument an einen vorhandenen Fall anzuhängen, wenn das vorherige Dokument nicht verarbeitet werden konnte. Der Status der Dokumentverarbeitung kann vom Endpunkt „GET /cases/documents/attributes“ abgerufen werden.
      Sucht nach Status für Dokumente, die Fällen zugeordnet sind – erweitert Diesen Endpunkt verwenden, um den Verarbeitungsstatus von Dokumenten abzurufen, die Fällen zugeordnet sind.
      Mastercom Extended Falleinreichungsverwaltung Vor-Arbitration/Arbitrationsfall erstellen – Erweitert Verwenden Sie diesen Endpunkt, um einen Vor-Arbitrations- oder Arbitrationsfall zu erstellen.
      Falldetails nach ID suchen – Erweitert Verwenden Sie diesen Endpunkt, um Details für einen vorhandenen Fall abzurufen und umfassende Informationen über den Fall bereitzustellen.
      Vor-Arbitration/Arbitrationsfall aktualisieren – Erweitert Verwenden Sie diesen Endpunkt, um einen Vor-Arbitrations- oder Arbitrationsfall zu aktualisieren oder darauf zu reagieren.
      Pre-Compliance/Compliance-Fall aktualisieren – erweitert Verwenden Sie diesen Endpunkt, um einen Vor-Compliance- oder Compliance-Fall zu aktualisieren oder darauf zu reagieren.
      Mastercom Extended Ausgleichsmanagement Ausgleichsstorno erstellen – Erweitert Verwenden Sie diesen Endpunkt, um vorhandene Ausgleiche rückgängig zu machen.
      Mastercom Extended Anspruchsverwaltung Anspruch erstellen – Erweitert Verwenden Sie diesen Endpunkt, um einen neuen Anspruch zu erstellen.
      Pre-Compliance/Compliance-Fall erstellen – Erweitert Verwenden Sie diesen Endpunkt, um einen Vor-Compliance- oder Compliance-Fall zu erstellen.
      Mastercom Extended Konfliktmanagement Initiieren Sie einen Konflikt anhand der Anspruchs-ID – Erweitert Verwenden Sie diesen Endpunkt, um einen Konflikt zu initiieren. Derzeit wird nur das Erstellen eines Ausgleichs unterstützt.
      Mastercom Extended Dokumentenmanagement Dokumente nach Anspruchs-ID und Ereignis-ID anhängen – erweitert Verwenden Sie diesen Endpunkt, um zuvor hochgeladene Dokumente an vorhandene Konfliktereignisse anzuhängen.
      Dokumentdetails prüfen – Erweitert Verwenden Sie diesen Endpunkt, um die Details der Dokumentation abzurufen, die an ihre Ereignisse angehängt ist, einschließlich des Status.
      „Dokumente hochladen“: Erweitert

      Verwenden Sie diesen Endpunkt zum Hochladen von Dokumenten.

      Weitere Informationen zu Dateibeschränkungen finden Sie im Abschnitt „Tutorials und Anleitungen“ in den Spezifikationen der erweiterten Mastercom-API.
      Mastercom Extended -Warteschlangenverwaltung Ansprüche in einer Warteschlange nach ID-Stream suchen – Erweitert Verwenden Sie diesen Endpunkt, um eine Liste der Ansprüche in einer Warteschlange innerhalb eines angegebenen Datumsbereichs abzurufen.
      Warteschlange nach ID suchen – Erweitert Verwenden Sie diesen Endpunkt, um Felder in einer bestimmten Warteschlange abzurufen.
      Stream mit Warteschlangen suchen – erweitert Verwenden Sie diesen Endpunkt, um eine Liste von Warteschlangen und deren Felder abzurufen.
      Mastercom Extended Verwaltung von Berichtdefinitionen Nach Berichtsfeldern suchen – erweitert Verwenden Sie diesen Endpunkt, um Felder in einem bestimmten Bericht abzurufen.
      Stream mit Berichtsfeldern suchen – erweitert Verwenden Sie diesen Endpunkt, um eine Liste von Berichten und deren Felder abzurufen.
      Mastercom Extended - Berichtsmanagement Einen Bericht erstellen – Erweitert Verwenden Sie diesen Endpunkt, um die Erstellung eines Berichts anzufordern. HINWEIS: Das System benötigt mindestens 120 Sekunden, um einen Bericht zu generieren.
      Nach abgeschlossenem Bericht suchen – erweitert Verwenden Sie diesen Endpunkt, um einen abgeschlossenen Bericht abzurufen.
      Sucht nach Berichtsstatus – Erweitert Verwenden Sie diesen Endpunkt, um den Status eines bestimmten Berichts abzurufen.
      Stream mit Berichten suchen – erweitert Verwenden Sie diesen Endpunkt, um einen Berichtsstatus und eine reportCompletedId abzurufen.
      Mastercom Extended Representation Management Aktualisiert die Darstellung nach Anspruchs-ID und Ereignis-ID – erweitert Verwenden Sie diesen Endpunkt, um eine Wiedervorlage zu bestätigen, die den Anspruch in die Warteschlange „Gearbeitet“ verschiebt. Aussteller können weitere Maßnahmen für bestätigte Ansprüche ergreifen.

    Alias-Anforderungen für Verbindungen und Anmeldeinformationen

    IntegrationHub verwendet Aliasse, um Verbindungs- und Anmeldeinformationen sowie OAuth-Anmeldeinformationen zu verwalten. Wenn Sie ein Alias verwenden, müssen Sie nicht mehrere Anmeldeinformations- und Verbindungsinformationsprofile konfigurieren, wenn Sie mehrere Umgebungen verwenden. Wenn sich die Verbindungs- oder Anmeldeinformationen ändern, müssen Sie die Aktionen, die die Verbindung verwenden, nicht aktualisieren.

    Informationen zum Einrichten der -Spoke finden Sie unter Richten Sie die Mastercard-Spoke ein.