Produktmerkmale
Mit secucard Gutscheine für Shopware 6 können Sie jeweils ein oder mehrere secucard-Karten als Geschenkgutscheine verkaufen und einlösen. Weiterhin steht Ihnen die Multichannel-Funktionalität von secucard offen: Bei entsprechender Integration am Point of Sale (POS) können Sie online verkaufte Gutscheine an der Kasse einlösen, oder auf beliebigen Weg (z. B. Kasse, Versand) ausgegebene Geschenkgutscheine online akzeptieren.
Die Gutscheine können als Artikel und auch als Variantenartikel angeboten werden:
Die E-Mail-Vorlagen für Gutscheine und Sicherheitscodes (optional) können auf dem gleichen Weg wie alle E-Mails in Shopware an Ihre Bedürfnisse angepasst werden.
Die Gutscheineinlösung funktioniert aus Benutzersicht wie ein gewöhnlicher Coupon, wobei je (optional) auch ein Sicherheitscode abgefragt werden kann:
Als Händler sehen Sie die verkauften oder eingelösten Gutscheine und Loyalty-Transaktionen als Zusatzfeld an den Bestellungen.
Ein Betrieb mit anderen Zahlungsarten ist möglich. Der Einsatz mit migrierten Gutscheinkarten ist möglich, sofern ein fester Nummernkreislauf existiert.
Installation und Grundeinstellungen
Voraussetzungen
Sie benötigen:
- Shopware 6.5 - 6.7 in der Self-Hosted-Variante
- MySQL-/MariaDB-Versionen ohne Einschränkungen (nutzt Zusatzfelder)
- Shopwährung EUR
- Vertrag mit der secupay AG (https://secucard.com/) über die Nutzung von secucard
Mit dem Vertrag erhalten Sie von uns:
- ZIP-Datei mit dem Plugin
- Client Credentials für die Verbindung (Client ID, Client Secret)
- Händler-ID (MRC_…)
- Terminal-ID für ein Virtuelles Terminal (VT…)
- Kartengruppen-IDs (CGR_…) für Ihre secucard Gutscheinprogramme
Installation per ZIP-Datei
Schritt-für-Schritt-Anleitung:
- Zur Installation erhalten Sie von uns eine ZIP-Datei. Spielen Sie diese im Shopware-Admin ein über Erweiterungen » Meine Erweiterungen » Erweiterung hochladen. Es erscheint eine Erfolgsmeldung.
- Suchen Sie secupay Gutscheine für Shopware 6. (Unter Umständen müssen Sie Inaktive Erweiterungen ausblenden deaktivieren.) Klicken Sie nun auf Installieren. Es erscheint eine Erfolgsmeldung.
Nach der Installation finden Sie nun:
- E-Mail-Vorlagen für den Versand der einzelnen Gutscheine und optional der Sicherheitscodes (CSC). Sie finden diese in Einstellungen » Inhalte » E-Mail-Templates (Shopware 6.7) oder Einstellungen » Shop » E-Mail-Templates (Shopware 6.5 - 6.6).
- E-Mail-Templatetypen secupay Voucher und secupay Security Codes.
- Zusatzfelder für Produkte und Bestellungen. Sie finden diese in Einstellungen » Inhalte » Zusatzfelder (Shopware 6.7) oder Einstellungen » System » Zusatzfelder (Shopware 6.5 - 6.6).
Die E-Mail-Vorlagen sowie die Zusatzfelder und entsprechende Daten bleiben auch bei einer Deinstallation erhalten.
An den Produkten und Bestellungen werden die Zusatzfelder erst sichtbar, wenn das Plugin aktiv ist.
Plugin aktivieren und Verbindung herstellen
Schritt-für-Schritt-Anleitung:
- Aktivieren Sie das Plugin im Shopware-Admin bei Erweiterungen » Meine Erweiterungen mit dem Schieberegler. Es erscheint eine Erfolgsmeldung.
- Konfigurieren Sie das Plugin über den Link Konfigurieren. Sie müssen Client ID, Client Secret, Händler-ID und Terminal-ID eingeben, damit alles funktioniert.
Hinweis für den Multipshop-Betrieb: Sie können die Konfiguration auf globaler Ebene vornehmen (Alle Verkaufskanäle) und auf Ebene der Verkaufskanäle anpassen, z. B. für separate virtuelle Terminals per Shopdomain. Wirksam werden wie üblich die Einstellungen, die für die einzelnen Verkaufskanäle resultieren.
Die Einstellung für das Systemprotokoll funktioniert aus technischen Gründen nur für Alle Verkaufskanäle.
Verkauf von Gutscheinen
Funktionsweise
Geschenkgutscheine werden als Produkte eingerichtet. Wenn ein oder mehrere Geschenkgutscheine im Warenkorb liegen, werden die Zahlungsarten an der Kasse entsprechend ihrer Einstellungen eingeschränkt. Wenn der Zahlungsstatus für die Bestellung zum ersten Mal auf „Bezahlt“ wechselt, werden die Gutscheine angelegt und als E-Mail an den Verkäufer versendet. Sofern der Sicherheitscode versendet werden soll, erhält der Käufer diese mit einer separaten E-Mail zugesendet.
Einstellungen für Gutscheinverkauf
Die allgemeinen Einstellungen für den Gutscheinverkauf finden Sie wiederum unter Erweiterungen » Meine Erweiterungen » secucard Gutscheine für Shopware 6 Konfigurieren:
Die Optionen im Einzelnen:
Option | Erklärung |
|---|---|
Verkauf von secucard-Gutscheinen erlauben | Mit dieser Option ist es möglich, die Verkauf von Gutscheinen zu erlauben oder auch zu unterbinden, z. B. wenn dies nur im Präsenzhandel gewünscht ist. |
Erlaubte Zahlungsart | Alle Zahlungsarten müssen einzeln erlaubt werden. Anderenfalls würden vorher unbekannte unsichere Zahlungsarten (z. B. Kauf auf Rechnung) automatisch erscheinen. |
E-Mail mit Sicherheitscode (CSC) senden | Versendet neben den E-Mails für die einzelnen Gutscheine eine weitere E-Mail mit den Sicherheitscodes der gerade angelegten Gutscheine an den Käufer. |
Bitte beachten Sie folgende Hinweise:
Hinweis für den Multishop-Betrieb: Sie können die Konfiguration auf globaler Ebene vornehmen (Alle Verkaufskanäle) und auf Ebene der Verkaufskanäle anpassen.
Erlauben Sie nur Zahlungsarten, die für Sie sicher genug sind. Wichtig ist auch, dass der Zahlungsstatus „Bezahlt“ erst gesetzt wird, wenn die Zahlung ausreichend sicher ist, zum Beispiel Kreditkarte und Vorkasse.
Als Gutschein konfigurierte Artikel werden nicht automatisch im Shop ausgeblendet, wenn der Verkauf deaktiviert oder keine Zahlungsarten eingerichtet sind. Dieses Einstellung muss separate für den Produktkatalog vorgenommen werden.
Produkte als secucard-Gutschein anlegen
Sobald ein Artikel mit einen secucard-Kartengruppe konfiguriert ist, wird er im Verkauf und beim Zahlungseingang als Kartenverkauf behandelt.
Die folgenden Produkteinstellungen müssen für alle Sprachen der betreffenden Verkaufskanäle eingestellt werden.
Nachdem das Produkt gespeichert ist, können Sie die Kartengruppen-ID unter Spezifikationen » Zusatzfelder » secucard Gutscheine einstellen:
Weiterhin ist die Einstellung auch an den Produktvarianten verfeinern, ebenfalls unter Spezifikationen » Zusatzfelder » secucard Gutscheine:
Der Aufladebetrag ist der Bruttopreis des Produktes oder der Variante.
E-Mail-Vorlagen anpassen
Die mitgelieferten Vorlagen sind sehr einfach gestaltet und lassen sich an die eigenen Bedürfnisse anpassen.
Die E-Mail-Vorlagen finden sich unter Einstellungen » Inhalte » E-Mail-Templates (Shopware 6.7) oder Einstellungen » Shop » E-Mail-Templates (Shopware 6.5 - 6.6):
Der Aufbau folgt den bei Shopware 6 üblichen Prinzipien. Für alternative Vorlagen können die E-Mail-Templatetypen secupay Voucher und secupay Security Codes verwendet oder vorhandene Vorlagen dupliziert werden.
E-Mail für Gutschein
Diese E-Mail wird beim Erreichen des Zahlungsstatus Bezahlt für jeden Gutschein einzeln an den Käufer gesendet. So kann dieser die Gutscheine einzeln an Personen weiterleiten, die er beschenken möchte. Umgesetzt ist das mit mitgelieferten Vorlage secucard Gutschein bzw. mit dem Templatetyp secupay Voucher.
Folgende Variablen stehen mit dem Templatetyp secupay Voucher für Kartendaten bereit:
Twig-Variable | Inhalt | Beispiel |
|---|---|---|
{{ voucherWithoutCsc.lineItem.label }} | Artikelname | Geschenkgutschein Motiv Frühling |
{{ voucherWithoutCsc.amount }} | Aufladebetrag | 50,00 |
{{ voucherWithoutCsc.currency }} | Währung | EUR |
{{ voucherWithoutCsc.cardNumber }} | volle Kartennummer | 9276999999996789 |
Der optionale Sicherheitscode (CSC) steht absichtlich nicht in dieser E-Mail bereit.
Beispiel:
{% if order.orderCustomer.salutation %}{{ order.orderCustomer.salutation.translated.letterName ~ ' ' }}{% endif %}{{ order.orderCustomer.firstName }} {{ order.orderCustomer.lastName }},Anbei Ihre Gutscheindaten für Ihre Bestellung mit der Nummer: {{ order.orderNumber }}Artikel: {{ voucherWithoutCsc.lineItem.label }}Aufladebetrag: {{ voucherWithoutCsc.amount }}{{ voucherWithoutCsc.currency }}Kartennummer/Gutscheincode: {{ voucherWithoutCsc.cardNumber }}Sofern erforderlich wird Ihnen der Sicherheitscode (CSC) separat mitgeteilt.Sollten Sie Fragen haben, zögern Sie nicht, uns zu kontaktieren.Optionale E-Mail für Sicherheitscodes (CSC)
Sofern aktiviert, wird diese E-Mail beim Erreichen des Zahlungsstatus Bezahlt für alle Gutscheine gemeinsam an den Käufer gesendet. So kann dieser, sofern benötigt, die Sicherheitscodes den Empfängern der Gutscheine mitteilen. Umgesetzt ist das mit der mitgelieferten Vorlage secucard Sicherheitscodes bzw. mit dem Templatetype secupay Security Codes.
Folgende Variablen stehen mit dem Templatetyp secupay Voucher für Kartendaten bereit:
Twig-Variable | Inhalt | Beispiel |
|---|---|---|
{{ voucher.lineItem.label }} | Artikelname | Geschenkgutschein Motiv Frühling |
{{ voucher.lineItem.unitPrice }} | Einzelpreis = Aufladebetrag | 25,00 |
{{ voucher.lastFourDigits }} | letzte vier Stellen der Kartennummer | 6789 |
{{ voucher.cscSecurityCode }} | Sicherheitscode (CSC) | 924 |
Beispiel:
{% if order.orderCustomer.salutation %}{{ order.orderCustomer.salutation.translated.letterName ~ ' ' }}{% endif %}{{ order.orderCustomer.firstName }} {{ order.orderCustomer.lastName }},Anbei die Karten-Sicherheitscodes für die Gutscheine für Ihre Bestellung mit der Nummer: {{ order.orderNumber }}ACHTUNG! Bitte achten Sie darauf, dass diese Codes Dritten nicht zugänglich gemacht werden. Geben Sie diese Codes nur EINZELN an die Empfänger der Gutscheine weiter.Artikel / Aufladebetrag / Kartennummer/Gutscheincode / Sicherheitscode (CSC)----------------------------------------------------------------------------{% for voucher in vouchersWithoutCardNumber %}{{ voucher.lineItem.label }} / {{ voucher.lineItem.unitPrice|currency('EUR') }} / Endet auf ***{{ voucher.lastFourDigits }} / {{ voucher.cscSecurityCode }}{% endfor %}----------------------------------------------------------------------------Sollten Sie Fragen haben, zögern Sie nicht, uns zu kontaktieren.Transaktionen und Karten an der Bestellung
Die Aufladung erfolgt automatisch, wenn der Zahlungsstatus der Bestellung zum ersten Mal auf Bezahlt gesetzt wird.
Zur Kontrolle finden Sie die secucard-Loyalty-Transaktionen sowie die Kartennummern der erzeugten Karten an der Bestellung. Sie finden diese unter Reiter Details » Zusatzfelder » secucard Gutscheine:
Mit diesen Daten können die Transaktionen und Karten in secuOffice (https://secuoffice.com/) nachgeschlagen werden.
Einlösung von Gutscheinen
Funktionsweise
Geschenkgutscheine werden wie gewöhnliche Gutscheine erfasst. Es können einer oder mehrere Gutscheine eingesetzt werden. Wenn im Checkoutprozess die Zahlung erfolgreich abgeschlossen werden kann, dann werden auch die Gutscheine belastet. Die Gutscheine erscheinen im Kaufprozess sowie in der Bestellung als Coupon-Position im Warenkorb. Sofern der Sicherheitscode abgefragt werden soll, erscheint die Abfrage beim Einfügen in den Warenkorb.
Eine automatische Reaktion beim Storno ist derzeit noch nicht gegeben.
Einstellungen für Gutschein-Einlösung
Die allgemeinen Einstellungen für die Gutscheineinlösung finden Sie unter Erweiterungen » Meine Erweiterungen » secucard Gutscheine für Shopware 6 Konfigurieren:
Die Optionen im Einzelnen:
Option | Erklärung |
|---|---|
Einlösung von secucard-Gutscheinen erlauben | Aktiviert die Einlösung von Gutscheinen. Mit dieser Option ist es möglich, die Einlösung von Gutscheinen zu erlauben oder auch unterbinden, z. B. wenn dies nur im Präsenzhandel gewünscht ist. |
Anfangsziffern | Der Gutschein wird anhand der Gutscheinnummern im Warenkorb erkannt. Der Nummernkreis von secupay umfasst 16-stellige Kartennummern, die mit 9276… beginnen. Sofern sie eigene Karten mit festem Nummernkreis migriert haben, können diese etwa mit: 1234 oder für beide Nummernkreise mit 9276;1234 erkennen. |
Sicherheitscode (CSC) für secucard prüfen | Damit erfolgt nach der Eingabe des Gutscheincodes die zusätzliche Abfrage des Sicherheitscodes (CSC), der auf der Rückseite physischer Gutscheine aufgedruckt ist bzw. bei digitalen Gutscheinen dem Kunden per separater E-Mail mitgeteilt wird. |
Bitte beachten Sie folgende Hinweise:
Bitte klären Sie, ob alle Gutscheine, die sie zulassen möchten, einen Sicherheitscode haben. Nicht alle physischen Gutscheinkarten haben einen Sicherheitscode (CSC) auf der Rückseite. Beachten Sie weiterhin die Einstellung für den Gutscheinverkauf: E-Mail mit Sicherheitscodes (CSC) senden (s. o.)
Einlösung aus Sicht des Käufers
Ein oder mehrere Geschenkgutscheine können wie in Shopware üblich durch Eingabe der Gutscheinnummer eingelöst werden. Dies erfolgt über das Feld "Gutscheincode" entweder im seitlichen Warenkorb (Off-Canvas-Cart) oder im seitenfüllenden Warenkorb.
Sofern eingestellt, erscheint eine Aufforderung zur Eingabe des Sicherheitscodes (CSC):
(Das Erscheinungsbild dieser Abfrage ist abhängig von Endgerät und Browser.)
Sofern der Gutscheincode und ggf. der Sicherheitscode (CSC) gültig ist und Guthaben aufweist, wird er wie ein Coupon als Position im Warenkorb angezeigt:
Die Eingabe mehrerer Gutscheine ist möglich; in diesem Fall erscheint jeder Gutschein als eigenständige Position im Warenkorb. Mit der Schaltfläche zum Entfernen von Gutscheinen (⌧ neben Betrag) können Gutscheine wieder aus dem Warenkorb entfernt werden.
Transaktionen und Karten an der Bestellung
Die Belastung des Gutscheines erfolgt mit Autorisierung der Zahlung im Checkout.
Zur Kontrolle finden Sie die secucard-Loyalty-Transaktionen sowie die Kartennummern der belasteten Karten an der Bestellung. Sie finden diese unter Reiter Details » Zusatzfelder » secucard Gutscheine:
Fehlerbehebung
Problem | Mögliche Ursachen und Lösungen |
|---|---|
Es werden keine Zahlungsarten angeboten. | Ursache 1: Die Shopwährung ist nicht in Euro. Bieten Sie den Gutschein nur in Verkaufskanälen mit Euro an. Ursache 2: Sie haben keine Zahlungsart erlaubt. Erlauben Sie die gewünschten Zahlungsarten. Bitte beachten Sie, dass Shopware eine zweistufige Konfiguration erlaubt, global für Alle Verkaufskanäle und verfeinert für einzelne Verkaufskanäle. Wirksam ist die Einstellung, die für den einzelnen Verkaufskanal resultiert. |
Obwohl keine Zahlungsarten angeboten werden, kann der Käufer abschließen. | Ursache: Shopware kennt aus vorherigen Käufen, Einstellungen des Händlers am Verkaufskanal und einer Präferenzeinstellung für angemeldete Benutzer eine Vorauswahl. Auch wenn diese nicht sichtbar ist und nicht aktiv gewählt wurde, kann diese Zahlungsart zur Verfügung stehen und ausgeführt werden. Unser Plugin hat hierauf keinen Einfluss. Sofern immer eine Zahlungsart verfügbar ist (z. B. eine Vorkasse), tritt diese Konstallation nicht auf. |
Es werden alle Zahlungsarten angeboten. | Ursache 1: Das Plugin ist nicht aktiv. Produkte mit Kartengruppen-ID können bei inaktivem Plugin nicht automatisch verborgen werden. Sie müssen von Hand deaktiviert werden. Ursache 2: Das Produkt wird nicht als Gutschein erkannt. Bitte prüfen Sie, ob einen Kartengruppen-ID hinterlegt ist. Bitte beachten Sie, dass Produkteinstellungen für jede Sprache hinterlegt werden müssen, die im Verkaufskanal gewählt werden kann. |
Die Gutscheine werden nicht erzeugt. | Ursache 1: Das Produkt wird nicht als Gutschein erkannt. Bitte prüfen Sie, ob einen Kartengruppen-ID hinterlegt ist. Bitte beachten Sie, dass Produkteinstellungen für jede Sprache hinterlegt werden müssen, die im Verkaufskanal gewählt werden kann. Ursache 2: Die Kartengruppen-ID ist fehlerhaft. Prüfen Sie ggf. die Logdatei var/log/secucard_vouchers_prod_YYYY-MM-DD.log auf entsprechende Hinweise. Ursache 3: Der Zahlungsstatus „Bezahlt“ wird von einem Zahlungsplugin nicht auf die vorgesehene Weise gesetzt. Setzen Sie den Status ggf. noch einmal per Hand. Weisen Sie den Hersteller des Plugins darauf hin. |
Man kann nur einen Gutschein von jeder Sorte kaufen. | Ursache 1: Das Produkt ist als digitales Produkt angelegt. Legen Sie das Produkt stattdessen als gewöhnliches (physisches) Produkt an. Stellen Sie das Produkt auf Versandkostenfrei. Sie finden diese Einstellung am Produkt oder der Variante bei Allgemein » Lieferbarkeit. Ursache 2: Sie haben eine Maximalabnahme konfiguriert. Prüfen Sie die Einstellung am Produkt oder der Variante bei Allgemein » Lieferbarkeit. |