Vom Händler initiierte Transaktionen (Merchant Initiated Transactions, MITs)

Übersicht über den MIT-Support

Händlerinitiierte Transaktionen (Merchant Initiated Transactions, MITs) sind Transaktionen, die verarbeitet werden, ohne dass der Nutzer aktiv angemeldet ist. Dieses Update der Google Pay Online API bietet eine bessere Sichtbarkeit für diese Transaktionstypen, eine verbesserte Nutzererfahrung durch eine spezielle Benutzeroberfläche für Abrechnungsdetails und eine bessere Kontinuität bei Zahlungen.

Wichtige Anwendungsfälle

  • Wiederkehrende Zahlungen:Digitale Streamingdienste, Mitgliedschaften oder Nebenkosten.
  • Aufgeschobene Zahlungen:Hotelreservierungen, Vorbestellungen oder Gebühren bei Nichterscheinen.
  • Automatisches Aufladen:Aufladen von Guthaben für Fahrkarten oder Geschenkkarten.

Implementierung der MIT API

Die MIT API ist eine Erweiterung der vorhandenen loadPaymentData API. Integratoren müssen genau ein *TransactionInfo-Objekt einfügen, um die Abrechnungsabsicht anzugeben. Google bietet je nach Art der vom Händler initiierten Transaktion drei Optionen an:

Transaktionstyp Objektname Beschreibung
Wiederkehrend RecurringTransactionInfo Wird für Gebühren mit fester Häufigkeit verwendet. Unterstützt Testzeiträume sowie Prepaid- und Postpaid-Abrechnung.
Aufgeschoben DeferredTransactionInfo Wird für eine einmalige Belastung zu einem festgelegten zukünftigen Zeitpunkt verwendet.
Automatische Aktualisierung AutomaticReloadTransactionInfo Wird zum Aufladen eines Guthabenkontos verwendet, wenn das Guthaben unter einen Mindestgrenzwert fällt.

Integrationsschritte

  1. Dokumentation:Während des Early Access-Programms haben Sie Zugriff auf die Entwicklerwebsite. Die drei neuen Objektdefinitionen finden Sie im Abschnitt „Objektreferenz“. Sie sind in der vorherigen Liste direkt verlinkt.
  2. Implementierung:Verwenden Sie die relevanten *TransactionInfo-Objekte für Ihr System in Ihrer API-Anfrage.
    • Pro Anfrage kann nur ein Objekt an die API übergeben werden. Es liegt im Ermessen des jeweiligen Händlers, welches Objekt verwendet und welche Felder ausgefüllt werden.
  3. Testen:Verwenden Sie die TEST-Umgebung, um zu prüfen, ob die Abrechnungsdetails im Lohnzettel richtig dargestellt werden.
  4. Einführung:Gehen Sie live, sobald die Parameter überprüft wurden.

Token Lifecycle Management (TLM)

Das Token-Lebenszyklusmanagement sorgt für Kontinuität bei Zahlungen, indem Echtzeitbenachrichtigungen gesendet werden, wenn sichere Zahlungstokens aktualisiert oder deaktiviert werden. Dokumentation zur Verwaltung des Tokenlebenszyklus Weitere Informationen finden Sie in der .

Wichtige Token-Ereignisse

  • Deaktivierung/Löschung:Benachrichtigt, wenn ein Token nicht mehr verwendet werden kann.
  • Aktualisierungen des FPAN-Suffix: Treten auf, wenn die zugrunde liegende Zahlungskartennummer aktualisiert wird.

Voraussetzungen für die Servereinrichtung

Direkthändler und Zahlungsdienstleister müssen ein System einrichten, um diese Nachrichten zu empfangen, zu entschlüsseln und zu verarbeiten.

Anforderung Beschreibung
Endpunkt Sicherer HTTPS-Endpunkt zum Empfangen von POST-Aufrufen.
Authentifizierung Muss die Signaturvalidierung und die Nachrichtenentschlüsselung übernehmen.
Antwort Gibt SUCCESS zurück, um Benachrichtigungen fortzusetzen, oder TOKEN_NOT_FOUND/TOKEN_NOT_IN_USE, um sie zu beenden.
Händlerbenachrichtigung Zahlungsdienstleister müssen ihren Händlern den Tokenstatus mitteilen.

Implementierungshinweise

Der tokenUpdateUrl-Endpunkt muss mit der Transaktion übergeben werden, damit Aktualisierungen für das Token empfangen werden können. Zahlungsdienstleister müssen festlegen, wie Händler diese URL erhalten und in das entsprechende *TransactionInfo-Objekt einfügen.

Außerdem wird für MITs in der verschlüsselten Nutzlast ein zusätzliches optionales Feld zurückgegeben: merchantTokenId. Weitere Informationen finden Sie in der Dokumentation zu Payment Data Cryptography (für Händler) oder Payload Structure (für Zahlungsdienstleister).