Checkliste für die Einbindung

Mit der folgenden Checkliste können Sie prüfen, ob Sie alle erforderlichen Schritte in Ihrer Webintegration ausgeführt haben.

Informationen zur Testumgebung

Eine Google Pay API-Testkonfiguration gibt keine aktiven und abrechenbaren Zahlungsinformationen zurück. Sie ermöglicht es Ihnen, Elemente Ihres Kaufvorgangs zu testen. Folgende Elemente können getestet werden:

  • Bestätigungsseiten
  • Receipts
  • Rechnungsadresse (optional)
  • Abrechnungstelefonnummer (optional)
  • Versandadresse (optional)
  • E-Mail-Adresse (optional)

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

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

Mit der Entwicklerkonsole Ihres Browsers testen

Testen Sie Ihre Website mit der neuesten Version eines unterstützten Browsers. Ö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.

Nachdem Sie loadPaymentData() aufgerufen haben, werden möglicherweise zusätzliche Fehler im Dialogfeld für die Google-Zahlungsauswahl angezeigt. Wenn Sie nach dem Anzeigen der Fehlermeldung auf Weiter oder OK klicken, werden möglicherweise zusätzliche Details zum 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 bestimmten Anzahl von Ländern. Wenn die tokenisierten 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. Wenn Ihre Zahlungsmethode in Ihrem Land und von Ihrer ausstellenden Bank unterstützt wird, testen Sie mit einer Karte, die in der Google Pay App gespeichert ist.

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

Hier ein Codebeispiel:

adb logcat -s WalletMerchantError

Integration testen

Bevor Sie Ihre Integration zur Validierung bei Google einreichen, müssen Sie sicherstellen, dass Sie die Exit-Kriterien für die folgenden Funktions- und Branding-Prüfungen erfüllt haben.PaymentsClientTEST

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 selektiv auf Grundlage von Risikokriterien auslösen, müssen Sie dieselben Risikokriterien verwenden, um 3D Secure für Google Pay-PAN-Transaktionen mit PAN_ONLY auszulösen.
Lesen Sie unsere Nutzungsbedingungen und bestätigen Sie, dass Sie sie akzeptieren. Für die Registrierung mit der Google Pay API muss Ihre E‑Mail-Adresse mit einem Google-Konto verknüpft sein. Vorzugsweise verwenden Sie eine geschäftliche E‑Mail-Adresse, die mit Ihrer Unternehmensdomain verknüpft ist, z. B. „admin@meinepersoenlichedomain.com“. Wählen Sie im Ablauf zum Erstellen eines Google-Kontos die Option 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 empfangenen Daten nur zur Verarbeitung von Transaktionen. Für alle anderen Anwendungsfälle ist eine separate, ausdrückliche Einwilligung des Nutzers erforderlich.
Prüfen Sie, welche Kartennetzwerke und Methoden zur Kartenauthentifizierung von Ihrem Zahlungsabwickler in Ihrem Land akzeptiert werden.
Wenn Sie eine DIRECT-Integration tokenizationSpecification type abschließen, 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-Bescheinigung kann von einem Drittanbieter oder einem vom PCI Security Standards Council zertifizierten qualifizierten Sicherheitsgutachter (Qualified Security Assessor, QSA) eingereicht und von einem zugelassenen Anbieter oder qualifizierten Gutachter genehmigt werden.

2. Markentests

Verwenden Sie unsere genehmigten Assets und halten Sie sich an alle Elemente unserer Markenrichtlinien.
Die Google Pay-Zahlungsschaltfläche darf erst angezeigt werden, nachdem auf Ihrer Website mit der Funktion isReadyToPay() bestätigt wurde, dass der Nutzer über Google Pay bezahlen kann.
Prüfen Sie, ob 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

Prüfen Sie, ob loadPaymentData() synchron aufgerufen wird, wenn Sie auf die Google Pay-Zahlungsschaltfläche klicken, und ob das Nutzeraktivierungsverhalten des Browsers beibehalten wird, sodass über die Google Pay API ein Zahlungsformular angezeigt werden kann. Prüfen Sie, ob das Google Pay-Zahlungsblatt von Pop-up-Blockern blockiert wird.

Wenn Sie den Zahlungsmethodentyp CARD mit der 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 aus pay.google.com.
  2. Kehren Sie zu Ihrer Integration zurück.
  3. Klicken Sie auf Google Pay.
  4. Prüfe, 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 Netzwerklogo in der Auswahl angezeigt wird.

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

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

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

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

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

  • Varianten eines vollständigen Namens, die in strukturierte Felder geparst werden sollen, z. B. „Max“, „Max Mustermann“ und „Erika Mustermann Schmidt“.
  • Alle von der Google Pay API zurückgegebenen Adresszeilen müssen korrekt geparst werden. Die Gesamtzahl der Adresszeilen kann die Anzahl der Adresszeilen überschreiten, die normalerweise in Ihrem Standard-Checkout-Ablauf 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 angegeben haben, testen Sie sie: Geben Sie eine nicht unterstützte Versandadresse ein, die in unserem Zahlungsblatt nicht zulässig ist, und prüfen Sie, ob die Beschränkungen funktionieren.

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

  • Wenn die Zahlungsauthentifizierung fehlschlägt, wird ein ERROR transactionState und PaymentDataError mit dem PAYMENT_AUTHORIZATION-Intent 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: Der Gesamtpreis muss mit dem Transaktionsbetrag übereinstimmen. Andernfalls kann sich dies auf den ECI-Wert (Electronic Commerce Indicator) und die haftende Partei auswirken.
  4. Fügen Sie eine Versandadresse hinzu und wählen Sie sie aus.
  5. Aktualisieren Sie die Versandoptionen, die Bestellliste und den Gesamtpreis.
  6. Wählen Sie eine Versandoption aus.
  7. Aktualisieren Sie die Bestellliste und den Gesamtpreis.
  8. Ergebnisse validieren:
    • Wenn für die Versandadresse keine Versandoptionen verfügbar sind, prüfen Sie, ob Sie PaymentDataError mit dem Intent SHIPPING_ADDRESS erhalten.
    • Wenn die ausgewählte Versandoption ungültig ist, prüfen Sie, ob Sie PaymentDataError mit dem Intent SHIPPING_OPTION erhalten.
    • Wenn die Zahlungsauthentifizierung fehlschlägt, prüfen Sie, ob Sie ERROR transactionState und PaymentDataError mit der PAYMENT_AUTHORIZATION-Absicht erhalten.
Wenn Sie eine Telefonnummer benötigen, fordern Sie sie über die Rechnungsadresse an. Testen Sie dann, ob Sie die Telefonnummer in verschiedenen Formaten wie „+8005550100“, „18005550100“ und „(800) 555-0100“ parsen und gemäß den Datenstandards Ihrer Website speichern können.
Google Pay muss gleichwertig mit anderen Drittanbieter-Zahlungsmethoden angezeigt werden.
Wenn Nutzer Google Pay zuvor an der Kasse 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 werden.
Dem Nutzer muss vor der Verarbeitung der Transaktion ein Endpreis angezeigt werden. Wenn sich der abzubuchende Betrag aufgrund von Daten, die über die Google Pay API empfangen wurden, geändert hat, müssen Sie eine Bestätigungsseite mit einem Endpreis anzeigen.