Wie es funktioniert
Wenn ein Nutzer auf die Schaltfläche von Google Pay tippt, sieht er eine Zahlungsseite. Sie zeigt die in seinem Google-Konto hinterlegten Zahlungsmethoden sowie optionale Felder wie eine Lieferadresse an. Benutzer können schnell eine Zahlungsmethode auswählen und gegebenenfalls eine Lieferadresse mitteilen oder können neue Informationen hinzufügen.
Hinweis: Weitere Informationen zur Button-Lösung für Google Pay finden Sie unter https://support.computop.com/hc/de/articles/4559076653970-Apple-Pay-und-Google-Pay-Button-L%C3%B6sung-PaySSL-aspx?source=search.
In-App-Zahlung
Die API von Google Pay ermöglicht den schnellen und einfachen Checkout innerhalb der App und bietet Ihnen bequemen Zugang zu hunderten Millionen Karten, die in den Google-Konten weltweit gespeichert sind.
Obige Screenshots zeigen einen empfohlenen Kaufablauf in Google Pay für einen Warenkorb.
Diese Richtlinien helfen Ihnen bei der Implementierung von Google Pay in ihre Apps: https://developers.google.com/pay/api/android/guides/brand-guidelines.
Zahlung im Internet
Die API von Google Pay ermöglicht den schnellen und einfachen Checkout auf Ihrer Webseite und bietet Ihnen bequemen Zugang zu hunderten Millionen Karten, die in den Google-Konten weltweit gespeichert sind.
Obige Screenshots zeigen einen empfohlenen Kaufablauf in Google Pay für einen Warenkorb.
Diese Richtlinien helfen Ihnen bei der Referenzierung der Marke Google Pay auf Ihren Webseiten: https://developers.google.com/pay/api/web/guides/brand-guidelines.
Einrichtung Schritt für Schritt
Wenn Sie sich zur Unterstützung von Google Pay entschieden haben, sind vorab einige Schritte auszuführen. Diese Anleitung betrifft sowohl In-App- als auch Internet-Zahlungen.
1. Prüfen Sie, ob Ihr Acquirer Google Pay für die betreffenden Kartennetzwerke unterstützt und die Android Geräte-Token unterstützt.
Diese Informationen erhalten Sie vom Computop Support-Team: Computop Helpdesk.
2. Falls Sie noch keine Computop Merchant ID haben, bitten Sie um die Einrichtung dieser Identifikationsnummer für einen Händler auf der Plattform Computop Paygate. Sie müssen die Computop Merchant ID auch in der API von Google Pay verwenden.
Wenden Sie sich bitte an das Computop Support-Team: Computop Helpdesk.
3. Integrieren Sie die Google Pay API: https://developers.google.com/pay/api/.
Apps: https://developers.google.com/pay/api/android/overview
Webseiten: https://developers.google.com/pay/api/web/overview
a. Als Methode zur Tokenisierung der Zahlung wählen Sie “GATEWAY” mit folgenden Werten:
const tokenizationSpecification = { type: “PAYMENT GATEWAY”, parameters: { 'gateway': 'computop', 'gatewayMerchantId': 'yourComputopMerchantID' } |
b. Für die unterstützten Zahlungskartennetzwerke wählen Sie jene aus, die Ihr Acquirer unterstützt:
const allowedCardNetworks = ["AMEX", "DISCOVER", "JCB", "MASTERCARD", "VISA"]; |
c. Die Google Pay API kann hinterlegte Karten von Google.com (PAN_ONLY) und/oder ein Geräte-Token von einem Android-Gerät zurückgeben, das mit einem 3-D Secure Kryptogramm (CRYPTOGRAM_3DS) authentisiert wurde.
Definieren Sie CRYPTOGRAM_3DS bitte nur, wenn Ihr Acquirer diese Funktionalität unterstützt. Wenden Sie sich gegebenenfalls an Computop Helpdesk, um diesen Punkt zu überprüfen.
Beschreibung GooglePay-Authentifizierungsmethoden:
PAN_ONLY – Authentifizierungsmethode über Nicht-Android-Geräte.
Bitte beachten Sie, dass es erforderlich ist, den 3DS2 Server-zu-Server Prozess zu befolgen, wenn Sie sich innerhalb des EWR befinden.
CRYPTOGRAM_3DS - Authentifizierungsmethode über ein Android-Gerät.
Diese Zahlungen sind in der Google Pay-Brieftasche bereits stark kundenauthentifiziert und daher mit der PSD2 SCA-Verordnung konform.
const allowedCardAuthMethods = ["PAN_ONLY", "CRYPTOGRAM_3DS"];
Wenn Sie im EWR-Raum arbeiten, definieren Sie bitte nur CRYPTOGRAM_3DS, da diese Zahlungen im Google-Pay-Wallet bereits einer starken Kundenauthentifizierung unterliegen und daher konform zu PSD2 SCA sind.
Anmerkung: Wenn Sie als Antwort „Soft Decline“ erhalten, müssen Sie die Zahlung mit 3-D Secure-Authentifizierung neu starten und Händler müssen die gesamte 3D-Secure-Logik durch Server-zu-Server Integration implementieren. Der erste Auslöser zum Starten der 3D-Secure-Authentifizierung ist der zusätzliche Anforderungsparameter MsgVer=2.0. Bitte stellen Sie uns außerdem die JSON-Daten „Cardholdername“, „BrowserInfo“, „billToCustomer“ und „billingAddress“ zur Verfügung, wie in Kreditkarten - Schnittstelle Server-zu-Server beschrieben
d. Als Antwort von der Google Pay API sollten Sie ein Token etwa in folgender Form erhalten:
{
"signature": "MEQCIC4z/QHSrzekRkkuk3vGYxBTBdNgEQl5XFHx0Wk5fFLIUAiB3+q227havAJdagfGZaMXbefhatdJE7Df2qrIoKDv1Og==",
"protocolVersion": "ECv1",
"signedMessage": "{\"encryptedMessage\":\"bOYRmExGeCsBrFqESt7kd9O1FN+vQZf2KG0UNYC8jNA+VVf9nQeK7lDvU8k37cH+LOziJQkHNL2OxDHIk6GoRV1BrXprwBnAJR0O2VnCUH8lsqq0ELwemeqW364Ir8cU/hDFzWNp+38H25JVDAMExZBKodMMTzUXXgyO+s5jOyAl8jUhnAw3fTRPkefuYsE8NFK5tvcs4L29h87Zo7ot0/8XrUhXt9b/Fld1LEthkuPSN+K1eEFP7bseB6jjRdHnwYAdqiE3iOmh71pcDmNIyrlWRj74UJaszeerZW7DoZNx11oN7fouq/8fe1vklsr/e+y/RSG2nQMWg5yR/fMTfqCyabTDhJMvMM1Zhe91+dQ0/xi/zKRgsIhiongJUjYtoSNIjUHnMLRuVTKdjX50CCI1QOiBtr9h0bOLePhxw9cLYeU1KwCfYJyt28DBKCvaWFSbCl+dzNcZ9B83kv\",\"ephemeralPublicKey\":\"BFUju73/IT/KqnB/nc0W3BaL3BXFybrbYaPiMCKXIcg78PbslwV7MRUq3SpWEDEJT6pakLCvf34412HbDGCpsa4\\u003d\",\"tag\":\"xIuCUWB2U6yWEfidsJpQaa+leU/kqS522JLOnrnk42g\\u003d\"}"
}
Sie müssen den gesamten Token-String mittels Base64 verschlüsseln und ihn im Parameter TokenExt im Paygate einfügen.
Diagramm zum Prozessablauf
Google Pay process flow
Paygate-Schnittstelle
a alphabetisch as alphabetisch mit Sonderzeichen n numerisch an alphanumerisch ans alphanumerisch mit Sonderzeichen ns numerisch mit Sonderzeichen bool Bool’scher Ausdruck (true oder false) 3 feste Länge mit 3 Stellen/Zeichen ..3 variable Länge mit maximal 3 Stellen/Zeichen enum Aufzählung erlaubter Werte dttm ISODateTime (JJJJ-MM-TTThh:mm:ss) CND Bedingung (condition) M Pflicht (mandatory) O optional C bedingt (conditional) Hinweis: Bitte beachten Sie, dass die Bezeichnungen der Parameter in Groß- oder Kleinbuchstaben zurückgegeben werden können.Definitionen
Datenformate
Format Beschreibung Abkürzungen
Abkürzung Beschreibung Kommentar Wenn ein Parameter Pflicht ist, dann muss er vorhanden sein Wenn ein Parameter optional ist, dann kann er vorhanden sein, ist aber nicht erforderlich Wenn ein Parameter bedingt ist, dann gibt es eine Bedingungsregel, die angibt, ob er Pflicht oder optional ist
Aufruf der Schnittstelle
Bei einer Kreditkartenzahlung über Google Pay werden zwei Transaktionen angelegt. In der Google-Pay-Transaktion werden zunächst die benötigten Kreditkartendaten ermittelt und dann automatisch die eigentliche Kreditkarten-Transaktion ausgeführt. Diese erfolgt über eine Server-zu-Server-Verbindung und unterstützt dabei alle Möglichkeiten der üblichen Kreditkartentransaktionen. Im Unterschied dazu übergeben Sie jedoch nicht die Ihnen unbekannten Kreditkartendaten, sondern den von Google Pay generierten Token, der die benötigten Kreditkartendaten in verschlüsselter Form enthält.
Um eine Kreditkartenzahlung über Google Pay abzuwickeln, verwenden Sie bitte folgende URL:
https://www.computop-paygate.com/googlepay.aspx |
Hinweis: Aus Sicherheitsgründen lehnt das Paygate alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp. Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter:
Es können auch alle Kreditkartenparameter (ohne Kreditkartendaten) einbezogen werden. Hierzu finden Sie weitere Informationen im Dokument Kreditkarten.
Parameter für Google Pay
Die folgende Tabelle beschreibt die Parameter, die das Paygate als Antwort zurückgibt:
es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden
Ergebnis-Parameter für Google Pay
Buchung / Gutschrift /Storno
Buchungen, Gutschriften und Stornos beziehen sich nicht auf die Transaktion bei Google Pay, sondern direkt auf die Kreditkarten-Transaktion. Hierzu finden Sie weitere Informationen im Dokument Kreditkarten.
Batch-Nutzung der Schnittstelle
Buchungen, Gutschriften und Stornos über Batch beziehen sich nicht auf die Transaktion bei Google Pay, sondern direkt auf die Kreditkarten-Transaktion. Hierzu finden Sie weitere Informationen im Dokument Kreditkarten.