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

# Apple Pay

> Wie Sie die Zahlungsart Apple Pay über den Payment-Service-Provider Computop in WEBSALE V8s einbinden, auf Apple-Geräte beschränken und testen.

Apple Pay ist die Geldbörse auf dem iPhone, iPad und Mac. Der Käufer bestätigt den Kauf mit Fingerabdruck oder Gesichtserkennung, statt Kartendaten einzutippen, und die Kartennummer selbst bekommt der Händler nie zu sehen.

In WEBSALE V8s läuft Apple Pay über den Payment-Service-Provider **Computop**, technisch auf demselben Weg wie die Kreditkartenzahlung. 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 Applepay Diagramm V2](https://mintcdn.com/websaleag-44ee7ea6/LS0r3yDDNtTzNzIH/images/ablauf-applepay-diagramm-v2.jpg?fit=max\&auto=format\&n=LS0r3yDDNtTzNzIH\&q=85\&s=a502a71c6b02bb795ad2ac7e1721bdcc)

Der Käufer wählt Apple 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. Auf einem Apple-Gerät ist er dort bereits angemeldet. Andernfalls meldet er sich mit seinen Apple-Zugangsdaten an.
3. Er bestätigt die Zahlung mit Touch ID oder Face ID.
4. Computop schickt ihn zurück auf die Bestelleingangsbestätigung `ws_confirm.htm`.

Damit der Bestellprozess anschließend ohne Handgriff weiterläuft, muss auch Ihr Warenwirtschaftssystem Apple Pay kennen. Sprechen Sie das mit Ihrem Dienstleister ab, bevor Sie live gehen.

## Schritt 1: Freischaltung durch WEBSALE

Apple 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 Apple 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 Apple Pay nach der Konfiguration nicht erscheint, ist die Freischaltung der erste Punkt, den Sie prüfen sollten.

Nutzen Sie schon die Kreditkartenzahlung ü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 `<PaymentApplePay-Txt>` in der `shop.config` an.

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<PaymentApplePay-Txt>
   Allow            = yes
   TestMode         = yes
   Name             = Apple Pay
   NameSuffix       = Bezahlen Sie bequem mit Touch ID oder Face ID.
   Img              = logo-apple-pay.png
   RadioOnClick     = selectPayment('~ID~');
   ImgOnClick       = selectPaymentImage('~ID~');
   DelivererID-List = standard,express

   ComputopClearingLinkValidForSeconds = 600
</PaymentApplePay-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 Apple 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 Kreditkartenabrechnung des Käufers erscheint. Höchstens 30 Zeichen |
| `CtopHostedCustomField5` bis `CtopHostedCustomField10` | eigene Felder, die mit der Transaktion an Computop übergeben werden |

Referenz: Abschnitt PaymentApplePay-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>
   ApplePay-ClearingError  = Bei der Zahlung ist ein Fehler aufgetreten. Bitte wählen Sie eine andere Zahlungsart.
   ApplePay-ClearingCancel = Die Zahlung wurde abgebrochen. Bitte überprüfen Sie Ihre Eingaben.
   ApplePay-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: Auf Apple-Geräte beschränken

Apple Pay funktioniert nur auf Apple-Geräten. Einem Käufer am Windows-Rechner die Zahlungsart anzubieten, führt zu einem Abbruch, den er sich nicht erklären kann.

Der Shop kann das Endgerät am User-Agent erkennen, den jeder Browser mitschickt. Daran lässt sich eine Bedingung knüpfen. Das geschieht in zwei Schritten: erst die Bedingung mit einer Kennung anlegen, dann diese Kennung bei der Zahlungsart eintragen.

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<PaymentEnvironmentDependencies-Definitions>
   <+EnvironmentDependency>
      ID = useapple
      <+DependencyGroup>
         <+Dependency>
            Field = useragent
            Type  = contains
            Value = Mac
         </+Dependency>
      </+DependencyGroup>
   </+EnvironmentDependency>
</PaymentEnvironmentDependencies-Definitions>
```

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<PaymentApplePay-Txt>
   +UsePaymentEnvironmentDependency-ID = useapple
</PaymentApplePay-Txt>
```

Greift die Bedingung nicht, blendet der Shop Apple Pay aus. Der zugehörige Ablehnungsgrund ist die `29`, falls Sie die Zahlungsart lieber ausgegraut mit Hinweis anzeigen wollen.

> [!WARNING]
>
> Prüfen Sie den Wert hinter `Value` an echten Geräten. `Mac` erfasst iPhone und iPad nicht zwangsläufig, und umgekehrt tragen auch Browser auf einem Mac diese Zeichenfolge, in denen Apple Pay nicht zur Verfügung steht. Je nachdem, welche Geräte Ihre Käufer verwenden, brauchen Sie mehrere `<+Dependency>`-Blöcke oder einen anderen Suchbegriff.

Referenz: [Abschnitt PaymentEnvironmentDependencies-Definitions](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/zahlungsarten.md#paymentenvironmentdependencies-definitions)

## Schritt 5: Auswahl im Bestellablauf

Apple 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)

## Schritt 6: 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 7: Testen

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

Dafür müssen zwei Dinge zusammenkommen: `TestMode = yes` im Abschnitt `<PaymentApplePay-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&applepayclearing-test=on
```

Zum Beenden setzen Sie `applepayclearing-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&applepayclearing-test=off
```

> [!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: [Google Pay, technisch nach demselben Muster aufgebaut](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/google-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)
- [Google Pay](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/google-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.