> ## Documentation Index
> Fetch the complete documentation index at: https://dokumentation.websale.de/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Pay

> Wie Sie die Zahlungsart Google Pay über den Payment-Service-Provider Computop in WEBSALE V8s einbinden und testen.

Google Pay ist die Geldbörse im Google-Konto. Der Käufer bezahlt mit einer Karte, die dort hinterlegt ist, ohne ihre Daten einzugeben. Weitergegeben wird nicht die Kartennummer, sondern eine verschlüsselte Ersatznummer, die auf dem Gerät selbst gar nicht erst gespeichert wird.

In WEBSALE V8s läuft Google Pay über den Payment-Service-Provider **Computop**, technisch auf demselben Weg wie die Kreditkartenzahlung und [Apple Pay](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/apple-pay.md). Sie brauchen deshalb einen Händlervertrag mit Computop, bevor irgendetwas davon eingerichtet werden kann.

Wegweiser: [Computop](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/computop.md)

## Wie der Bezahlvorgang abläuft

![Ablauf Googlepay Diagramm](https://mintcdn.com/websaleag-44ee7ea6/LS0r3yDDNtTzNzIH/images/ablauf-googlepay-diagramm.jpg?fit=max\&auto=format\&n=LS0r3yDDNtTzNzIH\&q=85\&s=f174704190d9be60526ff75418ff5951)

Der Käufer wählt Google Pay auf der Zahlungs- und Versandartenseite wie jede andere Zahlungsart. Erst beim Klick auf „Zahlungspflichtig bestellen" verlässt er den Shop.

1. Der Shop leitet ihn auf die Zahlungsseite von Computop weiter.
2. Dort meldet er sich mit seinem Google-Konto an, sofern er es nicht ohnehin schon ist.
3. Er bestätigt die Zahlung. Zusätzliche Zahlungsdaten gibt er nicht ein.
4. Computop schickt ihn zurück auf die Bestelleingangsbestätigung `ws_confirm.htm`.

## Schritt 1: Freischaltung durch WEBSALE

Google Pay muss von WEBSALE freigeschaltet werden. Dafür brauchen wir die Zugangsdaten, die Sie von Computop bekommen, unter anderem UID, HMAC-Schlüssel und MerchantID. Wenden Sie sich an Ihren WEBSALE-Ansprechpartner.

> [!WARNING]
>
> Ohne diese Freischaltung bleibt Google Pay unsichtbar, auch wenn Sie den Abschnitt in der `shop.config` vollständig angelegt und `Allow = yes` gesetzt haben. Der Shop schaltet die Zahlungsart in diesem Fall von sich aus wieder ab. Wenn Google Pay nach der Konfiguration nicht erscheint, ist die Freischaltung der erste Punkt, den Sie prüfen sollten.

Nutzen Sie schon die Kreditkartenzahlung oder Apple Pay über Computop mit einem eigenen, angepassten Computop-Template, lesen Sie vorher den Abschnitt zur Template-Anpassung weiter unten.

## Schritt 2: Zahlungsart anlegen

Legen Sie den Abschnitt `<PaymentGooglePay-Txt>` in der `shop.config` an.

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<PaymentGooglePay-Txt>
   Allow            = yes
   TestMode         = yes
   Name             = Google Pay
   NameSuffix       = Bezahlen Sie schnell und einfach mit Google Pay.
   Img              = logo-google-pay.png
   RadioOnClick     = selectPayment('~ID~');
   ImgOnClick       = selectPaymentImage('~ID~');
   DelivererID-List = standard,express

   ComputopClearingLinkValidForSeconds = 600
</PaymentGooglePay-Txt>
```

Die allgemeinen Parameter wie `MinOrder-Value`, `Cost-List` oder `ShowDisabled-Allow` gelten hier genauso wie bei jeder anderen Zahlungsart.

Drei Parameter sind für Google Pay besonders:

| Parameter | Bedeutung |
| - | - |
| `ComputopClearingLinkValidForSeconds` | wie lange der an Computop übergebene Zahlungslink gültig bleibt, in Sekunden. Ohne Angabe gilt keine eigene Begrenzung |
| `ComputopChDesc` | der Text, der auf der Kartenabrechnung des Käufers erscheint. Höchstens 30 Zeichen |
| `CtopHostedCustomField5` bis `CtopHostedCustomField10` | eigene Felder, die mit der Transaktion an Computop übergeben werden |

Referenz: Abschnitt PaymentGooglePay-Txt · [Abschnitt PaymentXXX-Txt](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/zahlungsarten.md)

## Schritt 3: Hinweismeldungen hinterlegen

Bricht die Zahlung ab oder wird sie abgelehnt, braucht der Shop einen Text dafür.

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<NotifyMessages-Txt>
   GooglePay-ClearingError  = Bei der Zahlung ist ein Fehler aufgetreten. Bitte wählen Sie eine andere Zahlungsart.
   GooglePay-ClearingCancel = Die Zahlung wurde abgebrochen. Bitte überprüfen Sie Ihre Eingaben.
   GooglePay-ClearingDeny   = Die Zahlung wurde abgelehnt. Bitte überprüfen Sie Ihre Eingaben.
</NotifyMessages-Txt>
```

Referenz: [Abschnitt NotifyMessages-Txt](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/texte-und-meldungen.md#notifymessages-txt)

## Schritt 4: Auswahl im Bestellablauf

Google Pay erscheint zusammen mit allen anderen Zahlungsarten. Sofern `~WS-PaymentFields~` bereits auf `ws_pay_deliv.htm` steht, ist an dieser Stelle nichts zu tun.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<form action="~FORM-PayDeliv~" method="post">
   ~WS-PaymentFields~
</form>
```

Wegweiser: [Zahlungsarten anlegen, für die Ausgabe im Template](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/zahlungsarten-anlegen.md)

Anders als Apple Pay wird Google Pay hier nicht auf bestimmte Endgeräte beschränkt. Es läuft in vielen Browsern und auf mehreren Betriebssystemen, eine pauschale Einschränkung würde also Käufer ausschließen, die bezahlen könnten. Wollen Sie die Zahlungsart trotzdem an das Endgerät knüpfen, geht das über eine Abhängigkeit vom User-Agent, so wie bei Apple Pay beschrieben.

## Schritt 5: Computop-Template anpassen

Die Zahlungsseite, auf die der Käufer weitergeleitet wird, liegt bei Computop. WEBSALE stellt dafür ein Template bereit, das dieselbe Vorlage ist wie bei der Kreditkartenzahlung. Es enthält alle Parameter, die für die Abwicklung nötig sind, und wird bei Updates automatisch von WEBSALE aktualisiert.

An dieser Stelle müssen Sie nur etwas tun, wenn Sie ein **eigenes, angepasstes** Template verwenden, beispielsweise mit Ihrem Logo, Ihrer Schrift oder zusätzlichen Abfragen. Dann übernimmt WEBSALE die Aktualisierung nicht automatisch.

Ob Ihr Shop ein angepasstes Template verwendet, weiß Ihr WEBSALE-Ansprechpartner. Stimmen Sie Anpassungen direkt mit Computop ab und weisen Sie dabei darauf hin, dass Sie einen WEBSALE-Shop betreiben und nicht das Standard-Template von Computop verwenden.

Wegweiser: [Computop-Template anpassen](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/computop.md#computop-template-anpassen)

## Schritt 6: Testen

Im Testmodus ist Google Pay nur für Sie sichtbar. Der laufende Betrieb bleibt unberührt.

Dafür müssen zwei Dinge zusammenkommen: `TestMode = yes` im Abschnitt `<PaymentGooglePay-Txt>` und drei URL-Parameter am Shopaufruf.

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
https://www.ihre-shop-url.de/?test=on&payment-test=on&googlepayclearing-test=on
```

Zum Beenden setzen Sie `googlepayclearing-test=off` und anschließend `TestMode` zurück auf `no`.

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
https://www.ihre-shop-url.de/?test=on&payment-test=on&googlepayclearing-test=off
```

Beim Ein- und Ausschalten dieses Testmodus verwirft der Shop die laufende Sitzung. Ein Warenkorb, den Sie im Testmodus aufgebaut haben, ist danach leer. Bauen Sie Ihren Testfall deshalb erst nach dem Umschalten auf.

> [!WARNING]
>
> Der Livegang erfordert Einstellungen auf beiden Seiten. Informieren Sie sowohl Ihren WEBSALE- als auch Ihren Computop-Ansprechpartner, bevor Sie mit dem Testen anfangen, und noch einmal, wenn Sie fertig sind.

Wegweiser: [Testmodi des Shops ein- und ausschalten](https://dokumentation.websale.de/v8s/domains/testmodi-des-shops-ein-ausschalten.md)

## Verwandte Themen

* Wegweiser: [Zahlungsarten anlegen, für die allgemeinen Parameter und die Ausgabe im Template](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/zahlungsarten-anlegen.md)
* Wegweiser: [Computop, für den Payment-Service-Provider dahinter](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/computop.md)
* Wegweiser: [Computop-Template anpassen](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/computop.md#computop-template-anpassen)
* Wegweiser: [Apple Pay, technisch nach demselben Muster aufgebaut](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/apple-pay.md)


## Related topics

- [PayPal Checkout](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/paypal-checkout.md)
- [$wsPayPalCheckout - PayPal](https://dokumentation.websale.de/frontend/referenz/module/wspaypalcheckout.md)
- [Apple Pay](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/apple-pay.md)
- [PPC- (PayPal Checkout)](https://dokumentation.websale.de/v8s/referenz/tags/ppc-paypal-checkout.md)
- [stripe](https://dokumentation.websale.de/frontend/funktionsubersicht/zahlungsarten/stripe.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.