WEBSALE V8s unterstützt die Anbindung der Zahlungsart "Apple Pay" über den Payment-Service-Provider "Computop".

Wegweiser: Computop

Apple Pay ist eine digitale Geldbörse für Geräte von Apple, die Zahlungsinformationen anonymisiert speichert und einen ebenso bequemen wie sicheren Weg bietet, um in iOS-Apps oder auf Webseiten zu bezahlen.

Inhalt

1 Funktionsweise

2 Integration

 

Funktionsweise

Nach dem Auswählen der Zahlungsart Apple Pay und dem Klicken auf "Zahlungspflichtig bestellen" gelangt der Käufer auf die Zahlungsseite von Computop. Wenn er mit iPhone oder iPad einkauft, ist er automatisch angemeldet, ansonsten muss der Käufer seine Apple-Account-Zugangsdaten eingeben. Die Zahlung wird mittels TouchID/FaceID autorisiert und dann mit dem Browser synchronisiert. Am Ende gelangt der Käufer auf die HTML-Bestelleingangsbestätigungsseite (ws_confirm.htm) im Shop.

 

Integration

Voraussetzung

Apple Pay wird über Computop in Ihren Shop eingebunden. Wenn Sie noch keinen Händlervertrag mit Computop haben, wenden Sie sich zunächst an Computop.

Für einen automatischen Zahlungsprozess muss Apple Pay auch vom ERP-System unterstützt werden. Bitte sprechen Sie mit Ihrem Dienstleister.

Schritt 1: Freischaltung/Aktivierung

Apple Pay muss durch WEBSALE freigeschaltet werden. Hierzu benötigen wir die relevanten Daten und Parameter (UID, HMAC, MerchantID etc.) von Computop. Kontaktieren Sie bitte Ihren WEBSALE-Ansprechpartner.

Schritt 2: Aktivieren der Zahlungsart und Definieren der gewünschten Einstellungen in der Shopkonfiguration

Fügen Sie den Abschnitt <PaymentApplePay-Txt> in Ihre Shopkonfiguration shop.config ein.

<PaymentApplePay-Txt>
   Allow                = yes
   TestMode             = yes
   Name                 = Apple Pay
   NameSuffix           = Apple Pay ist die moderne Art zu bezahlen.
   ImgOnClick           = selectPaymentImage('~ID~');
   RadioOnClick         = selectPayment('~ID~');
   Img                  = <logo-XYZ.png>
   DelivererID-List     = <Ihre Versandarten-IDs>
   ...
   ComputopClearingLinkValidForSeconds   = 600   # Dauer der Gültigkeit des an Computop gesendeten Clearing-Links
   ...
</PaymentApplePay-Txt>

Referenz: Abschnitt PaymentApplePay-Txt

Die für alle Zahlungsarten möglichen Standard-Parameter finden Sie unter:

Referenz: Abschnitt PaymentXXX-Txt

Schritt 3: Definieren von Hinweismeldungen
Ergänzen Sie in der Shopkonfiguration shop.config im Abschnitt <NotifyMessages-Txt> folgende Hinweismeldungen:

<NotifyMessages-Txt>
   ...
   ApplePay-ClearingError  = Fehler bei der Transaktion. Bitte wählen Sie eine andere Zahlungsart.
   ApplePay-ClearingCancel = Die Transaktion wurde abgebrochen. Bitte überprüfen Sie Ihre Eingaben.
   ApplePay-ClearingDeny   = Die Transaktion wurde abgelehnt. Bitte überprüfen Sie Ihre Eingaben.
   ...
</NotifyMessages-Txt>

Referenz: Abschnitt NotifyMessages-Txt

Schritt 4: Apple Pay nur für Apple-Geräte aktivieren und für Nicht-Apple-User ausblenden

Die Endgeräte der Nutzer übermitteln einen sog. User-Agent-String an den WEBSALE-Server. Damit lässt sich das benutzte Gerät oder die Art des Browsers auslesen. Um die Zahlungsart Apple Pay nur auf Apple-Geräten anzuzeigen, fügen Sie folgende Abhängigkeit vom User-Agent in die Shopkonfiguration shop.config ein.

<PaymentEnvironmentDependencies-Definitions>
   <+EnvironmentDependency>
      ID               = useapple     # Mit dieser ID wird die Abhängigkeit mit der entsprechenden Zahlungsart verknüpft
      <+DependencyGroup>
         <+Dependency>
            Field      = useragent
            Type       = contains
            Value      = Mac          # iPhone, iPad
         </+Dependency>
      </+DependencyGroup>
   </+EnvironmentDependency>
   ...
</PaymentEnvironmentDependencies-Definitions>

Referenz: PaymentEnvironmentdependencies-Definitions

Ergänzen Sie im Abschnitt <PaymentApplePay-Txt> die ID aus der <PaymentEnvironmentDependencies-Definitions> und verknüpfen somit die Abhängigkeitsregel mit der Zahlungsart Apple Pay.

<PaymentApplePay-Txt>
   ...
   +UsePaymentEnvironmentDependency-ID   = useapple
   ...
</PaymentApplePay-Txt>

Referenz: Abschnitt PaymentApplePay-Txt

Schritt 5: Auswahl der Zahlungsart im Checkout-Prozess

Platzieren Sie das Einzel-Tag WS-PaymentFields auf dem Template Zahlungs- und Versandarten-Seite (ws_pay_deliv.htm) innerhalb der <form action="~Form-PayDeliv~">, falls noch nicht vorhanden.

Wegweiser: Auswahl der Zahlungsart im Checkout-Prozess

Referenz: WS-PaymentFields

Schritt 6: Design-Anpassung des externen Computop-Template (optional)

Für die Transaktion zwischen WEBSALE und Apple Pay über Computop wird das WEBSALE-Computop-Template benötigt, das auch für die Kreditkartenzahlung verwendet wird. Dieses bei Computop gehostete Template wird von WEBSALE bereitgestellt und enthält alle benötigen Parameter für eine korrekte Abwicklung der Zahlungsarten. Notwendige Aktualisierungen bei Updates werden automatisch durch WEBSALE durchgeführt.

Anpassungen an diesem Template müssen Sie nur vornehmen, wenn Sie Ihr eigenes, angepasstes Template verwenden, d. h. das Template enthält bereits z. B. Ihr Logo, Ihre Schriftart, Zusatzabfragen etc. Wollen Sie das Design der Zahlungsseite bei Computop an Ihr Shop-Design anpassen, dann gehen Sie bitte wie im Topic "Computop" beschrieben vor:

Wegweiser: Computop-Template anpassen

Sind Sie sich nicht sicher, ob Sie ein angepasstes Template verwenden, dann sprechen Sie mit Ihrem WEBSALE-Ansprechpartner.

Schritt 7: Testen der Zahlungsart Apple Pay

Um Apple Pay in Ihrem Shop zu testen, stellt Ihnen WEBSALE einen Zahlungsarten-Testmodus zur Verfügung. Die Zahlungsart ist dann nur im Testmodus sichtbar. Der Produktivbetrieb Ihres Shops wird dadurch nicht beeinflusst.

Achten Sie darauf, dass der Parameter TestMode im Abschnitt <PaymentApplePay-Txt> Ihrer Shopkonfiguration shop.config auf yes steht.
Referenz: Abschnitt PaymentApplePay-Txt

Aktivieren des "Apple Pay"-Testmodus:

http://www.xyz.de/?test=on&payment-test=on&applepayclearing-test=on

Deaktivieren des "Apple Pay"-Testmodus:

https://www.xyz.de/?test=on&payment-test=on&applepayclearing-test=off

Setzen Sie im Abschnitt <PaymentApplePay-Txt> der Shopkonfiguration shop.config den Parameter TestMode auf no.

Wegweiser: Testmodi des Shops ein-/ausschalten

Haben Sie alle Schritte durchgeführt, ist die Zahlungsart "Apple Pay" in Ihrem Shop integriert und aktiv.