TWINT ist die führende und eine der beliebtesten Bezahl-Apps der Schweiz. WEBSALE V8s unterstützt die Anbindung der Zahlungsart "TWINT" über den Payment-Service-Provider "Computop".

Wegweiser: Computop

Inhalt

1 Funktionsweise

2 Integration

 

Funktionsweise

Nach dem Auswählen der Zahlungsart TWINT und dem Klicken auf "Zahlungspflichtig bestellen" gelangt der Käufer direkt auf die Zahlungsseite von TWINT. Dort wird entweder ein QR-Code zum Scannen angezeigt (Web-Zahlung) oder die TWINT-App öffnet sich automatisch, um die Zahlung zu bestätigen. Am Ende gelangt der Käufer wieder auf die HTML-Bestelleingangsbestätigungsseite (ws_confirm.htm) im Shop.

 

Integration

Voraussetzung

Wenn Sie noch keinen Händlervertrag mit Computop haben, wenden Sie sich zunächst an Computop. Registrieren Sie dann Ihren Shop bei TWINT (siehe https://portal.twint.ch) und geben Sie die UUID des Shops an Computop weiter (siehe TWINT-Dokumentation bei Computop: https://developer.computop.com/display/DE/TWINT).

Schritt 1: Freischaltung/Aktivierung

TWINT muss durch WEBSALE freigeschaltet werden. Hierzu benötigen wir die relevanten Daten und Parameter (UUID, 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 <PaymentTWINT-Txt> in Ihre Shopkonfiguration shop.config ein.

<PaymentTWINT-Txt>
   Allow                = yes
   TestMode             = yes
   Name                 = TWINT
   NameSuffix           = Mit TWINT bequem und sicher mit dem Smartphone bezahlen.
   ImgOnClick           = selectPaymentImage('~ID~');
   RadioOnClick         = selectPayment('~ID~');
   Img                  = <logo-XYZ.png>
   DelivererID-List     = <Ihre Versandarten-IDs>
   ...
   BillCountry-Rule     = AllowCountries
   BillCountry-List     = CHE               # TWINT steht nur Kunden aus der Schweiz zur Verfügung
   ...
</PaymentTWINT-Txt>

Referenz: PaymentTWINT-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>
   ...
   TWINT-ClearingError  = Derzeit kann leider keine Zahlung mit TWINT durchgeführt werden. Bitte wählen Sie eine andere Zahlungsart.
   TWINT-ClearingCancel = Sie haben den Bezahlvorgang mit TWINT abgebrochen. Um fortzufahren, wählen Sie bitte eine andere Zahlungsart.
   TWINT-ClearingDeny   = Die Transaktion mit TWINT wurde leider abgelehnt. Bitte überprüfen Sie Ihre Eingaben und versuchen Sie es erneut.
   ...
</NotifyMessages-Txt>

Referenz: Abschnitt NotifyMessages-Txt

Schritt 4: Auswahl der Zahlungsart auf der Zahlungs- und Versandarten-Seite (ws_pay_deliv.htm)

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 5: Testen der Zahlungsart TWINT

Um TWINT 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 <PaymentTWINT-Txt> Ihrer Shopkonfiguration shop.config auf yes steht.

Referenz: PaymentTWINT-Txt

Aktivieren des "TWINT"-Testmodus:

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

Deaktivieren des "TWINT"-Testmodus:

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

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

Wegweiser: Testmodi des Shops ein-/ausschalten

 

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