Albis Leasing.

Leasing-Verträge direkt im Shopware-Checkout — mit Live-API, Flow-Builder-Integration und Mail-Templates pro Sales-Channel.

Was leistet das Plugin?

Albis-Leasing als vollwertige Zahlart.

Eine komplette Leasing-Strecke direkt in Shopware: API-Anbindung, Antragsstrecke im Checkout, Mail-Anbindung, optionale Detailseiten-Anzeige — aus einer Hand und ohne externe Tools.

Was bekommt Ihr Shop?

Eine vollständige Anbindung an die Albis-Leasing-Plattform — direkt im Shopware-Checkout.

Das Plugin erweitert Shopware 6 um eine eigene Zahlart „Albis Leasing". Im Checkout füllt der Geschäftskunde alle Leasingdaten selbst aus, das Plugin schickt diese an die Albis-API, die Bonitätsprüfung läuft in Echtzeit, und der Kunde bekommt sofort Antwort. Sie als Händler erhalten parallel alle Daten und können den Vertrag normal abwickeln.

Live-API

Direkter Draht zu Albis

JSON-RPC-Anbindung an die Albis-Plattform — Bonitätsprüfung und Antrag in Echtzeit, ohne Mail-Hin-und-Her.

B2B-Leasing

Für gewerbliche Kunden

Speziell für B2B-Leasing — Firmendaten, Bankverbindung, ggf. Geschäftsführer-Daten ab definiertem Auftragswert.

Pro Sales-Channel

Multi-Shop-tauglich

Aktivierung und Konfiguration pro Verkaufskanal — verschiedene Sales-Channels können verschiedene Albis-Accounts nutzen.

Zweiter Vertrag

In v2.5 · zusätzliche Credentials

Ab v2.5 (SW 6.7) lassen sich zusätzliche Albis-Credentials und eine zweite Produktgruppe konfigurieren — für Setups, in denen Albis intern zwei verschiedene Händlerverträge führt.

Mail-Templates

Pro Sales-Channel

Antragsbestätigung an Kunde, Antragsdaten an Händler, Status-Updates — per Sales-Channel überschreibbar. Details →

Detailseiten

Leasing-Rate inline

Optional: Albis-Zahlart auf der Produktdetailseite vorschlagen, sofern die Mindestanforderungen erfüllt sind. Details →

Installation

Sechs Schritte — etwa 20 Minuten.

Standard-Shopware-Plugin-Installation, mit zwei Migrations für die Albis-Produktgruppen und Konfigurations-Defaults.

Schritt 1

ZIP herunterladen

Wählen Sie die ZIP-Variante für Ihre Shopware-Version aus dem Download-Bereich weiter unten. Drei Versionen verfügbar:

  • v2.5.39 für SW 6.7 (aktuell)
  • v2.2.46 für SW 6.6
  • v2.1.42 für SW 6.5

Zu den Downloads ↓

Schritt 2

Plugin-Manager → Hochladen

Im Shopware-Admin: Einstellungen → System → Plugins → „Plugin hochladen". ZIP auswählen, hochladen, danach „Installieren" klicken.

Schritt 3

Aktivieren

Plugin in der Plugin-Übersicht aktivieren. Die nötigen Migrations (zwei Stück) laufen dabei automatisch — sie legen die albis_product_group-Tabelle und Konfigurations-Defaults an.

Schritt 4

Sales-Channel zuweisen

In der Plugin-Konfiguration: Aktivierung pro Sales-Channel auswählen oder global. Ohne diese Zuweisung erscheint die Zahlart nicht.

Schritt 5

Albis-Credentials eintragen

API-Endpoint, Username und Passwort eintragen — alle diese Daten erhalten Sie vom Albis-Ansprechpartner. SSL ist Pflicht.

Schritt 6

Test & los

Im Plugin-Backend gibt es einen „API-Verbindung testen"-Button. Klick — wenn die Verbindung steht, ist alles bereit für die erste Test-Bestellung.

Konfiguration

Alle Backend-Felder — dokumentiert.

Die Plugin-Konfiguration in der Shopware-Admin pro Sales-Channel oder global — hier ist jedes Feld erklärt.

API-Endpoint

URL aus Ihrem Albis-Konto

Vollständige URL Ihres Albis-API-Endpoints — Live oder Test, je nach Bereitstellung durch Albis. Pflichtfeld.

Username · Passwort

API-Credentials von Albis

Werden im Plugin-Backend eingegeben. Passwort als type=password-Feld geschützt. Nur Albis kann diese Credentials ausstellen.

Username 2 · Passwort 2

Für zweiten Vertrag (v2.5)

Optional — nur ab v2.5.39 (SW 6.7). Zusätzliche Credentials für einen zweiten Albis-Händlervertrag, wenn Albis intern zwei verschiedene Verträge führt.

Produktgruppe

sw-entity-single-select

Über das Dropdown wählen Sie eine Albis-Produktgruppe, die dem Produktgruppen-Eintrag in Ihrem Albis-Konto entspricht. Wird im Antrag übermittelt, ist für Kunden nicht sichtbar.

Produktgruppe 2

Für zweiten Vertrag

Ab v2.5: zusätzliche Produktgruppe — relevant, wenn Albis pro Vertrag eine andere Produktgruppe vorgibt.

Provision

Wert zwischen 0 und 5 %

Optional — wird in die Leasing-Rate eingerechnet und an Albis übermittelt. Standardwert: 0.

Geschäftsführer-Schwelle

Auftragswert-Limit

Ab welchem Auftragswert (netto) zusätzliche Geschäftsführer-Daten (Geburtsdatum, Wohnadresse) abgefragt werden. Frei einstellbar.

Offcanvas-Anzeige

Toggle

Soll die Albis-Zahlart im Offcanvas-Warenkorb angezeigt werden? Standard: aus.

BCC-E-Mail

Doppelt absichern

Optional eine BCC-Adresse für alle Albis-Bestellbestätigungen — für lückenlose interne Übersicht.

Hauptfunktionen

Was das Plugin tatsächlich kann.

API-Anbindung, Flow-Builder-Integration, API-Test im Backend, Mail-Templates und optionale Detailseiten-Anzeige — die Features im aktuellen Stand der drei Plugin-Versionen.

Zweiter Vertrag · v2.5

Zusätzliche Credentials

Ab v2.5.39 (SW 6.7): ein zweites Set Albis-Credentials (Username 2 / Passwort 2) und eine zweite Produktgruppe in der Plugin-Config. Sinnvoll, wenn Albis intern zwei verschiedene Händlerverträge für Ihren Shop führt.

Flow-Builder · v2.5

Business-Event nach Antrag

Neues Shopware-Business-Event albis.leasing.application.placed — nach jedem eingereichten Leasing-Antrag im Flow-Builder verfügbar. Mitgelieferte CreateTagAction setzt automatisch ein Tag auf die Bestellung (z. B. albis-pending).

Bonitätsprüfung

Echtzeit-Antwort

Nach Antrag-Abschluss im Checkout läuft die Albis-Bonitätsprüfung in Sekunden — Antwort kommt zurück, bevor der Kunde die Page verlässt.

API-Test-Komponente

Direkt im Backend

Eigener „API-Verbindung testen"-Button (Endpoint /api/_action/albis-api/verify) — prüft die eingetragenen Credentials direkt gegen den Albis-Endpoint, mit Fehler-Anzeige bei falschen Daten.

Mail-Templates

Antrag & Status

Mail-Templates für Antragsbestätigung und Status-Updates an Kunde und Händler — registriert in der Shopware-Mail-Verwaltung, pro Sales-Channel anpassbar. Optional BCC-Adresse für interne Übersicht. Details →

Detailseiten-Anzeige

Pro Sales-Channel

Optional über die Plugin-Config aktivierbar (detailPageDisplay): Albis-Zahlart auf der Produktdetailseite vorschlagen, sofern alle Mindestanforderungen erfüllt sind. Details →

Produktgruppen-Entity

Eigene DAL-Entity

AlbisProductGroup als eigenständige Shopware-Entity mit EntityCollection und EntityDefinition — auswählbar im Backend per sw-entity-single-select.

SSL · TLS 1.2+

Verschlüsselter Transport

Die Albis-API akzeptiert ausschließlich HTTPS-Verbindungen mit TLS 1.2 oder neuer. Pflicht-Voraussetzung vor Aktivierung.

Mehrsprachig

DE + EN out-of-the-box

Alle Storefront- und Admin-Strings in DE und EN per Shopware-Snippets übersetzt — weitere Sprachen über die Standard-Snippet-Mechanik erweiterbar.

Downloads

Drei Plugin-ZIPs.

Pro Shopware-Major-Version ein eigenes ZIP. Klicken Sie auf den Download-Button der passenden Version.

SW 6.7 · aktuell

AlbisLease v2.5.39

Für die aktuelle Shopware-6.7-Linie. Volles Feature-Set inklusive Vertrag 2 und Shopware-Flow-Builder-Anbindung.

Größe: 118 KB

MD5: a168fd0849920bd2b547dd31d627301e

ZIP herunterladen ↓

SW 6.6 · stable

AlbisLease v2.2.46

Stabile Version für Shopware 6.6 — identischer Funktionsumfang wie v2.1.42, kompatibel mit SW 6.6.

Größe: 112 KB

MD5: 751db9ef86f6dabdf97f04b0be97ce44

ZIP herunterladen ↓

SW 6.5 · LTS

AlbisLease v2.1.42

Stabile Hauptversion für Shopware 6.5 — weiterhin gepflegt. Mit API-Test-Komponente und AlbisProductGroup-Entity.

Größe: 111 KB

MD5: 5661edcceecbd6d184e393926936070b

ZIP herunterladen ↓

MD5-Verifikation

Jeder Download mit MD5-Prüfsumme — vor der Installation verifizieren.

Auf Ihrem System: md5sum AlbisLease-v2.5.39-SW6.7.zip — das Ergebnis muss mit dem hier angezeigten Wert übereinstimmen. Wenn nicht, ist die Datei beschädigt oder manipuliert — nicht installieren.

Changelog

Was in den drei Versionen steckt.

Stand der Plugin-Quellen aus den hier angebotenen ZIP-Paketen.

v2.5.39
für Shopware 6.7
  • Config-Felder „Vertrag 2" — zusätzliches Set Albis-Credentials (Username 2 / Passwort 2) und zweite Produktgruppe für Shops mit zwei parallel laufenden Albis-Händlerverträgen
  • Shopware-Flow-Builder-Integration: neues Business-Event albis.leasing.application.placed — nach jedem eingereichten Leasing-Antrag im Flow-Builder verfügbar
  • AlbisLeasingApplicationPlacedEvent und AlbisLeasingApplicationPlacedAction registriert
  • BusinessEventCollectorSubscriber integriert das Event in die Shopware-Event-Liste
  • CreateTagAction: nach Antrag automatisch Tag auf der Bestellung setzen (z. B. albis-pending)
  • TagAware-Framework-Event für saubere Tag-Zuordnung
  • Routes auf PHP umgestellt (routes.php statt routes.xml) — SW-6.7-konform
  • Kompatibilität mit Shopware 6.7
v2.2.46
für Shopware 6.6
  • Vollständige Shopware-6.6-Kompatibilität
  • Identischer Feature-Stand wie v2.1.42 — nur auf SW 6.6 portiert
  • Composer-Constraints auf shopware/core: ~6.6 angepasst
v2.1.42
für Shopware 6.5
  • Stabile Hauptversion für Shopware 6.5
  • API-Test-Komponente im Backend — Button „API-Verbindung testen" prüft die Albis-Credentials direkt aus der Plugin-Konfiguration
  • AlbisProductGroup-Entity inkl. EntityCollection und EntityDefinition — auswählbar per sw-entity-single-select
  • Drei Subscriber: ProductPageSubscriber, OrderPlacedSubscriber, CheckoutConfirmSubscriber
  • Zwei Migrations für DB-Setup
  • AlbisApiService für API-Kommunikation, AlbisPayment als Payment-Handler
  • Mail-Templates für Antragsbestätigung und Status-Updates — vollständig in DE und EN per Snippets übersetzt
Häufige Fragen · FAQ

FAQ zum Albis-Plugin.

Die häufigsten Fragen, die uns zu Albis-Leasing in Shopware gestellt werden — aus echten Kundenanfragen.

Brauche ich einen eigenen Vertrag mit Albis?

Ja. Das Plugin ist eine Schnittstelle zur Albis-Leasing-Plattform — den eigentlichen Händlervertrag müssen Sie direkt mit der Albis Leasing AG abschließen. Ihr Albis-Ansprechpartner stellt danach die API-Credentials zur Verfügung, die Sie im Plugin eintragen.

Welche Shopware-Version brauche ich?

Es gibt drei Plugin-Versionen, eine pro aktiver Shopware-Major-Linie:

  • v2.5.39 für Shopware 6.7
  • v2.2.46 für Shopware 6.6
  • v2.1.42 für Shopware 6.5

Eine Cross-Installation (z. B. die SW-6.7-Version auf einem SW-6.6-Shop) funktioniert nicht — die Composer-Constraints verhindern das.

Was kostet die Nutzung des Plugins?

Das Plugin selbst ist Teil eines Albis-Händlervertrages und ist im Rahmen dieser Geschäftsbeziehung kostenfrei. Sie zahlen also keine Plugin-Lizenz an Stone & Water — die Konditionen ergeben sich aus Ihrem Vertrag mit Albis. Wenn Sie ein individuelles Setup oder Anpassungen brauchen, sprechen Sie uns an.

Wie funktioniert die Bonitätsprüfung?

Der Kunde gibt im Checkout seine Firmen- und ggf. Geschäftsführer-Daten ein. Das Plugin sendet diese per JSON-RPC an die Albis-API. Albis macht die Bonitätsprüfung in Echtzeit und antwortet binnen Sekunden — mit Annahme, Ablehnung oder „in Prüfung". Der Status landet automatisch auf der Bestellung und in der Status-Mail an Kunde und Händler.

Was bedeutet „Vertrag 2" in v2.5?

Ab Version 2.5.39 (SW 6.7) gibt es in der Plugin-Config zusätzliche Felder für ein zweites Set Albis-Credentials (Username 2 / Passwort 2) und eine zweite Produktgruppe. Das ist relevant, wenn Albis intern zwei verschiedene Händlerverträge für Sie führt — das Plugin sendet dann jeweils die passenden Credentials an die Albis-API. Die UI-Auswahl, welcher Vertrag pro Antrag genutzt wird, ist in v2.5.39 noch nicht im Plugin enthalten und derzeit über Custom-Code regelbar.

Kann ich das Plugin im Flow-Builder verwenden?

Ja, ab v2.5.39 (SW 6.7). Das Plugin registriert das Business-Event albis.leasing.application.placed, das nach jedem eingereichten Antrag im Flow-Builder verfügbar ist. Damit lässt sich z. B. automatisch ein Tag albis-pending auf die Bestellung setzen oder eine zusätzliche Mail auslösen.

Können auch B2C-Kunden Leasing nutzen?

Nein. Albis-Leasing richtet sich an gewerbliche Kunden (B2B). Privatpersonen sind ausdrücklich ausgeschlossen — das ergibt sich aus dem Albis-Vertragsmodell, nicht aus dem Plugin. Wenn Sie B2C-Finanzierung anbieten wollen, brauchen Sie einen anderen Anbieter.

Was passiert bei einer Ablehnung?

Albis schickt die Ablehnung an das Plugin zurück, der Status auf der Bestellung wird auf „rejected" gesetzt, und sowohl Kunde als auch Händler erhalten eine Status-Mail. Die Bestellung selbst bleibt erhalten — Sie können entscheiden, ob Sie dem Kunden eine alternative Zahlart anbieten oder die Bestellung stornieren.

Kann ich die Mail-Templates anpassen?

Ja, vollständig. Alle vier Mail-Templates sind in der Shopware-Mail-Verwaltung registriert und können wie jede andere Shopware-Mail editiert werden — mit Twig, Sales-Channel-Override und allen Standard-Variablen plus den Albis-spezifischen wie {{ albis.application.contract }}. Mehr Details →

Wie verifiziere ich den Download?

Jeder Download oben hat eine MD5-Prüfsumme. Auf Ihrem System nach dem Download: md5sum AlbisLease-v2.5.39-SW6.7.zip. Das Ergebnis muss mit dem angezeigten MD5-Wert übereinstimmen — sonst ist die Datei beschädigt oder manipuliert.

Wer richtet das Plugin ein?

Sie selbst oder wir. Die Installation ist Standard-Shopware-Plugin-Verfahren und dauert für jemanden, der mit Shopware vertraut ist, 20-30 Minuten. Wenn Sie das lieber an uns auslagern wollen: albis@stoneandwater.online — wir richten das komplette Setup ein, inklusive Test-Bestellung mit Echt-Albis-Antwort.

Was ist mit Shopware 5?

Eine ältere Shopware-5-Version (AlbisPayment 5) existiert noch, ist aber nicht mehr aktiv weiterentwickelt — Shopware selbst hat den offiziellen Support für SW 5 eingestellt. Wenn Sie auf SW 5 sind, empfehlen wir Migration auf SW 6.7 und die aktuelle Plugin-Version v2.5.39.

Technische Details

Auf Shopware-Standard.

Symfony-Services, DAL-konformer Datenzugriff, Vue 3 im Admin. Keine Core-Patches, keine Hacks.

Kompatibilität

Shopware 6.5Shopware 6.6Shopware 6.7PHP 8.2+

Albis-Anbindung

JSON-RPC APILive + TestMulti-ChannelBonität in Echtzeit

Voraussetzung: Albis-Händlervertrag. API-Credentials werden vom Albis-Ansprechpartner bereitgestellt.

DSGVO

Alle Vertrags- und Kundendaten werden in der Shopware-Datenbank gespeichert. Bonitätsprüfungen erfolgen bei Albis — Albis ist eigener Verantwortlicher gemäß DSGVO. Auftragsverarbeitungsvertrag mit Albis erforderlich.

Support

Bei Fragen zur Installation, Konfiguration oder bei Bugs: albis@stoneandwater.online

Bereit für die Einrichtung?

Wir richten das ein.

Vom Plugin-Upload über Albis-API-Konfiguration bis Test-Bestellung — wir übernehmen das gesamte Setup, wenn Sie wollen.