Anpassung von Google Pay
Die direkte Einbindung der Google Pay API ermöglicht es Ihnen, dem Kunden den Button für die Zahlungsart für die Autorisierung anzubieten. Sie können jedoch Ihren Code erweitern, um die Google Pay-Zahlungsseite an zusätzliche Arbeitsgänge anzupassen. So muss sich der Kunde zum Beispiel nicht für den Express-Checkout oder die Möglichkeit des Checkouts als Gast im Shop registrieren. Stattdessen können sie Ihren Kauf abschließen, indem sie die Daten verwenden, welche in Ihren Google-Accounts gespeichert sind. Fügen Sie Google Pay zu den Seiten für Ihre Waren oder Produkte hinzu und aktivieren Sie einen schnellen Checkout für Ihre Kunden. Dies reduziert die Anzahl der Schritte beim Checkout und erhöht die Konversionsrate bei Käufen einzelner Waren.
Wenn Sie Google Pay für Ihren Warenkorb oder Ihre Produktseite anbieten, können Sie dem Kunden die folgenden Verbesserungen anbieten:
- Geben Sie den Unternehmensnamen nach dem Wort Bezahlen auf derselben Zeile an, wie den Gesamtbetrag.
- Eine komfortable Übersicht aller Waren im Warenkorb beinhaltet zusätzliche Gebühren, Preisnachlässe, ausstehende Kosten und zusätzliche Spenden.
- Einholen von Informationen zu den Rechnungs- und Liefer- informationen von der Zahlungsseite.
- Lassen Sie Kunden die Versandart auf der Zahlungsseite auswählen.
Alle diese Anpassungen werden erleichtert, indem Sie das order-Objekt in Ihrem Aufruf zum Zahlungsauftrag einsetzen.
Außerdem können Sie die Google Pay-Buttons auf der Grundlage der Anforderungen Ihres Geschäfts, der gewünschten Button-Typen, Farben und Anforderungen an die Anzeige einrichten. Die Anpassungen des Button werden eingerichtet, indem Sie das button-Objekt in Ihrem Aufruf zum Zahlungsauftrag einsetzen.
Unternehmensnamen setzen
Falls Sie einrichten wollen, dass Ihr Händler- oder Unternehmensname auf der Zahlungsseite angezeigt wird, können Sie das Attribut order.merchantName einsetzen. Setzen Sie denselben Unternehmensnamen ein, den die Leute sehen werden, wenn sie die Belastung auf Ihrem Kontoauszug oder Ihrer Kreditkartenabrechnung sehen. Dies gibt ihnen die Gewissheit, dass die Zahlung an die richtige Adresse geht. Dazu setzen Sie den Parameter transaction.dynamic_descriptor während der Buchung, wenn Sie die /payment-API (oder die /authorize-API) aufrufen.
Angenommen, das Attribut order.merchantName fehlt im Zahlungsaufruf. Novalnet zeigt dann standardmäßig den Namen der Domain an, in welcher Google Pay verarbeitet wird. Dies ist z.B. für diese Seite developer.novalnet.de.
Einzelposten anzeigen
Sie können das Attribut order.lineItems setzen, um eine detaillierte Zusammenfassung der Einzelposten der Bestellung in Ihrem Aufruf zum Zahlungsauftrag anzuzeigen. Gemäß der Googel API können Sie die Einzelposten anhand der Typen "SUBTOTAL", "LINE_ITEM", and "TAX" kategorisieren. Daher ergibt es einen Sinn, alle gekauften Waren in eine “subtotal”-Eintrag zu packen und zusätzliche Einträge für Versand, Steuern, Preisnachlässe etc. hinzuzufügen, falls benötigt.
Stellen Sie den Gesamtbetrag separat zur Verfügung, im Attribut transaction.amount. Einzelposten sind im API-Aufruf nicht Pflicht, dürfen jedoch nicht leer sein, wenn sie vorhanden sind.
Rechnungsdaten des Kunden einholen
Falls Sie das Attribut order.billing.requiredFields in Ihrem Aufruf zum Zahlungsauftrag angeben, fordert Google die Kunden auf, ihre Rechnungsadresse auf der Zahlungsseite einzugeben oder auszuwählen. Abhängig von der Erstellung Ihres Kundenkontos können Sie das Attribut requiredFields anpassen und nur dann verlangen, wenn es wesentlich ist. Die eingegebenen Daten stehen dann in der Rückmeldung zur Autorisierung im Attribut order.billing.contact zur Verfügung, welches an den onProcessCompletion-Callback weitergegeben wird.
Informationen zur Lieferung verarbeiten
Anders als bei den Kontaktdaten für die Rechnung, kann das Einholen von Lieferinformationen einige Änderungen im Zahlungsaufruf und in der Verarbeitung auslösen. Zum Beispiel muss, nachdem der Kunde die Lieferadresse auf der Zahlungsseite eingegeben hat, überprüft werden, ob Sie Lieferungen in diese Regionen durchführen. Außerdem könnte dies eine Änderung der Steuern erzwingen, welche den Gesamtbetrag ändert. Aufgrund dieser Anforderungen, könnte die Verarbeitung der Lieferinformationen zusätzliche Callbacks notwendig machen, onShippingContactChange und onShippingMethodChange.
Daten zur Lieferung vom Kunden einholen
Auf dem gleichen Weg, auf den Sie die Rechnungsinformation einholen, können Sie auch Daten zur Lieferung in ihrem Aufruf zum Zahlungsauftrag anfordern. Google fordert die Nutzer auf, ihre Lieferadresse auf der Zahlungsseite anzufordern oder auszuwählen. Die eingegebenen Lieferdaten stehen Ihnen dann in der Rückmeldung zur Autorisierung in order.shipping.contact zur Verfügung und werden an den onProcessCompletion-Callback weitergegeben.
Der unter onShippingContactChange im Zahlungsauftrag registrierte Callback wird aufgerufen, wenn die Kunden eine Lieferadresse auf der Zahlungsseite auswählen. Der Callback ermöglicht es Ihnen, die Versandarten und Informationen zu Transaktionen auf der Grundlage der ausgewählten Lieferadresse dynamisch zu aktualisieren.
Die Callback-Funktion sollte zwei Argumente haben: Das erste, um den eingegebenen Kontakt für die Lieferung entgegenzunehmen und das zweite, um die aktualisierten Transaktionsinformationen an die Zahlungsseite zurückzugeben. Die Korrektur der Informationen zur Transaktion ist optional und davon abhängig, wie Sie die Lieferung verarbeiten.
Beachten Sie bitte, dass Sie, wenn Sie die Versandoptionen nur auf der Grundlage des Callbacks von onShippingContactChange anbieten, anstatt diese im Aufruf zum Zahlungsauftrag zu setzen, dann müssen Sie diesen Sachverhalt vorher ankündigen, indem Sie das Attribut order.shipping.methodsUpdatedLater auf den Wert true setzen.
Einrichtung der angebotenen Versandarten
Sie können Ihre Nutzer wählen / Änderungen vornehmen lassen, indem Sie verschiedene Versandoptionen auf der Google Pay-Zahlungsseite anbieten. Machen Sie dazu von dem Attribut order.shipping.methods Gebrauch, um die Versandoptionen wie im Beispielcode unten weiterzugeben. Außer dass Sie die Versandoptionen dem Kunden zur Auswahl anbieten können Sie auch die Standard-Versandoption festlegen, indem Sie das optionale Attribut order.shipping.defaultIdentifier setzen.
Der im Zahlungsaufruf registrierte Callback onShippingMethodChange wird aufgerufen, wenn der Kunde eine Versandart auf der Zahlungsseite ändert. Dieser Callback ermöglicht es Ihnen die Transaktionsinformationen auf der Grundlage der gewählten Versandart dynamisch zu aktualisieren.
Die Callback-Funktion sollte zwei Argumente haben: Das erste, um die eingegebene Versandart entgegenzunehmen und das zweite, um die aktualisierten Transaktionsinformationen an die Zahlungsseite zurückzugeben. Die Korrektur der Informationen zur Transaktion ist optional und davon abhängig, wie Sie die Lieferung verarbeiten.
Die gewählte Versandart steht Ihnen dann in der Rückmeldung zur Autorisierung zur Verfügung, im Attribut order.shipping.method , onProcessCompletion-Callback weitergegeben wird.
Zahlungsbutton anpassen
Das Einrichten des Stils Ihres Zahlungsbuttons beinhaltet die Änderung der Texte des Buttons auf der Grundlage des Sprachraums Ihres Kunden und das Setzen der Farbe, des Typs und der Abmessungen. Folgen Sie am besten den Markenrichtlinien von Google um den Zahlungsbutton demgemäß anzupassen.
Beispiel für den Aufruf und die Rückmeldung zur Anpassung der Zahlungsseite
Die gesamte Anfrage zur Anpassung mit den Attributen order und Button des Aufrufs für den Zahlungsauftrag ist unten aufgelistet. Das Beispiel darunter enthält eine vollständige Anfrage zur Anpassung für Google Pay.
Jeder Parameter ist mit Attributen versehen Pflichtfeld, Bedingungsabhängig, Freiwillig. Auf der Grundlage Ihrer Anforderungen können Sie diese Parameter entsprechend einsetzen.
Vorführung
Das Folgende führt ein grundlegendes Beispiel des Google-Pay-Buttons in Aktion vor.