1 Über Google Pay™

1.1 Was ist Google Pay

Logo

InfoTyp
Google Pay ist die schnelle und einfache Methode zum Bezahlen auf Webseiten, in Apps und in Geschäften mit den gespeicherten Karten in Ihrem Google-Konto. Ihre Zahlungsinformationen sind mit mehreren Sicherheitseben geschützt, so dass Sie einfach Geld versenden, Tickets speichern sowie Rückzahlungen empfangen können – alles an einem gemeinsamen und bequemen Ort.Zahlungen per Wallet

Hinweis: Bitte beachten Sie, dass Informationen zur Haftungsumkehr direkt bei ihrem Kreditkarten-Acquirer angefragt werden müssen. Da Computop nicht im direkten Vertragsverhältnis steht, muss Ihnen der Acquirer die Regularien pro Kartenmarke mitteilen.

1.2 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.

1.3 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.

1.4 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.

1.5 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 die First Cash Solution Support-Team: support@1cs.de.

2.    Falls Sie noch keine die First Cash Solution Merchant ID haben, bitten Sie um die Einrichtung dieser Identifikationsnummer für einen Händler auf der Plattform 1cs Online Bezahlsystem. Sie müssen die die First Cash Solution Merchant ID auch in der API von Google Pay verwenden.

Wenden Sie sich bitte an das die First Cash Solution Support-Team: support@1cs.de.

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’: ‘yourdie First Cash SolutionMerchantID’

}

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 das First Cash Solution Support-Team, um diesen Punkt zu überprüfen.

const allowedCardAuthMethods = [“PAN_ONLY”, “CRYPTOGRAM_3DS”];

d. Als Antwort von der Google Pay API sollten Sie ein Token etwa in folgender Form erhalten:

{

“signature”: “MEQCIC4z/QHSrzekRkkuk3vGYxBTBdNgEQl5XFHx0Wk5fFLIUAiB
3+q227havAJdagfGZaMXbefhatdJE7Df2qrIoKDv1Og==”,

“protocolVersion”: “ECv1”,

“signedMessage”: “{\”encryptedMessage\”:\”bOYRmExGeCsBrFqESt7kd9O1FN+vQZf2KG0UNYC8jNA+VVf9nQeK7l
DvU8k37cH+LOziJQkHNL2OxDHIk6GoRV1BrXprwBnAJR0O2VnCUH8lsqq0E
LwemeqW364Ir8cU/hDFzWNp+38H25JVDAMExZBKodMMTzUXXgyO+s5jOyA
l8jUhnAw3fTRPkefuYsE8NFK5tvcs4L29h87Zo7ot0/8XrUhXt9b/Fld1LEthkuPSN+K1eEFP7bseB6jjRdHnwYAdqiE3iOmh71pcDmNIyrlW
Rj74UJaszeerZW7DoZNx11oN7fouq/8fe1vklsr/e+y/RSG2nQMWg5yR/fMTfqCyabTDhJMvMM1Zhe91+dQ0/xi/zKRgsIhiongJUjYtoSNIjUHnMLRuVTKdjX50CCI1QOiBtr9h0bOLe
Phxw9cLYeU1KwCfYJyt28DBKCvaWFSbCl+dzNcZ9B83kv\”,\”ephemeralPublicKey\”:\”BFUju73/IT/KqnB/nc0W3BaL3BXFybrbYaPiMCKXIcg78PbslwV7MRUq3SpWEDEJT6pakL
Cvf34412HbDGCpsa4\u003d\”,\”tag\”:\”xIuCUWB2U6yWEfidsJpQaa+leU/kqS522JLOnrnk42g\u003d\”}”

}

Sie müssen den gesamten Token-String mittels Base64 verschlüsseln und ihn im Parameter TokenExt im 1cs Online Bezahlsystem einfügen.

1.6 Diagramm zum Prozessablauf

2 1cs Online Bezahlsystem-Schnittstelle

2.1 Definitionen

FormatBeschreibung
aalphabetisch
asalphabetisch mit Sonderzeichen
nnumerisch
analphanumerisch
ansalphanumerisch mit Sonderzeichen
nsnumerisch mit Sonderzeichen
boolBool’scher Ausdruck (true oder false)
3feste Länge mit 3 Stellen/Zeichen
..3variable Länge mit maximal 3 Stellen/Zeichen
enumAufzählung erlaubter Werte
dttmISODateTime (JJJJ-MM-TTThh:mm:ss)
AbkürzungBeschreibungKommentar
CNDBedingung (condition) 
MPflicht (mandatory)Wenn ein Parameter Pflicht ist, dann muss er vorhanden sein
OoptionalWenn ein Parameter optional ist, dann kann er vorhanden sein, ist aber nicht erforderlich
Cbedingt (conditional)Wenn ein Parameter bedingt ist, dann gibt es eine Bedingungsregel, die angibt, ob er Pflicht oder optional ist

Hinweis: Bitte beachten Sie, dass die Bezeichnungen der Parameter in Groß- oder Kleinbuchstaben zurückgegeben werden können.

2.2 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, rufen Sie folgende URL auf:

https://www.computop-paygate.com/googlepay.aspx

Hinweis: Aus Sicherheitsgründen lehnt das 1cs Online Bezahlsystem alle Zahlungsanfragen mit Formatfehlern ab. Bitte übergeben Sie deshalb bei jedem Parameter den korrekten Datentyp.

Die folgende Tabelle beschreibt die verschlüsselten Übergabeparameter für Google Pay. Die Tabelle beschreibt nur die Basisparameter. Es können auch alle Kreditkartenparameter (ohne Kreditkartendaten) einbezogen werden. Hierzu finden Sie weitere Informationen im Dokument Kreditkarten.

ParameterFormatCNDBeschreibung
MerchantIDans..30MHändlerID, die von der First Cash Solution vergeben wird. Dieser Parameter ist zusätzlich auch unverschlüsselt zu übergeben.
TransIDans..64Mhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss
RefNrns..30CEindeutige Referenznummer des Händlers Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie (“Umlaute”, …) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, …).
Amountn..10MBetrag in der kleinsten Währungseinheit (z.B. EUR Cent) Bitte wenden Sie sich an den Helpdesk, wenn Sie Beträge < 100 (kleinste Währungseinheit) buchen möchten.
Currencya3MWährung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Hier eine Übersicht: Währungstabelle
MACan64MHash Message Authentication Code (HMAC) mit SHA-256-Algorithmus. Details finden Sie hier: HMAC-Authentisierung (Anfrage) HMAC-Authentisierung (Notify)
UserDataans..1024OWenn beim Aufruf angegeben, übergibt das 1cs Online Bezahlsystem die Parameter mit dem Zahlungsergebnis an den Shop
RTFa1OEinrichtung der Vereinbarung für hinterlegte Zugangsdaten (Karteninhaber stimmt zu, dass seine Kartendaten für weitere Transaktionen gespeichert werden dürfen).
Captureans..6OBestimmt Art und Zeitpunkt der Buchung (engl. Capture). AUTO: Buchung sofort nach Autorisierung (Standardwert). MANUAL: Buchung erfolgt durch den Händler – in der Regel die Buchung zum Zeitpunkt der Warenauslieferung bzw. Leistungserbringung. <Zahl>: Verzögerung in Stunden bis zur Buchung (ganze Zahl; 1 bis 696).
OrderDescans..64MBeschreibung der gekauften Waren, Einzelpreise etc.
URLNotifyans..256OVollständige URL, die das Paygate aufruft, um den Shop zu benachrichtigen. Die URL darf nur über Port 443 aufgerufen werden. Sie darf keine Parameter enthalten: Nutzen Sie stattdessen den Parameter UserData. Allgemeine Hinweise: Wir empfehlen, den Parameter “response=encrypt” zu verwenden, um eine verschlüsselte Antwort vom 1cs OBS zu erhalten Betrüger könnten das verschlüsselte DATA-Element kopieren, welches an URLFailure gesendet wurde, und betrügerisch dasselbe DATA an URLSuccess/URLNotify senden. Überprüfen Sie daher unbedingt den “code”-Wert des DATA-Elements. Nur eine Antwort mit “code=00000000” sollte als erfolgreich angesehen werden.
TokenExtans..6000MGoogle Pay Token als JSON-String im Base64-Format
{
“signature”: “MEQCIC4z/QHSrzekRkkuk3vGYxBTBdN
gEQl5XFHx0Wk5fFLIUAiB3+q227havAJdagfGZaMXbefhatdJ
E7Df2qrIoKDv1Og==”,  “protocolVersion”: “ECv1”,  “signedMessage”: “{\”encryptedMessage\”:\”bOYRmE
xGeCsBrFqESt7kd9O1FN+vQZf2KG0UNYC8jNA
+VVf9nQeK7lDvU8k37cH+LOziJQkHNL2OxDHIk6GoRV1BrX
prwBnAJR0O2VnCUH8lsqq0ELwemeqW364Ir8cU/hDFzWNp+
38H25JVDAMExZBKodMMTzUXXgyO+s5jOyAl8jUhnAw3fTRP
kefuYsE8NFK5tvcs4L29h87Zo7ot0/8XrUhXt9b/Fld1LEth
kuPSN+K1eEFP7bseB6jjRdHnwYAdqiE3iOmh7
1pcDmNIyrlWRj74UJaszeerZW7DoZNx11oN7fouq/8fe1vkl
sr/e+y/RSG2nQMWg5yR/fMTfqCyabTDhJMvMM1Zhe91+dQ0/xi/zKRgsIhiongJUjYtoSNIjUHnMLRuVTKdjX50CCI1QOi
Btr9h0bOLePhxw9cLYeU1KwCfYJyt28DBKCvaWFSbCl+dzN
cZ9B83kv\”,\”ephemeralPublicKey\”:\”BFUju73/IT/KqnB/nc0W3BaL3BXFybrbYaPiMCKXIcg78PbslwV7MRUq3
SpWEDEJT6pakLCvf34412HbDGCpsa4\u003d\”,\”tag\”:\”xIuCUWB2U6yWEfidsJpQaa+leU/kqS522JLOnrnk4
2g\u003d\”}” }
Channela..10OKanal, über den die Bestellung abgewickelt wird.
Erlaubt sind die Werte WEBSITE und MOBILE_APP

Parameter für Google Pay

Folgende Tabelle beschreibt die Ergebnis-Parameter, die das 1cs Online Bezahlsystem als Antwort zurückgibt:

hinweis  es können jederzeit neue Parameter hinzugefügt bzw. die Reihenfolge geändert werden

hinweis  die Parameter (z.B. MerchantId, RefNr) sollten nicht auf Groß-/Kleinschreibung geprüft werden 

ParameterFormatCNDBeschreibung
MIDans..30MHändlerID, die von der First Cash Solution vergeben wird
PayIDan32MVom 1cs Online Bezahlsystem vergebene ID für die Zahlung, z.B. zur Referenzierung in Batch-Dateien. Diese ID bezieht sich auf die Kreditkarten-Transaktion, es sei denn, es kommt bereits bei der Google-Pay-Transaktion zu einem Fehler.
XIDan32MVom 1cs Online Bezahlsystem vergebene ID für alle einzelnen Transaktionen (Autorisierung, Buchung, Gutschrift), die für eine Zahlung durchgeführt werden
TransIDans..64MIhre eigene TransaktionsID, die für jede Zahlung eindeutig sein muss
RefNrns..30OEindeutige Referenznummer des Händlers.
Es sind ausschließlich ASCII-Zeichen erlaubt. Sonderzeichen wie (“Umlaute”, …) sind nicht erlaubt und müssen ggf. durch ASCII-Zeichen ersetzt werden (z.B. ü → ue, é → e, …).
UserDataans..1024OWenn beim Aufruf angegeben, übergibt das 1cs Online Bezahlsystem die Parameter mit dem Zahlungsergebnis an den Shop
Statusa..50MOK (URLSuccess) oder FAILED (URLFailure)
Descriptionans..1024MNähere Beschreibung bei Ablehnung der Zahlung. Bitte nutzen Sie nicht den Parameter Description sondern Code für die Auswertung des Transaktionsstatus!
Coden8MFehlercode gemäß 1cs Online Bezahlsystem Antwort-Codes (Fehlercodes)
schemeReferenceIDans..64CKartensystemspezifische Transaktions-ID, die für nachfolgende Zahlungen mit hinterlegten Daten, verzögerte Autorisierungen und Wiedereinreichungen erforderlich ist.

Ergebnis-Parameter für Google Pay

2.3 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.

2.4 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.