Template-Anforderungen
Einige Hinweise zu spezifischen Anforderungen für die Verwendung des TemplateManager
- Sie können Template-Dateien nur für Ihre eigene MerchantId hochladen
- wenn Sie Templates für andere MerchantIds bereitstellen wollen, müssen Sie diese zuerst hochladen und mit Ihrer eigenen MerchantId testen; dann informieren Sie den Computop Helpdesk, dass Ihr Template auch für andere Händler verfügbar sein soll
- die maximale Größe pro Template ist auf 5 MByte begrenzt
- Name und Aufbau des Templates müssen einem nachstehend beschriebenen Muster folgen.
Namenskonventionen
Die Template-Datei selbst ist eine ZIP-Datei, die der Namenskonvention TemplateJahrMonatTagVersionMerchantID.zip folgen muss mit:
Teil | Beschreibung | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Template | Gibt an, dass es sich bei der Datei um eine XSLT-Vorlage handelt | ||||||||||
JahrMonatTag | Datum dieser Datei. Verwenden Sie bitte das aktuelle Datum im Format jjjjmmtt, z.B. 20220128 | ||||||||||
Version | 3-stellige Versionsnummer. Die Versionsnummer wird nicht überprüft und nicht erzwungen, in einer Sequenz zu sein. Für Ihre eigene Struktur empfehlen wir die Verwendung von Sequenznummern wie folgt:
| ||||||||||
MerchantID | Dies muss Ihre eigene MerchantId sein, Groß- und Kleinschreibung beachten ! z. B. MeineMerchantId – wie in Computop Analytics angezeigt, z. B.: | ||||||||||
.zip | Die Template-Datei muss als ZIP-Datei gepackt werden – ohne Passwort, ... |
Template-Struktur
Sie können Ihrem Template einen zusätzlichen Text hinzufügen, um mehrere Templates für unterschiedliche Zwecke/Nutzung hochzuladen. Dadurch können Sie haben:
- einen Satz Vorlagen für gewöhnliche Verwendung, z. B.
- MerchantId_PaymentPage.xsl + xml
- MerchantId_PaySSL.xsl + xml
- MerchantId_PaySDD.xsl + xml
- einen spezifischen Satz Vorlagen für Pay By Link
- MerchantId_PayByLink_PaymentPage.xsl + xml
- MerchantId_PayByLink_PaySSL.xsl + xml
- MerchantId_PayByLink_PaySDD.xsl + xml
Die ZIP-Datei muss diese Struktur enthalten:
Dateinamen | Gemeinsame Verzeichnisstruktur |
---|---|
ZahlungsseitenvorlageXSL-Template: MerchantID_PaymentPage.xsl XSL-Template mit Freitext: MerchantID_MyPurpose_PaymentPage.xsl | Jede ZIP-Datei muss diese Verzeichnisstrutkur verwenden:
Zusätzlich kann ein Ordner "data" verwendet werden, um z. B. Übersetzungen zu speichern. Oberste Ebene: Unterverzeichnis: |
Kreditkartenvorlage (PaySSL)XSL-Template: MerchantID_PaySSL.xsl XSL-Template mit Freitext: MerchantID_MyPurpose_PaySSL.xsl | |
Lastschriftvorlage (PaySDD)XSL-Template: MerchantID_PaySDD.xsl XSL-Template mit Freitext: MerchantID_MyPurpose_PaySDD.xsl |
Template-Sicherheit – erlaubte Links und Token
Aus Sicherheitsgründen sind Links nur auf bestimmte Webseiten erlaubt (z. B. zum Verweis auf AGB, Impressum, ...):
- computop.com
- visa.com
- mastercard.com
und diese CData-Token sind in XML, XSL nicht erlaubt:
- @
- <&
- data:
- document.write
- xmlhttprequest
- window.open
Nutzung des TemplateManagers
Der TemplateManager sieht wie folgt aus:
Zugriff auf den TemplateManager
Wählen Sie "Administration" (1) und "TemplateManager" (2), um das TemplateManager-Formular anzuzeigen.
Ihre MerchantId und Ihr Benutzer benötigen eine spezielle Berechtigung
Neues Template hochladen
Um eine neue Template-Datei hochzulasen, wählen Sie bitte "Template-Datei hochladen" (3).
Wählen Sie bitte die gewünsche Template-Datei (8) aus und wählen entweder die TemplateId aus, die Sie überschreiben wollen oder fügen ein neues Template (9) hinzu. Schließlich bestätigen Sie das Hochladen (10).
Das Template wird hochgeladen und der Upload bestätigt mit:
Das Template wird sofort gescannt und nach dem Klick auf die Schaltfläche "Suche und Filter" in der Liste der hochgeladenen Templates angezeigt.
Wenn der Scanvorgang einen Fehler festgestellt hat, wird eine Meldung wie diese angezeigt:
Weitere Fehlermeldungen finden Sie hier: Fehlermeldungen vom TemplateManager
Anhang
Fehlermeldungen vom Template Manager
Klassifizierung | Scan-Meldung | Ursache | Empfehlung |
---|---|---|---|
Allgemein | CONNECTION_ERROR |
|
|
FirstChecks | FIRSTCHECKS_FILEEXTENSION_NOT_ALLOWED |
|
|
FIRSTCHECKS_FILESIZE_TO_BIG |
|
| |
FIRSTCHECKS_FILENAME_TO_SHORT |
|
| |
FIRSTCHECKS_VALUE_TEMPLATE_MISSING_IN_FILENAME |
| ||
FIRSTCHECKS_VALUE_DATE_NOT_CORRECT_IN_FILENAME |
| ||
FIRSTCHECKS_VALUE_COUNTER_NOT_CORRECT_IN_FILENAME |
| ||
FIRSTCHECKS_VALUE_MID_NOT_CORRECT_IN_FILENAME |
| ||
FIRSTCHECKS_IMAGES_FOLDER_MISSING |
|
| |
FIRSTCHECKS_FILE_STRUCTURE_NOT_CORRECT |
|
| |
Scan | SCAN_DATA_FIELD_MISSING |
|
|
SCAN_BASE_URLS_NOT_ALLOWED |
|
| |
SCAN_SRC_NOT_ALLOWED |
|
| |
SCAN_HREF_NOT_ALLOWED |
| ||
SCAN_SCRIPT_SOURCE_NOT_ALLOWED |
|
| |
SCAN_SUSPICIOUS_TOKENS_IN_XSL_FILE_FOUND |
|
| |
SCAN_SUSPICIOUS_TOKENS_IN_XML_FILE_FOUND |
|
| |
SCAN_XML_FILE_INVALID |
|
| |
SCAN_XSL_FILE_INVALID |
| ||
SCAN_TRANSFORMATION_FAILED |
| ||
Verteilen | DISTRIBUTE_TEMPLATE_UPLOAD_FAILED |
|
|