Token-Requestor Visa & Mastercard

Übersicht

Die Netzwerk-Tokenisierung durch Visa Token Service und Mastercard Tokenization bietet eine sichere Methode für die Verarbeitung von Zahlungen, ohne sensible Kartendaten preiszugeben. Bei der Tokenisierung der Kreditkartendaten eines Karteninhabers generieren die Kartennetzwerke einen eindeutigen Identifikator (Token), der die eigentliche Kartennummer ersetzt und so die Sicherheit erhöht, während gleichzeitig ein nahtloses Zahlungserlebnis gewährleistet wird.

💡 Mehr über Tokenisierung in unserem Blogbeitrag nachlesen: Frisbii Blog

Wichtigste Vorteile

Erhöhte Sicherheit: Token ersetzen die tatsächlichen Kartennummern und verringern so das Risiko von Datenschutzverletzungen
Automatische Karten-Updates: Frisbii aktualisiert automatisch die gespeicherten Karten, wenn die Kartenaussteller neue Kartendaten zur Verfügung stellen.
Geringere unfreiwilliger Churn: Kunden müssen ihre Zahlungsinformationen nicht manuell aktualisieren, wenn Karten neu ausgestellt werden
Verbesserte Autorisierungsraten: Netzwerk-Tokens haben in der Regel höhere Autorisierungsraten als herkömmliche Kartennummern

Konfiguration

Token-Requestor-IDs einrichten

Um die Netzwerk-Tokenisierung in Frisbii Admin zu aktivieren:

Navigiere zu den Einstellungen des Acquirer-Vertrags über Konfigurationen → Checkout Management → Zahlungsmethoden → Kreditkartenvertrag.
Öffne Deinen Acquirer-Vertrag oder erstelle einen neuen Acquirer-Vertrag, wenn Du noch keinen hast.
Gehe zum Abschnitt Konfiguration des Token-Requestors.
Für Visa und Mastercard wähle die Token Requestor ID aus dem Dropdown-Menü.

Wenn Du noch keine Token Requestor ID erstellt hast:

Visa-Token-Requestor-ID erstellen oder Mastercard-Token-Requestor-ID erstellen anklicken.
Den Aufforderungen folgen, um die Einrichtung abzuschließen.

Diese Identifikatoren ermöglichen eine sichere Zahlungsabwicklung durch Netzwerk-Tokenisierung und erlauben Frisbii, die Zahlungsmethoden Deiner Kunden automatisch zu verwalten.

👩‍💻 Teste die Einrichtung
Ein Testen der Einrichtung ist nicht erforderlich. Wenn Du sie wirklich testen möchtest, folge unserer technischen Dokumentation: Test payment method events

Webhook-Ereignisse

👩‍💻 Technische Dokumentation
Weitere Informationen über Webhook-Ereignisse findest Du in unserer technischen Dokumentation: Events

Sobald eine Karte mit einem Token versehen ist, erhältst Du Webhook-Ereignisse, um Änderungen an Kundenzahlungsmethoden zu überwachen. Um einen zuverlässigen Zahlungsprozess aufrechtzuerhalten, ist es wichtig, diese Ereignisse zu verstehen und darauf zu reagieren.

Verfügbare Ereignisse

customer_payment_method_updated

Auslöser: Das Kartennetzwerk hat aktualisierte Karteninformationen von der ausstellenden Bank übermittelt.
Bedeutung: Die zugrundeliegenden Kartendaten haben sich geändert, z. B. eine neue Kartennummer (maskiert) oder das Ablaufdatum, aber das Token bleibt gültig.

💡 Maßnahmen erforderlich? Es besteht kein unmittelbarer Handlungsbedarf. Die Zahlungsmethode wird automatisch aktualisiert und bleibt aktiv. Du kannst dieses Ereignis für Deine Unterlagen protokollieren.

customer_payment_method_reactivated

Auslöser: Eine zuvor fehlgeschlagene oder ausgesetzte Zahlungsmethode wurde wieder in den aktiven Status versetzt.
Bedeutung: Ein vorübergehend ausgesetztes Token wurde wieder aktiviert, oder eine zuvor fehlgeschlagene Zahlung mit dieser Karte war bei erneutem Versuch erfolgreich.

💡 Maßnahmen erforderlich? Es sind keine sofortigen Maßnahmen erforderlich, aber Du kannst den Kunden benachrichtigen, dass seine Zahlungsmethode wieder aktiv ist.

customer_payment_method_failed

Auslöser: Die ausstellende Bank hat dem Netzwerk mitgeteilt, dass die Karte nicht mehr gültig ist.
Bedeutung: Die Karte ist abgelaufen, gesperrt oder aus anderen Gründen für Zahlungen nicht nutzbar.

💡 Maßnahmen erforderlich? Ja.

Benachrichtigung des Kunden, dass seine Zahlungsmethode aktualisiert werden muss
Sie auffordern, eine neue Zahlungsmethode hinzuzufügen
Aktualisieren Sie alle aktiven Abonnements, um eine gültige Zahlungsmethode zu verwenden.

EMV-Token-Ereignisse

Sie finden die EMV-Token-Ereignisse im Frisbii Admin unter Kunden → Zahlungsarten Ereignisse.

Netzwerk-Tokens können in drei Zuständen existieren:

Status	Beschreibung	Erforderliche Maßnahmen
aktiv	Token ist gültig und kann für Zahlungen verwendet werden	Keine Entschädigung
gesperrt	Token ist vorübergehend vom Kartenaussteller gesperrt, dieser Zustand kann sich ändern	Empfohlen: Kontakt mit dem Kunden aufnehmen; neue Zahlungsmethode anfordern
gelöscht	Token ist dauerhaft deaktiviert	Neue Zahlungsmethode vom Kunden anfordern