Zum Hauptinhalt springen
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 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

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.
Der Abschnitt <CardX> 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 <Basic> fest. Ohne Angabe ist es Deutsch.
Referenz: Abschnitt 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: 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

Wie die Dateien aufgebaut sind

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 <Error>-Abschnitt, dessen Codes-Liste den zurückgemeldeten Antwortcode enthält
  2. die Meldung aus <DefaultError>
  3. der Text, den TeleCash im Feld fail_reason mitgeschickt hat
Liefert auch das nichts, erscheint *** Transaction Failed ***.
Legen Sie in jedem Fall einen <DefaultError>-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<Jahr>_<Monat>.err und die Lastschrift in telecashsec2<Jahr>_<Monat>.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
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