In diesem Dokument wird die Installation und Konfiguration des WooCommerce-Plugins abilita PAY Schritt für Schritt erläutert. Das Plugin ermöglicht eine nahtlose Integration verschiedener Zahlungsoptionen in Ihren WooCommerce-Shop und bietet eine benutzerfreundliche Verwaltung von Transaktionen.

1. Download der Installationsdatei

Bitte laden Sie das Plugin über den folgenden Link herunter:

abilita PAY – Version 1.0.6

2. Vorbereitung

Um das Plugin zu installieren, benötigen Sie die Berechtigung, neue Plugins in WordPress hinzuzufügen. Diese Berechtigung ist standardmäßig für Administratoren verfügbar.

Melden Sie sich im Admin-Bereich Ihrer WordPress-Installation an.

Plugin-Zip hochladen

• Installationsseite aufrufen
  Navigieren Sie im WordPress-Dashboard zu Plugins > Installieren, um die Seite für die Plugin-Installation zu öffnen.
• Plugin hochladen
  Klicken Sie auf Plugin hochladen, um den Upload-Bereich zu öffnen.
• Datei auswählen
  Wählen Sie die zuvor auf Ihre Festplatte heruntergeladene Plugin-ZIP-Datei vom Speicherort aus und klicken Sie anschließend auf Jetzt installieren.
• Plugin aktivieren
  Nach erfolgreichem Upload werden Sie zur Bestätigungsseite weitergeleitet. Klicken Sie dort auf Plugin aktivieren, um das Plugin zu aktivieren.
• Erfolgreiche Installation
  Nach erfolgreicher Aktivierung erscheint der Menüpunkt abilita PAY in der linken Toolbar des WordPress-Dashboards.

4. Plugin-Einstellungen

• Navigieren Sie in der Admin-Navigation zum Menüpunkt abilita PAY.
• Folgende Einstellungs-Bereiche werden Ihnen dargestellt
  • Transaktionen
  • Bezahlstatus
  • API Zugangsdaten
  • Checkliste
  • Sonstiges

Diese werden in den nächsten Punkten Schritt für Schritt erläutert.

4.1 Plugin-Einstellungen / Transaktionen

• Auf dieser Seite werden alle Transaktionen der verschiedenen Zahlungsarten angezeigt, die in Ihrem Shop durchgeführt wurden.
• Aus Leistungsgründen werden standardmäßig nur die Transaktionen der letzten 24 Stunden geladen.
• Sie können Transaktionen nach Zahlungsart und Zahlungsstatus filtern.
• Zusätzlich steht eine Suchfunktion zur Verfügung, mit der Sie gezielt nach bestimmten Bestellungen suchen können.

4.2 Plugin-Einstellungen / Bezahlstatus

• Auf dieser Seite werden Ihre WooCommerce-Statuswerte den entsprechenden abilita-Statuswerten zugeordnet.
  
  Diese Einstellungen sind standardmäßig mit Installation schon so gesetzt, dass ein reibungsloser Ablauf in der Zusammenarbeit mit abilita gewährleistet ist.
  
  Ändern Sie diese Zuordnung daher nur unter vorheriger Absprache mit abilita.
  
• Achten Sie besonders darauf, dass der abilita-Status “completed” nicht dem WooCommerce-Status “Abgeschlossen” zugewiesen werden darf, da dieser in WooCommerce bedeutet, dass die Bestellung vollständig abgewickelt wurde.

WooCommerce verfügt leider über keinen differenzierteren Zahlungsstatus wie “Zahlung abgeschlossen”.

4.3 Plugin-Einstellungen / API-Zugangsdaten

• Geben Sie an dieser Stelle bitte Ihre API-Zugangsdaten ein, um Ihren Shop mit dem abilita Payment Gateway zu verbinden. An welcher Stelle Sie diese finden, erklären wir Ihnen im Nachfolgenden.
• Als erstes können Sie unter dem ersten Punkt API-Umgebung wählen, ob Sie sich mit der Testumgebung (Sandbox) oder mit der Produktionsumgebung (Live) des abilita Payment Gateways verbinden wollen.
• Die API-Zugangsdaten finden Sie, indem Sie sich mit Ihren Zugangsdaten im abilita Payment Gateway einloggen.
• Hier gelangen Sie zur Testumgebung des abilita Payment Gateways: https://testdashboard.abilitapay.de/auth/login
• Hier gelangen Sie zur Produktionsumgebung des abilita Payment Gateways: https://dashboard.abilitapay.de/auth/login
• Falls Sie noch keine Zugangsdaten zum abilita Payment Gateway haben, melden Sie sich bei abilita, um diese zu erhalten.
• Klicken Sie nach erfolgreichem Login in der gewünschten Umgebung des Payment Gateways rechts oben auf „Mein Unternehmen“:
  
• Dort finden Sie die benötigten API-Zugangsdaten:
  
  (Der Incoming Key wird für WooCommerce-Shopsysteme nicht benötigt)
• Übernehmen Sie diese nun in Ihren WooCommerce-Shop:
  
• Bitte achten Sie unbedingt darauf, dass Sie nicht die Daten aus der Testumgebung des abilita Payment Gateways in die Produktionsumgebung Ihres WooCommerce-Shops übernehmen oder andersherum.
• Speichern Sie Ihre Eingaben, indem Sie auf Änderungen speichern klicken.

4.4 Plugin-Einstellungen / Checkliste

• Aktivierung Zahlungsarten
  Wenn Sie die vorherigen Schritte dieser Anleitung bereits erledigt haben, gibt es hier nichts weiter für Sie zu tun.
• Zahlungsstatus
  Wenn Sie die vorherigen Schritte dieser Anleitung bereits erledigt haben, gibt es hier nichts weiter für Sie zu tun.
• Ware reservieren (Minuten)
  WooCommerce hat in seinen Standard-Einstellungen 60 Minuten für die Reservierungen von Waren einer Bestellung hinterlegt. Dies bedeutet, dass wenn ein Kunde mit den Zahlungsarten: Vorkasse, Rechnung oder SEPA-Lastschrift eine Bestellung durchführt, reserviert WooCommerce die bestellten Produkte lediglich für 60 Minuten. Nach 60 Minuten würde eine Bestellung automatisch von WooCommerce storniert und der Bestand aufgewertet.
  
  Da bei den Zahlungsarten Vorkasse, Rechnung oder SEPA-Lastschrift der Zahlungseingang einige Tage dauern kann, sollten Sie den hinterlegten Wert komplett entfernen und die Änderung speichern.
  
  Navigieren Sie hierzu in Ihre Lagerbestand-Einstellungen in Ihrem Shopsystem und löschen Sie den dort evtl. vorhandenen Wert:
  
• Permalinks
  Achten Sie bitte darauf, dass Sie die Permalink-Einstellungen nicht auf Individuelle Struktur gesetzt haben. Hintergrund ist, dass in diesem Fall keine WooCommerce bzw. WordPress API-Endpunkte mehr aufgerufen werden können. Diese werden allerdings für alle Zahlungsarten benötigt. abilita PAY meldet über diese API-Endpunkte aktuelle Nachrichten einer Bestellung und der genutzten Zahlungsart.
  
  Bitte nutzen Sie nur: Tag und Name, Monat und Name, Numerisch oder Beitragsname
  
  Wir gehen davon aus, dass Sie diese Einstellungen aus SEO-Gründen bereits gemacht haben. Stellen Sie es bitte trotzdem einmal sicher hier:
  
• Germanized > Sendungen > Allgemein > Automatisierung
  Bitte prüfen Sie, ob in Germanized die automatische Statusänderung von Bestellungen auf „fertiggestellt“ aktiviert ist. Wenn Sie mit dem JTL-Warenwirtschaftssystem arbeiten, sollten Sie diese Einstellung deaktivieren, da JTL den Bestellstatus erkennt und fälschlicherweise als „bezahlt“ markiert – auch wenn die Zahlung noch aussteht.
  
  Bitte deaktivieren Sie diese Option.
  

4.5 Plugin-Einstellungen / Sonstiges

• Checkout-Formularfeld (Anrede)
  Wählen Sie im Bereich Checkout-Formularfeld (Anrede) aus, ob Sie das Anrede-Feld von abilita PAY nutzen möchten.
  
  Falls Sie bereits ein Anrede-Feld durch andere Plugins in Ihrem Bestellprozess verwenden, geben Sie im Feld Eigenes Feld (Mapping) den technischen Namen des Feldes an, wie es bei Ihnen konfiguriert wurde.
• Checkout-Formularfeld (Firma)
  Mit dieser Einstellung können Sie den Place-Holder-Text des Firmen-Eingabefelds im Bestellprozess von abilita PAY überschreiben und durch den gewünschten Text ersetzen. Geben Sie dazu den entsprechenden Place-Holder-Text ein.
  
  Beispiel: Sie könnten den Text Für Bestellungen auf Firmenrechnung (B2B) bitte die Firmendaten angeben. verwenden.
• Bestellnummer/Auftragsnummer-Präfix
  Wenn Sie in Ihrem WooCommerce-Shop ein Bestellnummern-Präfix verwenden, tragen Sie dieses unter Bestellnummer/Auftragsnummer-Präfix ein.
  
  Beispiel: Verwenden Sie das Präfix BN-, dann geben Sie BN- in dieses Feld ein.
  
  Beachten Sie bitte, dass eine korrekte Zuweisung des Zahlungsstatus nur mit einer korrekten Bestellnummer erfolgen kann.
• Logger und PHP-Fehlermeldungen
  Aktivieren Sie diese Optionen nur zur Fehlersuche. In der Regel werden die beiden Optionen vom technischen Support bei Bedarf aktiviert:
  • Logger
  • PHP-Fehlermeldungen
• CSS für HTML-SELECT-Felder….
  • In diesem Bereich können Sie das Aussehen der Eingabefelder für das Geburtsdatum anpassen, um sie an Ihr Layout anzupassen.
  • Falls Sie einen Webdesigner mit dem Layout Ihres Shops beauftragt haben, kann dieser die CSS-Angaben direkt im Layout-CSS Ihres Shops überschreiben.
  • Alle Eingabefelder für das Geburtsdatum verfügen über eigene CSS-Klassen.

Um Ihre Einstellungen in den Plugin-Einstellungen / Sonstiges zu übernehmen, klicken Sie bitte auf Änderung speichern.

5 Zahlungsarten aktivieren und konfigurieren

• Um die von Ihnen über den abilita PAY Vertrag gebuchten Zahlungsarten zu aktivieren und zu konfigurieren, navigieren Sie zu WooCommerce > Einstellungen.
• Wählen Sie hier den Reiter Zahlungen aus.
• Sie können nun über den Regler in der Spalte Aktiviert die gebuchten Zahlungsarten aktivieren.
• Die meisten abilita PAY Zahlungsarten bedürfen keiner weiteren Konfiguration über die Button Einrichtung abschließen bzw. Verwalten, da diese mit Installation bereits Standardwerte gesetzt bekommen haben, welche einen reibungslosen Ablauf gewährleisten.
• Wichtig:
  
  Für die Zahlungsarten coin4Lastschrift & coin4Vorkasse müssen allerdings noch weitere Angaben gemacht werden, um die Funktionalität zu gewährleisten.
  
  Klicken Sie hierzu den Button Einrichtung abschließen bzw. Verwalten neben der Zahlungsart und scrollen Sie dort an das Ende der Seite, füllen Sie diese Felder aus mit den Daten Ihres von abilita überwachten EBICS-Kontos:
  
  
  
  
• Um Ihre Einstellungen in den Plugin-Einstellungen / Sonstiges zu übernehmen, klicken Sie bitte auf Änderung speichern.

Changelog

• 1.0.0 (10.02.2025)
  • Initial version
• 1.0.1 (24.02.2025)
  • Fix preferences-link in plugin overview. If user click the link, an alert show, that the user has no permission to do that
• 1.0.2 (27.02.2025)
  • If customer set no vat-id in the plugin-preferences and the customer is no b2b-customer the birthday-fields will not show.
  • Abilita-Metabox in the order-detail-view will occured an error (With WooCommerce: Version 8.1.1|9.3.3)