Zahlungsarten einer Versandart zuordnen

Die folgende Einstellung ist seitens JTL notwendig, um die Zahlungsart generell zu aktivieren. Wenn nichts anderes eingestellt wird, erscheint die Zahlungsart zunächst im Demo-Modus.

Um unsere Zahlungsarten den Versandarten zuzuordnen, öffnen Sie im Administrations-Backend des Shops den Punkt „Versand“ » „Versandarten“. Sie finden dort eine Übersicht aller Versandarten:

Klicken Sie bei den jeweiligen Versandarten auf das Stiftsymbol (Tooltip „Bearbeiten“). Es öffnet sich eine Seite mit den Einstellungen der Versandart:

Wählen Sie die gewünschten Zahlungsarten der secupay AG und übernehmen Sie diese Einstellungen mit Klick auf den Button „Speichern“ (ganz untern auf der Seite).

Die Zahlungsarten der secupay sind nun aktiv. Zur Erinnerung: Voreingestellt ist der Demo-Modus.

Zahlungsarten von Demo auf Produktion schalten

Die Einstellung zur Umstellung von Demo- auf Live-Transaktion finden Sie bei den einzelnen Zahlungsarten.

Öffnen Sie dazu den Hauptpunkt „Zahlungsarten“. Die secupay-Zahlungsarten sind mit secupay AG gekennzeichnet:

Klicken Sie dort jeweils auf das Stiftsymbol (Tooltip „Bearbeiten“). Sie sehen die Seite mit den Einstellungen der Zahlungsarten.

Wählen Sie unter „Demo-Modus“ die Option „echte Transaktionen erzeugen“ und übernehmen Sie diese Einstellung mit Klick auf den Button „Speichern“ (ganz untern auf der Seite).

Workflow-URL

Über die Workflow-URL definieren Sie die Adresse, an die die Wawi Aktualisierungen sendet. Die Workflow-URL benötigen Sie jeweils für alle vier einzurichtenden Workflows (Rechnungsnummer, Cancel, Refund, Betragsanpassung.

Muster: <Shop-Basis-URL>/secupay_update

Unter „Plugins“ » „Installierte Plugins“ » „secupay Payments“ wird Ihnen im Tab „Wawi-Anleitung“ die individuelle URL für Ihren Shop vollständig angezeigt.

Auftragsattribute „secupay_pci“ und „secupay_trans_id“ anlegen

1. Öffnen Sie das Dialogfenster über das Menü „Admin“ » „Eigene Felder“.

2. Wählen Sie die Gruppe „Automatisch generiert“. Falls die Gruppe „Automatisch generiert“ nicht existiert, legen Sie diese bitte an.

3. Klicken Sie auf die Schaltfläche „Feld anlegen“ und tragen Sie im sich öffnenden Dialog den Namen „secupay_pci“ für das Auftragsattribut ein. Den Datentyp belassen Sie bei Freitext.

4. Wiederholen Sie die Anlage und legen Sie ein weiteres Feld „secupay_trans_id“ an.

5. Klicken Sie anschließend auf „Speichern“, um die neuen Einstellungen zu übernehmen.

Workflow „Rechnungsnummer übermitteln“ einrichten

1. Öffnen Sie die JTL-Workflows über das Menü „ Admin“ » „JTL-Workflows“ .

2. Klicken Sie im Workflow-Dialog auf den Reiter „Versand“.

3. Wählen Sie links unter Auslösende Ereignisse „Lieferscheine“ » „Versendet“ .

4. Klicken Sie links unten den Button „Workflow anlegen“.

5. Vergeben Sie für den erstellten Workflow einen aussagekräftigen Namen, z. B. „Rechnungsnummer_übermitteln“.

6. Als Aktion wählen Sie „Web-Request“ aus.

7. Als Methode verwenden Sie „POST“.

8. Unter „URL“ tragen Sie die Workflow-URL ein.

9. Tragen Sie im Feld „Header“ den Wert „Content-Type: application/x-www-form-urlencoded“ ein.

10. Setzen Sie einen Haken bei „Bei Fehler Workflow abbrechen“.

11. Klicken Sie hinter dem Feld „Body“ auf den Button „...“ und fügen Sie folgenden Code in das Feld ein:

    {% capture query -%}

    SELECT cValue FROM tBestellungAttribute

    JOIN tBestellung ON tBestellung.kBestellung = tBestellungAttribute.kBestellung

    WHERE tBestellung.cBestellNr = '{{ Vorgang.Auftrag.Auftragsnummer }}'

    AND tBestellungAttribute.cName = 'secupay_pci'

    {% endcapture -%}

    {% assign secupay_pci = query | DirectQueryScalar %}

    {% capture query -%}

    SELECT kBestellung FROM tBestellung WHERE tBestellung.cBestellNr = '{{ Vorgang.Auftrag.Auftragsnummer }}'

    {% endcapture -%}

12. Klicken Sie anschließend auf „Speichern“, um die neuen Einstellungen zu übernehmen.

Workflow „Auftrag storniert“ einrichten

1. Öffnen Sie die JTL-Workflows über das Menü „ Admin“ » „JTL-Workflows“ .

2. Klicken Sie im Workflow-Dialog auf den Reiter „Aufträge“.

3. Wählen Sie links unter Auslösende Ereignisse „Auftrag“ » „Storniert“ .

4. Klicken Sie links unten den Button „Workflow anlegen“.

5. Vergeben Sie für den erstellten Workflow einen aussagekräftigen Namen, z. B. „Auftrag_Storniert“.

6. Als Aktion wählen Sie „Web-Request“ aus.

7. Als Methode verwenden Sie "POST".

8. Nach der Auswahl der Aktion werden Sie aufgefordert eine URL und die zu nutzenden Parameter anzugeben. Tragen Sie hier nun [IhreURL]/secupay_update in das Feld „Url“ des Workflows ein.

9. Tragen Sie nun in dem Feld Header "Content-Type:application/x-www-form-urlencoded" ein.

10. Setzen Sie einen Haken bei "Bei Fehler Workflow abbrechen".

11. Klicken Sie hinter dem Feld „Body“ auf den Button „...“ und fügen Sie folgenden Code in das Feld ein:

    {% capture query -%}

    SELECT cValue FROM tBestellungAttribute

    JOIN tBestellung ON tBestellung.kBestellung = tBestellungAttribute.kBestellung

    WHERE tBestellung.cBestellNr = '{{ Vorgang.Stammdaten.Auftragsnummer }}'

    AND tBestellungAttribute.cName = 'secupay_pci'

    {% endcapture -%}

    {% assign secupay_pci = query | DirectQueryScalar %}

    {% capture query -%}

    SELECT kBestellung FROM tBestellung WHERE tBestellung.cBestellNr = '{{ Vorgang.Stammdaten.Auftragsnummer }}'

    {% endcapture -%}

    {% assign kBestellung = query | DirectQueryScalar %}

    &action=cancel&secupay_pci={{ secupay_pci }}&kBestellung={{ kBestellung }}&ExterneAuftragsnummer={{ Vorgang.Stammdaten.ExterneAuftragsnummer }}&Gesamtbruttopreis={{ Vorgang.Zahlungen.Gesamtbruttopreis }}&Rechnungsnummer={{ Vorgang.Zahlungen.Letzte_Rechnung.Rechnungsnummer }}&Auftragsnummer={{ Vorgang.Stammdaten.Auftragsnummer }}

12. Klicken Sie anschließend auf „Speichern“, um die neuen Einstellungen zu übernehmen.

Workflow „Refund“ einrichten

1. Öffnen Sie die JTL-Workflows über das Menü „ Admin“ » „JTL-Workflows“ .

2. Klicken Sie im Workflow-Dialog auf den Reiter „Rechnungen“.

3. Wählen Sie links unter Auslösende Ereignisse „Rechnungskorrektur“ » „Geändert“ .

4. Klicken Sie links unten den Button „Workflow anlegen“.

5. Vergeben Sie für den erstellten Workflow einen aussagekräftigen Namen, z. B. "Secupay-Refund"

6. Als Aktion wählen Sie „Web-Request“ aus.

7. Als Methode verwenden Sie "POST".

8. Nach der Auswahl der Aktion werden Sie aufgefordert eine URL und die zu nutzenden Parameter anzugeben. Tragen Sie hier nun Ihre Workflow URL in das Feld „Url“ des Workflows ein.

9. Tragen Sie nun in dem Feld Header "Content-Type:application/x-www-form-urlencoded" ein.

10. Setzen Sie einen Haken bei "Bei Fehler Workflow abbrechen".

11. Klicken Sie hinter dem Feld „Body“ auf den Button „...“ und fügen Sie folgenden Code in das Feld ein:

    {% capture query -%}

    SELECT cValue FROM tBestellungAttribute

    JOIN tBestellung ON tBestellung.kBestellung = tBestellungAttribute.kBestellung

    WHERE tBestellung.cBestellNr = '{{ Vorgang.Auftrag.Auftragsnummer }}'

    AND tBestellungAttribute.cName = 'secupay_pci'

    {% endcapture -%}

    {% assign secupay_pci = query | DirectQueryScalar %}

    {% capture query -%}

    SELECT kBestellung FROM tBestellung WHERE tBestellung.cBestellNr = '{{ Vorgang.Auftrag.Auftragsnummer }}'

    {% endcapture -%}

    {% assign kBestellung = query | DirectQueryScalar %}

    &action=refund&secupay_pci={{ secupay_pci }}&kBestellung={{ kBestellung }}&ExterneAuftragsnummer={{ Vorgang.Auftrag.ExterneAuftragsnummer }}&Gesamtbruttopreis={{ Vorgang.Auftrag.Gesamtbruttopreis }}&Rechnungsnummer={{ Vorgang.Rechnung.Rechnungsnummer }}&Auftragsnummer={{ Vorgang.Auftrag.Auftragsnummer }}&Rechnungskorrekturnummer={{ Vorgang.Rechnung.Rechnungskorrekturen.ErstesObjekt.Rechnungskorrekturnummer }}&RechnungskorrekturenGesamtbetrag={{ Vorgang.Rechnung.RechnungskorrekturenGesamtbetrag }}&text={{ Vorgang.Rechnung.Text }}&KundenText={{ Vorgang.Rechnung.Rechnungskorrekturen.ErstesObjekt.KundenText }}

12. Klicken Sie anschließend auf „Speichern“, um die neuen Einstellungen zu übernehmen.

Workflow „Betragsanpassung“ einrichten

1. Öffnen Sie die JTL-Workflows über das Menü „ Admin“ » „JTL-Workflows“ .

2. Klicken Sie im Workflow-Dialog auf den Reiter „Aufträge“.

3. Wählen Sie links unter Auslösende Ereignisse „Auftrag“ » „Geändert“ .

4. Klicken Sie links unten den Button „Workflow anlegen“.

5. Vergeben Sie für den erstellten Workflow einen aussagekräftigen Namen, z. B. "Secupay-Betragsanpassung"

6. Als Aktion wählen Sie „Web-Request“ aus.

7. Als Methode verwenden Sie "POST".

8. Nach der Auswahl der Aktion werden Sie aufgefordert eine URL und die zu nutzenden Parameter anzugeben. Tragen Sie hier nun Ihre Workflow URL in das Feld „Url“ des Workflows ein.

9. Tragen Sie nun in dem Feld Header "Content-Type:application/x-www-form-urlencoded" ein.

10. Setzen Sie einen Haken bei "Bei Fehler Workflow abbrechen".

11. Klicken Sie hinter dem Feld „Body“ auf den Button „...“ und fügen Sie folgenden Code in das Feld ein:

    {% capture query -%}

    SELECT cValue FROM tBestellungAttribute

    JOIN tBestellung ON tBestellung.kBestellung = tBestellungAttribute.kBestellung

    WHERE tBestellung.cBestellNr = '{{ Vorgang.Stammdaten.Auftragsnummer }}'

    AND tBestellungAttribute.cName = 'secupay_pci'

    {% endcapture -%}

    {% assign secupay_pci = query | DirectQueryScalar %}

    {% capture query -%}

    SELECT kBestellung FROM tBestellung WHERE tBestellung.cBestellNr = '{{ Vorgang.Stammdaten.Auftragsnummer }}'

    {% endcapture -%}

    {% assign kBestellung = query | DirectQueryScalar %}

    &action=amount_correction&secupay_pci={{ secupay_pci }}&kBestellung={{ kBestellung }}&ExterneAuftragsnummer={{ Vorgang.Stammdaten.ExterneAuftragsnummer }}&Gesamtbruttopreis={{ Vorgang.Zahlungen.Gesamtbruttopreis }}&Betragoffen={{ Vorgang.Zahlungen.OffenerBetrag }}&rabatt={{ Vorgang.Zahlungen.Rabatt }}

12. Klicken Sie anschließend auf „Speichern“, um die neuen Einstellungen zu übernehmen.

Zahlungsarten anlegen

Für die korrekte Zuordnung der Zahlungsart zur Bestellung müssen die secupay-Zahlungsarten in der JTL Wawi hinterlegt werden.

Richten Sie in der für jede verwendete secupay-Zahlungsart in JTL Shop eine gleichnamige Zahlungsart in der JTL Wawi ein. Maßgeblich ist das Feld „Angezeigter Name (Deutsch)“ bzw. „Angezeigter Name (Englisch)“ in JTL Shop.

Für Transaktionen im Demo-Modus muss zusätzlich eine Zahlungsart mit dem Hinweis "… (Test oder Demo Transaktion)" angelegt werden.

Diese Namen sind derzeit voreingestellt:

Wenn Kreditkarte unverändert verwendet wird, müssen in der JTL Wawi folgende Zahlungsarten angelegt werden:

• „Kreditkarte“ / „Credit Card“

• „Kreditkarte (Test oder Demo Transaktion)“ / „Credit Card (Test oder Demo Transaktion)“

Wenn der Name z. B. auf „VISA oder MasterCard“ angepasst wurde, muss der Name in der JTL Wawi entsprechende lauten.

Gehen Sie zum Anlegen der Zahlungsarten wie folgt vor:

1. Öffnen Sie den Dialog „Zahlungen“ » „Zahlungsarten“:

2. Für jede Zahlungsart in JTL Wawi klicken Sie unten links auf „Anlegen“:

3. Tragen Sie jeweils den deutsch- und den englischsprachigen Namen ein.

4. Bestätigen Sie abschließend mit „Speichern“, um die neuen Einstellungen zu übernehmen.

Einbinden der Zahlungsinformation auf Rechnung

Muster:

Rechnungstexte in älterer Wawi-Version

Wenn Sie in der Konfiguration des Rechnungskauf-Moduls bei der Auswahl Feld Zahlungsdaten die Option Kommentar/Hinweisfeld gewählt haben, achten Sie bitte darauf, dass die Variable Vorgang.Hinweis.Text in Ihrer Rechnungsformular-Vorlage eingebunden ist. Nur somit wird der Abtretungstext inkl. der Bankverbindung auf der Rechnung erzeugt. Dies dann auch in einer eventuell eingerichteten Fremdsprache wiederholen.

Bei Wahl der Option „Rechnungskauf-Text“ wird der Abtretungstext automatisch in der Wawi-Vorlage eingebunden.

Globale Einstellungen

Folgende globale Einstellungen sind weiterhin möglich:

• Shopname (Kurzform) – Alternativer Shopname z. B. für den Verwendungszweck bei Lastschrift.

• Abgebrochene Bestellungen übertragen – Standardmäßig werden angebrochene Bestellungen als bereits an die JTL Wawi übertragen gekennzeichnet. Sie können diese Verhalten ändern.

• Live oder Sandbox – Hier können Sie auf die Sandbox-Umgebung für die Softwareentwicklung wechseln.

Einstellungen für einzelne Zahlungsarten

Folgende Einstellungen sind für alle Zahlungsarten möglich:

• angezeigter Name, Name der Gebühr, Hinweistext im Onlineshop und E-Mail (jeweils deutsch und englisch)

• eine Bild-URL

• erlaubte Kundegruppen

• eine Sortiernummer für die Reihenfolge der Zahlungsarten in der Zahlungsartenauswahl

• ob E-Mails zur Zahlungsbestätigung oder bei Storno versendet werden sollen

• ob die Zahlung vor oder nach Bestellabschluss erfolgen soll (bzw. ob die Bestellung vor der Zahlung oder erst bei erfolgreicher Autorisierung generiert werden soll)

• ob der Demo-Modus aktiv ist

• ob die Zahlungsart erst nach einer Anzahl Käufe angeboten werden soll

• ob die Zahlungsart durch einem Mindest- oder Höchstwert (jeweils Warenwert) eingeschränkt werden soll

• ob die Zahlungsart bei abweichender Lieferanschrift angeboten werden soll

• in welchem Feld die Zahlungsdaten in der JTL Wawi erscheinen sollen

Folgende Einstellungen sind weiterhin für einzelne Zahlungsarten möglich:

• Kreditkarte: ein- oder mehrzeiliges Formular

• Lastschrift: individueller Text für den Verwendungszweck (Platzhalter für Shopname, Kaufdatum und Bestellnummer