Plugin

JTL 5 Integration plugin for Mondu Payment.

Installation

1. Download .zip folder from the main branch on Github repository
2. Navigate to the JTL Shop administration dashboard
3. Navigate to the Plug-in manager from the sidebar
4. Choose Upload tab and upload the downloaded plugin file
5. Navigate to the Available tab and install the Mondu Payments plugin

JTL Shop Configuration

Configure API

1. Navigate to the JTL Shop administration dashboard
2. Expand Installed plug-ins menu item on the left side and choose Mondu Payment
3. Configure the fields:
   • API Sandbox Mode: Select yes to point the plugin to the sandbox environment
   • Fill in API Secret (will be done automatically)
   • Save configuration
   • Click register webhooks button

Configure Payment Methods

1. Navigate to the Shipments -> Shipping Methods
2. Select desired Shipping method and click on edit icon
3. Enable Mondu Payment in the ACCEPTED PAYMENT METHODS section

JTL Wawi Configuration

Add Payment Methods

1. Navigate to the Payments -> Payment Methods in JTL Wawi
2. Add following payment methods:

Ratenkauf (3, 6, 12 Monaten)
SEPA-Lastschrift (30 Tage)
Rechnungskauf (30 Tage)
Echtzeitüberweisung

Note: Please add or modify the net terms accordingly your contractual agreement.

In case the Mondu Payment Method names are changed manually in the JTL Shop, please update them accordingly in JTL Wawi.

Create Invoice Workflow

1. Navigate to the Admin -> JTL-Workflows

2. Select Rechnungen tab

3. Select Rechnungen -> Erstellt -> Rechnungen_Erstellt workflow

4. Configure condition with "One condition met" (Eine Bedingung erfüllt")

   New installation:

   Just create the workflows with the name of the payment methods which are mentioned in step 2 (add payment methods):

   • Ratenkauf (3, 6, 12 Monaten)
   • SEPA-Lastschrift (30 Tage)
   • Rechnungskauf (30 Tage)
   • Echtzeitüberweisung

   Update from existing installation:

   Update the conditions so that the rules will match for old AND new naming e.g.:

   • Ratenkauf (3, 6, 12 Monaten)
   • SEPA-Lastschrift (30 Tage)
   • Rechnungskauf (30 Tage)
   • Echtzeitüberweisung
     OR create additional rules so that all new payment methods will be covered
   1. Rechnungen\Auftrag\Zahlungsart\Name Enthalt Rechnungskauf
   2. Rechnungen\Auftrag\Zahlungsart\Name Enthalt SEPA-Lastschrift
   3. Rechnungen\Auftrag\Zahlungsart\Name Enthalt Rate
   4. Rechnungen\Auftrag\Zahlungsart\Name Enthalt Echtzeitüberweisung

5. Configure action

   1. Web-Request POST:
      1. URL:

         http://{SHOP-URL}/mondu-api?return=invoice-create&webhooks_secret={WEBHOOK SECRET}
         

      2. Parameter:

         gross_amount_cents={{ Vorgang.Auftrag.Positionen.BruttopreisGesamt2 }}&net_amount_cents={{ Vorgang.Auftrag.Positionen.NettopreisGesamt2 }}&invoice_id={{ Vorgang.Rechnungsnummer }}&order_id={{ Vorgang.Auftrag.ExterneAuftragsnummer }}
         

      3. Header:

         Content-Type: application/x-www-form-urlencoded
         

Cancel Invoice Workflow

1. Navigate to the Admin -> JTL-Workflows

2. Select Rechnungen tab

3. Select Rechnungen - Manuell, create new Event with "Ereignis anlegen" button

4. Create new event

5. Configure condition with "One condition met" (Eine Bedingung erfüllt")

   New installation:

   Just create the workflows with the name of the payment methods which are mentioned in step 2 (add payment methods):

   • Ratenkauf (3, 6, 12 Monaten)
   • SEPA-Lastschrift (30 Tage)
   • Rechnungskauf (30 Tage)
   • Echtzeitüberweisung

   Update from existing installation:

   Update the conditions so that the rules will match for old AND new naming e.g.:

   • Ratenkauf (3, 6, 12 Monaten)
   • SEPA-Lastschrift (30 Tage)
   • Rechnungskauf (30 Tage)
   • Echtzeitüberweisung
     OR create additional rules so that all new payment methods will be covered
   1. Rechnungen\Auftrag\Zahlungsart\Name Enthalt Rechnungskauf
   2. Rechnungen\Auftrag\Zahlungsart\Name Enthalt SEPA-Lastschrift
   3. Rechnungen\Auftrag\Zahlungsart\Name Enthalt Rate
   4. Rechnungen\Auftrag\Zahlungsart\Name Enthalt Echtzeitüberweisung

6. Configure action

   1. Web-Request POST:
      1. URL:

         http://{SHOP-URL}/mondu-api?return=cancel-invoice&webhooks_secret={WEBHOOK SECRET}
         

      2. Parameter:

         invoice_number={{ Vorgang.Rechnungsnummer }}
         

      3. Header:

         Content-Type: application/x-www-form-urlencoded
         

Cancel Order Workflow

1. Navigate to the Admin -> JTL-Workflows

2. Select Auftrage tab

3. Select Auftrag -> Storniert and create a workflow

4. Configure condition with "One condition met" (Eine Bedingung erfüllt")

   New installation:

   Just create the workflows with the name of the payment methods which are mentioned in step 2 (add payment methods):

   • Ratenkauf (3, 6, 12 Monaten)
   • SEPA-Lastschrift (30 Tage)
   • Rechnungskauf (30 Tage)
   • Echtzeitüberweisung

   Update from existing installation:

   Update the conditions so that the rules will match for old AND new naming e.g.:

   • Ratenkauf (3, 6, 12 Monaten)
   • SEPA-Lastschrift (30 Tage)
   • Rechnungskauf (30 Tage)
   • Echtzeitüberweisung
     OR create additional rules so that all new payment methods will be covered
   1. Rechnungen\Auftrag\Zahlungsart\Name Enthalt Rechnungskauf
   2. Rechnungen\Auftrag\Zahlungsart\Name Enthalt SEPA-Lastschrift
   3. Rechnungen\Auftrag\Zahlungsart\Name Enthalt Rate
   4. Rechnungen\Auftrag\Zahlungsart\Name Enthalt Echtzeitüberweisung

5. Configure action

   1. Web-Request POST:
      1. URL:

         http://{SHOP-URL}/mondu-api?return=cancel-order&webhooks_secret={WEBHOOK SECRET}
         

      2. Parameter:

         order_number={{ Vorgang.Stammdaten.ExterneAuftragsnummer }}
         

      3. Header:

         Content-Type: application/x-www-form-urlencoded
         

Configure Invoice Template

1. Open your JTL-Wawi and navigate to the Admin -> Druck- / E-Mail- / Exportvorlagen
2. Find Rechnung item under Root and click Bearbeiten to edit invoice template

3. Under Payment blocks, copy any of the payment block and then paste it under payment blocks table

4. Change the name to Payment with Mondu Invoice

5. Right click on this block and choose "Edit element or block"
6. Change the block structure to match the one in the screenshot

7. Copy the text below and change the values as needed:

"Diese Rechnung wurde abgetreten gemäß den Allgemeinen Bedingungen von [MERCHANT] und Mondu GmbH zum Modell Kauf auf Rechnung. Wir bitten um schuldbefreiende Zahlung auf folgendes Konto:

Kontoinhaber: Mondu Capital Sàrl

IBAN:
" + If(Report.InvoiceBillToAddress.CountryISO= "DE","DE_IBAN","") + " +
" + If(Report.InvoiceBillToAddress.CountryISO= "NL","NL_IBAN","") + "

BIC: HYVEDEMME40

Verwendungszweck: " + Report.InvoiceNumber + "

Zahlungsziel: [XX] Tage"

8. Change the display condition for created payment block

Report.PaymentMethodName = "Rechnungskauf - jetzt kaufen, später bezahlen"

9. Repeat all of the steps for other payment methods. Please refer to the Mondu Invoice Snippets for text blocks in Mondu Documentation.

Development

JTL Shop

1. Download and configure MAMP for MacOS or XAMPP for Windows
2. Download and install JTL 5 Shop community version and install on the local server
3. Upload plugin through admin dashboard or clone the repository in the JTL Shop's /plugins directory

JTL Wawi

1. Download JTL Wawi
2. Use Parallels Desktop with Windows 10, 11 or similar alternatives to install JTL Wawi on MacOS environment
3. Connect the JTL Wawi with JTL Shop
4. Configure the JTL-Workflow