> ## 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. # TeleCash > Wie Sie die Kreditkarten- und Lastschriftabwicklung über TeleCash in WEBSALE V8s einrichten und eigene Fehlermeldungen je Antwortcode hinterlegen. TeleCash ist einer der Zahlungsdienstleister, über die WEBSALE V8s Kreditkartenzahlungen abwickeln kann. Neben der einfachen Kreditkartentransaktion unterstützt die Anbindung 3D-Secure, also „Verified by Visa" und „MasterCard SecureCode". Auch die elektronische [Lastschrift](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/lastschrift.md) läuft bei Bedarf über TeleCash. TeleCash ist dabei kein eigener Eintrag in der Zahlungsartenliste. Der Käufer wählt weiterhin „Kreditkarte", und erst dahinter entscheidet sich, wer die Transaktion abwickelt. Die grundlegende Einrichtung steht deshalb auf der Seite zur Kreditkarte, und diese Seite ergänzt nur das, was für TeleCash hinzukommt. Wegweiser: Zahlungsart [Kreditkarte](https://dokumentation.websale.de/v8s/referenz/tags/cc.md) ## Voraussetzungen Nötig sind ein Händlervertrag mit TeleCash und die Freischaltung der Anbindung durch die WEBSALE AG. Ohne die Freischaltung bleiben die Einstellungen in der Shopkonfiguration wirkungslos. ## Schritt 1: Die Kartenkennung je Kartentyp eintragen TeleCash spricht die Kartentypen über eigene Kennungen an. Tragen Sie zu jedem Kartentyp, den Sie anbieten, die Kennung von TeleCash ein. ```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}} Allow = yes Name = MasterCard TeleCashSec2ID = M ``` > [!WARNING] > > Der Abschnitt `` wird nur ausgewertet, wenn `Name` gesetzt **und** `Allow = yes` ist. Fehlt eines von beidem, bricht der Shop das Einlesen des Abschnitts ab, und `TeleCashSec2ID` wird gar nicht erst gelesen. Wenn eine Karte trotz eingetragener Kennung nicht funktioniert, prüfen Sie zuerst diese beiden Zeilen. Jeder Zahlungsdienstleister hat im selben Abschnitt seinen eigenen Kennungsparameter, beispielsweise `CompuTopBrandID` oder `PaymetricBrandID`. Die Parameter stören einander nicht. Sie können sie also stehen lassen, wenn Sie den Dienstleister wechseln oder testweise umschalten. Referenz: Abschnitte Card1 bis Card5 ## Schritt 2: Die Sprache der TeleCash-Seiten festlegen Während der Zahlung sieht der Käufer Seiten von TeleCash. In welcher Sprache, legen Sie im Abschnitt `` fest. Ohne Angabe ist es Deutsch. ```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}} TeleCashLanguageCode = de_DE ``` Referenz: [Abschnitt Basic](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/grundlagen-und-technik.md#basic) ## Eigene Fehlermeldungen hinterlegen Scheitert eine Transaktion, zeigt der Shop standardmäßig den Text an, den TeleCash mitliefert. Der ist englisch, technisch und für den Käufer meist wertlos. Sie können stattdessen eigene Meldungen hinterlegen, abhängig vom Antwortcode, den TeleCash im Feld `processor_response_code` zurückgibt. ### Wo die Dateien liegen Die Meldungen stehen in zwei Dateien im sprachabhängigen Konfigurationsverzeichnis Ihres Shops: | Datei | Wofür | | - | - | | `konfiguration//telecash_cc_err.txt` | Kreditkartenzahlung | | `konfiguration//telecash_elv_err.txt` | elektronische Lastschrift | Weil die Dateien sprachabhängig liegen, pflegen Sie in einem mehrsprachigen Shop je Sprache einen eigenen Satz Meldungen. Genau dafür ist diese Einrichtung gedacht. Grundlagen: [Verzeichnisstruktur eines Shops](https://dokumentation.websale.de/v8s/materialien/verzeichnisstruktur-eines-shops.md) ### Wie die Dateien aufgebaut sind ```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}} Message = Die Zahlung konnte nicht abgeschlossen werden. Bitte prüfen Sie Ihre Kartendaten oder wählen Sie eine andere Zahlungsart. Codes = 12,13,47 Message = Ihre Karte wurde abgelehnt. Bitte wenden Sie sich an Ihre Bank oder wählen Sie eine andere Zahlungsart. Codes = 39 Message = Die eingegebene Kartennummer ist nicht gültig. Bitte prüfen Sie Ihre Eingabe. ``` | Abschnitt | Bedeutung | | - | - | | `` | die Meldung, wenn zum zurückgemeldeten Code keine eigene Meldung hinterlegt ist. Darf einmal vorkommen | | `` | eine Meldung für einen oder mehrere Codes. Darf beliebig oft vorkommen | | `Codes` | kommagetrennte Liste der Antwortcodes, für die diese Meldung gilt | | `Message` | der Text, den der Käufer sieht | Zeilen, die mit `#` beginnen, werden beim Einlesen dieser Dateien als Kommentar behandelt. Sie können damit festhalten, wofür ein Code steht, ohne dass es den Käufer erreicht. ### Welche Meldung tatsächlich erscheint Der Shop arbeitet drei Stufen ab und nimmt die erste, die einen Text liefert: 1. die Meldung aus dem ``-Abschnitt, dessen `Codes`-Liste den zurückgemeldeten Antwortcode enthält 2. die Meldung aus `` 3. der Text, den TeleCash im Feld `fail_reason` mitgeschickt hat Liefert auch das nichts, erscheint `*** Transaction Failed ***`. > [!WARNING] > > Legen Sie in jedem Fall einen ``-Abschnitt an. Ohne ihn fällt der Shop auf den englischen Text von TeleCash zurück, und der letzte Rückfall ist eine Zeichenfolge, die kein Käufer verstehen soll. Welche Antwortcodes TeleCash in welchen Fällen liefert, erfahren Sie von TeleCash. Die Codes sind nicht Teil der WEBSALE-Dokumentation, denn sie stammen aus dem System des Dienstleisters und können sich dort ändern. ## Wann eine Transaktion als erfolgreich gilt TeleCash meldet das Ergebnis im Feld `approval_code` zurück. Beginnt dessen Wert mit `y`, gilt die Transaktion als genehmigt. Jeder andere Wert und ein leeres Feld gelten als Ablehnung. Zusätzlich prüft der Shop die Rückmeldung auf Manipulation. TeleCash schickt einen Hashwert mit, entweder beim Rücksprung des Käufers oder bei der direkten Meldung von Server zu Server. Stimmt der Hashwert nicht oder fehlt er ganz, wird die Transaktion als Fehler behandelt, unabhängig vom Genehmigungscode. Fehlgeschlagene Transaktionen werden protokolliert, die Kreditkartenzahlung in `telecashhosted_.err` und die Lastschrift in `telecashsec2_.err` im Protokollverzeichnis. Dort finden Sie die vollständige Rückmeldung, wenn Sie einem Einzelfall nachgehen. ## Währungen Die TeleCash-Anbindung kennt die folgenden Währungen: `EUR`, `GBP`, `USD`, `CHF`, `CZK`, `DKK`, `JPY`, `ZAR`, `SEK`, `CAD` > [!WARNING] > > Läuft Ihr Shop in einer Währung, die nicht in dieser Liste steht, scheitert die Transaktion. Prüfen Sie das, bevor Sie einen Subshop in einer weiteren Währung aufsetzen. ## Verwandte Themen * Wegweiser: Zahlungsart Kreditkarte, für die grundlegende Einrichtung * Wegweiser: [Zahlungsarten anlegen, für die allgemeinen Parameter und die Ausgabe im Template](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/zahlungsarten-anlegen.md) * Wegweiser: [Lastschrift, für die Abwicklung der elektronischen Lastschrift](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/lastschrift.md) ## Related topics - [Grundlagen und Technik](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/grundlagen-und-technik.md) - [Zahlungsarten](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/zahlungsarten.md) - [Import-Dateien](https://dokumentation.websale.de/v8s/schnittstellen/kundendaten/ws-sftp-kunden-pro/import-dateien.md) - [Sektionen: Kopfdaten und Adressen](https://dokumentation.websale.de/v8s/schnittstellen/bestellungen/ws-bestelldaten/sektionen-kopf-und-adressen.md) - [Weitere Informationen zur Bestellung abfragen](https://dokumentation.websale.de/v8s/adressdaten/weitere-informationen-zur-bestellung-abfragen.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.