Apple Pay - WEBSALE Dokumentation

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

Wie der Bezahlvorgang abläuft

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.

Der Shop leitet ihn auf die Zahlungsseite von Computop weiter.
Auf einem Apple-Gerät ist er dort bereits angemeldet. Andernfalls meldet er sich mit seinen Apple-Zugangsdaten an.
Er bestätigt die Zahlung mit Touch ID oder Face ID.
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.

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.

<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

Schritt 3: Hinweismeldungen hinterlegen

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

<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

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.

<PaymentEnvironmentDependencies-Definitions>
   <+EnvironmentDependency>
      ID = useapple
      <+DependencyGroup>
         <+Dependency>
            Field = useragent
            Type  = contains
            Value = Mac
         </+Dependency>
      </+DependencyGroup>
   </+EnvironmentDependency>
</PaymentEnvironmentDependencies-Definitions>

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

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

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.

<form action="~FORM-PayDeliv~" method="post">
   ~WS-PaymentFields~
</form>

Wegweiser: Zahlungsarten anlegen, für die Ausgabe im Template

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

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.

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.

https://www.ihre-shop-url.de/?test=on&payment-test=on&applepayclearing-test=off

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

​Wie der Bezahlvorgang abläuft

​Schritt 1: Freischaltung durch WEBSALE

​Schritt 2: Zahlungsart anlegen

​Schritt 3: Hinweismeldungen hinterlegen

​Schritt 4: Auf Apple-Geräte beschränken

​Schritt 5: Auswahl im Bestellablauf

​Schritt 6: Computop-Template anpassen

​Schritt 7: Testen

​Verwandte Themen

Wie der Bezahlvorgang abläuft

Schritt 1: Freischaltung durch WEBSALE

Schritt 2: Zahlungsart anlegen

Schritt 3: Hinweismeldungen hinterlegen

Schritt 4: Auf Apple-Geräte beschränken

Schritt 5: Auswahl im Bestellablauf

Schritt 6: Computop-Template anpassen

Schritt 7: Testen

Verwandte Themen