Checkliste für die Einbindung

Mit der folgenden Checkliste können Sie überprüfen, ob Sie alle erforderlichen Schritte in Ihrer Web-Integration ausgeführt haben.

Testumgebung

Eine Google Pay API-Testkonfiguration gibt keine Live-Zahlungsinformationen zurück, für die Gebühren anfallen. Sie ermöglicht es Ihnen, Elemente Ihres Kaufprozesses zu testen. Folgende Elemente können getestet werden:

  • Bestätigungsseiten
  • Belege
  • Rechnungsadresse (optional)
  • Telefonnummer für die Abrechnung (optional)
  • Versandadresse (optional)
  • E-Mail-Adresse (optional)

Wenn Sie eine Testumgebung mit einer Beispielantwort für Zahlungsdaten verwenden möchten, initialisieren Sie einen neuen PaymentsClient mit einem JavaScript-Objekt, das eine Umgebungseigenschaft enthält, die auf TEST festgelegt ist.

Hier ist ein Codebeispiel: 
var paymentsClient =
    new google.payments.api.PaymentsClient({environment: 'TEST'});

Mit der Entwicklerkonsole Ihres Browsers testen

Testen Sie Ihre Website in den neuesten Versionen mehrerer unterstützter Browser und Betriebssysteme (einschließlich Desktop, Android und iOS). Öffnen Sie dazu die Entwicklertools Ihres Browsers, um Konsolennachrichten zu Ihrer Website aufzurufen. Die Nachrichten enthalten Fehler oder Warnungen aus der Google Pay API JavaScript-Clientbibliothek. Die Google Pay API unterstützt Google Chrome, Mozilla Firefox, Apple Safari, Microsoft Edge, Opera und UCWeb UC Browser auf Desktop- und Mobilplattformen.

Nach dem Aufruf von loadPaymentData() werden möglicherweise weitere Fehler im Dialogfenster für die Google-Zahlungsauswahl angezeigt. Wenn Sie nach dem Anzeigen der Fehlermeldung auf Weiter oder OK klicken, werden möglicherweise zusätzliche Details im abgelehnten Promise zurückgegeben, das von Ihrer Website verarbeitet wird.

Auf einem kompatiblen Gerät testen

Die Google Pay API ist in vielen Märkten verfügbar, tokenisierte Karten jedoch nur in einer Teilmenge von Ländern. Testen Sie Ihre Integration auf mehreren Mobilgeräten und Betriebssystemen, einschließlich Android und iOS. Wenn tokenisierte Karten als zulässige Zahlungsmethode festgelegt sind, testen Sie sie auf einem Android-Gerät mit Chrome für Android Version 59 oder höher und Google Play-Dienste Version 16.0.0 oder höher sowie auf iOS mit unterstützten Browsern wie Safari oder Chrome. Wenn Ihre Zahlungsmethode in Ihrem Land und von Ihrer ausstellenden Bank unterstützt wird, testen Sie sie mit einer in der Google Pay App gespeicherten Karte.

Wenn Sie Konsolenfehler und ‑warnungen für Chrome für Android aufrufen möchten, testen Sie mit Remote-Debugging über Chrome für den Desktop. Weitere Informationen zu möglichen Fehlern finden Sie in den Logs Ihres Android-Geräts. Sie können Fehlerlogs möglicherweise mit dem Toolfenster „Logcat“ in Android Studio, mit dem Befehlszeilentool „adb logcat“ oder in einem Android-Fehlerbericht aufrufen. Wenn Sie Fehlermeldungen im Zusammenhang mit der Google Pay API aufrufen möchten, suchen Sie nach WalletMerchantError.

Hier ist ein Codebeispiel:

adb logcat -s WalletMerchantError

Integration testen

Bevor Sie Ihre Integration zur Validierung mit einem PaymentsClient für eine TEST Umgebung konfigurierten an Google senden, müssen Sie die Abbruchkriterien für jede der folgenden funktionalen und markenbezogenen Überprüfungen erfüllt haben.

1. Grundlagen
Achten Sie darauf, dass Ihre bestehenden Risikoprüfungen und ‑kontrollen für Karten- oder PAN-Transaktionen auch auf Google Pay-Transaktionen angewendet werden. Die Google Pay-Validierung und Betrugsprüfungen sollen Ihre Risikomanagementprozesse nicht ersetzen.
Wenn Sie 3D Secure (Step-up-Authentifizierung) für normale Kartentransaktionen anhand von Risikokriterien selektiv auslösen, müssen Sie dieselben Risikokriterien verwenden, um 3D Secure für Google Pay-PAN-PAN_ONLYTransaktionen auszulösen.
Achten Sie darauf, dass Sie unsere Nutzungsbedingungen gelesen haben und bereit sind, sie zu akzeptieren. Für die Registrierung bei der Google Pay API muss Ihre E-Mail-Adresse mit einem Google-Konto verknüpft sein, vorzugsweise eine geschäftliche E-Mail-Adresse, die mit Ihrer geschäftlichen Domain verknüpft ist, z. B. „admin@meinepersoenlichedomain.de“. Wählen Sie im Google-Kontoerstellungsprozess Stattdessen meine aktuelle E‑Mail-Adresse verwenden aus, um Ihre E-Mail-Adresse mit einem Google-Konto zu verknüpfen.
Verwenden Sie die von der Google Pay API erhaltenen Daten nur zur Verarbeitung von Transaktionen. Für alle anderen Anwendungsfälle ist eine separate, ausdrückliche Einwilligung des Nutzers erforderlich.
Bestätigen Sie die Kartennetzwerke und Kartenauthentifizierungsmethoden, die von Ihrem Zahlungs abwickler in Ihrem Land akzeptiert werden.
Wenn Sie eine DIRECT tokenizationSpecification type Integration durchführen, müssen Sie Ihren öffentlichen Verschlüsselungsschlüssel jährlich rotieren und Google über die Google Pay & Wallet Console eine PCI-Bescheinigung vorlegen. Die PCI Attestierung kann von einem Drittanbieter oder einem qualifizierten Sicherheitsgutachter (Qualified Security Assessor, QSA) eingereicht werden, der vom PCI Security Standards Council zertifiziert und von einem zugelassenen Anbieter oder qualifizierten Gutachter genehmigt wurde.

2. Markentests
Verwenden Sie unsere genehmigten Assets und halten Sie sich an alle Elemente unserer Markenrichtlinien.
Achten Sie darauf, dass die Google Pay Zahlungsschaltfläche nur angezeigt wird, nachdem Ihre Website mit der Funktion isReadyToPay() bestätigt hat, dass der Nutzer bezahlen kann.
Bestätigen Sie, dass die Abmessungen der angezeigten Google Pay Zahlungsschaltfläche mit ähnlichen Schaltflächen und Elementen auf der Seite übereinstimmen.
Wählen Sie eine geeignete Schaltfläche basierend auf der Hintergrundfarbe des Bereichs aus, in dem sie angezeigt wird.

3. Funktionstests
Testen Sie Ihre Integration in mehreren gängigen Webbrowsern (z. B. Google Chrome, Apple Safari, Mozilla Firefox und Microsoft Edge) und mobilen Betriebssystemen (Android und iOS) um zu prüfen, ob das Rendern von Schaltflächen, Pop-ups für Zahlungsformulare und Transaktionsabläufe ordnungsgemäß funktionieren.
Prüfen Sie, ob loadPaymentData() synchron aufgerufen wird, wenn Sie auf die Google Pay Zahlungsschaltfläche klicken, und ob das Verhalten der Nutzeraktivierung des Browsers beibehalten wird, sodass die Google Pay API ein Zahlungsformular anzeigen kann. Prüfen Sie, ob das Google Pay-Zahlungsformular nicht von Pop-up-Blockern blockiert wird.

Wenn Sie den CARD Zahlungsmethodentyp mit PAN_ONLY Kartenauthentifizierung anfordern, führen Sie die folgenden Schritte aus, um den Test für gespeicherte Karten durchzuführen:

  1. Entfernen Sie gegebenenfalls alle gespeicherten Karten von pay.google.com.
  2. Kehren Sie zu Ihrer Integration zurück.
  3. Klicken Sie auf Google Pay.
  4. Prüfen Sie, ob die Option zum Hinzufügen einer Karte angezeigt wird.
  5. Fügen Sie eine Karte aus einem unterstützten Netzwerk hinzu, wie in parameters.allowedCardNetworks definiert.
  6. Prüfen Sie, ob die hinzugefügte Karte mit einem Netzwerksymbol in der Auswahl angezeigt wird.

Der folgende Test gilt nur für Chrome unter Android.

Wenn Sie den Zahlungsmethodentyp CARD mit CRYPTOGRAM_3DS Kartenauthentifizierung anfordern, führen Sie die folgenden Schritte aus, um den Android-Gerätetoken-Test durchzuführen:

  1. Prüfen Sie, ob der Aussteller Ihrer Karte unterstützt wird, und fügen Sie eine unterstützte Karte in der Google Pay Android-App hinzu.
  2. Kehren Sie zu Ihrer Integration zurück.
  3. Klicken Sie auf die Zahlungsschaltfläche Google Pay.
  4. Prüfen Sie, ob die hinzugefügte Karte mit dem Kartendesign in der Auswahl angezeigt wird.

Wenn Sie bestätigen, dass Ihr Zahlungsabwickler die 3D-Secure-Kartenauthentifizierung unterstützt, können Sie fortfahren, auch wenn Ihnen als Android-Nutzer oder Karteninhaber kein Android-Gerätetoken zur Verfügung steht.

Wenn Sie eine Versandadresse benötigen, testen Sie die Verarbeitung der Versandadresse in verschiedenen Fertigstellungszuständen, z. B.:

  • Variationen eines vollständigen Namens, der in strukturierte Felder geparst werden soll, z. B. „Max“, „Max Mustermann“ und „Erika Müller-Mustermann“.
  • Alle von der Google Pay API zurückgegebenen Adresszeilen genau parsen. Die Gesamtzahl der Adresszeilen kann die Anzahl der Adresszeilen übersteigen, die normalerweise in Ihrem Standard-Bezahlvorgang erfasst werden.
  • Prüfen Sie, ob die zurückgegebene Länderkomponente der Adresse mit den unterstützten Versandzielen Ihrer Website übereinstimmt. Wenn Sie Versandbeschränkungen festgelegt haben, testen Sie sie: Geben Sie eine nicht unterstützte Versandadresse ein, die in unserem Zahlungsformular nicht zulässig ist, und prüfen Sie, ob die Beschränkungen funktionieren.

Wenn Sie die Unterstützung für „Zahlungen autorisieren“ implementiert haben, prüfen Sie Folgendes:

  • Wenn eine Zahlungsauthentifizierung fehlschlägt, wird ein ERROR transactionState und PaymentDataError mit dem Intent PAYMENT_AUTHORIZATION zurückgegeben.

Wenn Sie die Unterstützung für dynamische Preisaktualisierungen implementiert haben, führen Sie die folgenden Schritte aus:

  1. Fügen Sie im Zahlungsformular eine Karte und Adressdetails hinzu.
  2. Aktualisieren Sie die Versandoptionen, die Bestellliste und den Gesamtpreis.
    3. Wichtig: Achten Sie darauf, dass der Gesamtpreis mit dem Transaktions betrag übereinstimmt. Andernfalls kann sich dies auf den Wert des Electronic Commerce Indicator (ECI) und die haftende Partei auswirken.
  3. Fügen Sie eine Versandadresse hinzu und wählen Sie sie aus.
  4. Aktualisieren Sie die Versandoptionen, die Bestellliste und den Gesamtpreis.
  5. Wählen Sie eine Versandoption aus.
  6. Aktualisieren Sie die Bestellliste und den Gesamtpreis.
  7. Prüfen Sie Ihre Ergebnisse:
    • Wenn für die Versandadresse keine Versandoptionen verfügbar sind, prüfen Sie, ob Sie PaymentDataError mit dem SHIPPING_ADDRESS Intent erhalten.
    • Wenn die ausgewählte Versandoption ungültig ist, prüfen Sie, ob Sie PaymentDataError mit dem SHIPPING_OPTION Intent erhalten.
    • Wenn die Zahlungsauthentifizierung fehlschlägt, prüfen Sie, ob Sie ERROR transactionState und PaymentDataError mit dem PAYMENT_AUTHORIZATION Intent erhalten.
Wenn Sie eine Telefonnummer benötigen, fordern Sie sie von der Rechnungsadresse an. Testen Sie dann, ob Sie die Telefonnummer in verschiedenen Formaten wie „+8005550100“, „18005550100“ und „(800) 555-0100“ gemäß den Datenstandards Ihrer Website parsen und speichern können.
Achten Sie darauf, dass Google Pay gleichwertig mit anderen Zahlungsmethoden von Drittanbietern angezeigt wird.
Für Nutzer, die zuvor beim Checkout Google Pay ausgewählt und Google Pay als bevorzugte Zahlungsmethode auf Ihrer Website angegeben haben, muss Google Pay als Standardzahlungsmethode für ihren nächsten Kauf festgelegt sein.
Dem Nutzer muss vor der Verarbeitung der Transaktion ein Endpreis angezeigt werden. Wenn der zu belastende Betrag aufgrund von Daten, die von der Google Pay API empfangen wurden, variiert, müssen Sie eine Bestätigungsseite mit einem Endpreis anzeigen.