Über TWINT
Allgemeine Informationen über TWINT
TWINT ist die führende und eine der beliebtesten Bezahl-Apps der Schweiz. 97 Prozent der Schweizer Bevölkerung kennen TWINT und die Hälfte der Schweizer Bevölkerung nutzt es regelmässig. Neunzig Prozent aller Bankkontoinhaber in der Schweiz können ihr Konto direkt mit der TWINT-App verbinden.
Bitte beachten Sie: Damit ein Händler einen TWINT-Account erhält, muss dieser einen Schweizer Firmensitz vorweisen können.
|
Weitere Informationen finden Sie auch auf der Webseite von TWINT (https://www.twint.ch/).
Wie es funktioniert
Wenn sich ein Benutzer für die Bezahlung mit TWINT entscheidet und auf die entsprechende Zahlungsschaltfläche tippt, wird entweder ein QR-Code zum Scannen angezeigt (Web-Zahlung) oder die TWINT-App öffnet sich automatisch, um die Zahlung zu bestätigen (In-App-Zahlung oder im Browser auf dem Smartphone).
Unter folgendem Link finden Sie eine Übersicht, wie Sie online mit TWINT bezahlen können:
https://www.twint.ch/privatkunden/funktionen/onlineshop/?lang=de
Bevor Sie beginnen
Wenn Sie sich entschieden haben, TWINT zu unterstützen, müssen einige Schritte ausgeführt werden:
- Registrieren Sie Ihr Unternehmen bei TWINT unter: https://portal.twint.ch.
Wenn Sie einen Testhändler haben und TWINT-Transaktionen im Testmodus ausführen, können Sie Ihr Unternehmen auch auf der Integrationsumgebung von TWINT https://portal-int.twint.ch in gleicher Weise wie unten beschrieben registrieren und einen Shop einrichten.
- Legen Sie Ihren Online-Shop von der Homepage des TWINT-Portals aus an:
- Wählen Sie im zweiten Schritt der Shop-Registrierung im Abschnitt "Integration" die Option PSP (Payment Service Provider) und wählen
aus der Liste der Provider:
- Nachdem der Shop angelegt wurde, geben Sie die UUID des Shops an
und bitten darum, die Zahlungsmethode TWINT zu aktivieren:
Diagramm zum Prozessablauf
Anwendungsfälle
Unterstützte Anwendungsfälle | Unterstützte Schnittstellen | |||||||
|---|---|---|---|---|---|---|---|---|
Anwendungsfall | Beschreibung | Einfacher Prozess | S-2-S | Formular | Batch | Analytics | HPP | CTSF |
Autorisierung + Buchung | Händler wollen eine Zahlung autorisieren und bei Lieferung buchen |
|  | | ||||
Verkauf (Sale) | Händler möchten Geld vom Kunden einziehen |
| | | ||||
Voll- oder Teil-Gutschrift | Händler möchten einen Geldbetrag an den Kunden zurückerstatten, nachdem eine Zahlung erfolgreich abgeschlossen ist |
|
|
| ||||
Voll- oder Teil-Storno | Händler wollen eine nicht abgeschlossene Zahlung stornieren |
| | |||||
| CTSF | CTSF zur Abstimmung |
| demnächst | |||||
Auf dieser Seite
-Schnittstelle
Zahlung mit TWINT über ein -Formular
Um eine TWINT-Zahlung über ein -Formular auszuführen, verwenden Sie bitte folgende URL:
|
Parameter für TWINT
Bitte beachten Sie, dass sich das finale Notify im Fall des Zahlungsabschluss durch den Kunden und dieser schließt der Browser direkt danach um ca. 30-35min. oder bis zu 60-65min. verzögern kann. Hintergrund ist, da nur über den Browser Callback der Zahlungsstatus eingelesen werden kann. Erfolgt dieser nicht, wird der Status nachgelagert von im oben genannten Intervall angefragt. Durch den fehlenden Callback entfällt somit auch der Redirect auf die URLSuccess/URLFailure.
Ergebnis-Parameter für URLSuccess, URLFailure and URLNotify bei TWINT
Buchung
Falls Ihre MID nicht für die Sale-Operation konfiguriert ist, sollte jede anfängliche TWINT-Zahlung (Aufruf von twint.aspx) über die Schnittstelle capture.aspx bestätigt oder über reverse.aspx storniert werden.
Buchungen (oder Bestätigungen im Sinne von TWINT) sind über eine Server-zu-Server-Verbindung möglich. Um eine Buchung über eine Server-zu-Server-Verbindung auszuführen, verwenden Sie bitte folgende URL:
|
Parameter für Buchungen bei TWINT über Socket-Verbindung
Ergebnis-Parameter für Buchungen bei TWINT über Socket-Verbindung
Stornierung
Stornierungen sind über eine Server-zu-Server-Verbindung möglich. Um eine Zahlung über eine Server-zu-Server-Verbindung zu stornieren, verwenden Sie bitte folgende URL:
|
Parameter für Stornierungen bei TWINT über Socket-Verbindung
Ergebnis-Parameter für Stornierungen bei TWINT über Socket-Verbindung
Gutschrift mit Referenz
|
Hinweis: Bitte beachten Sie, dass TWINT sowohl in der Produktionsumgebung als auch auf dem Testsystem Erstattungen limitiert – Produktionssystem: 180 Tage / Testsystem: 7 Tage.
Parameter für Gutschriften bei TWINT über Socket-Verbindung
Ergebnis-Parameter für Gutschriften bei TWINT über Socket-Verbindung
Batch-Nutzung der Schnittstelle
Dieses Kapitel beschreibt die Parameter, die Sie im Datensatz (Record) für die Ausführung einer Twint-Zahlung übergeben müssen und welche Informationen Sie der Antwort-Datei über den Status des Zahlungsvorgangs entnehmen können.
Bei den Batch-Aufrufen ist die verwendete Batch-Version zu unterscheiden, wovon die optionalen Parameter abhängen. Alle mit „2.“ beginnen Versionsbezeichnungen betreffen Aufrufe für einen Konzern. Das bedeutet, innerhalb einer Batch-Datei mit einer bestimmten MerchantID können auch Transaktionen anderer Händler mit einer abweichenden Sub-MID übertragen werden.
Folgende Tabelle gibt eine Übersicht der pro Aktion jeweils möglichen Batch-Versionen und ihrer Besonderheiten:
Der Aufbau für eine Zahlung mit Twint in einer einzureichenden Batch-Datei sieht folgendermaßen aus:
Beispiel für Master-MID-Funktion:
Der Record-Bereich in der Antwort-Datei zu Batch-Transaktionen sieht folgendermaßen aus:
Beschreibung der Ergebnis-Parameter im Datensatz von Batch-Dateien