Gutschein per URL einlösen

Das Herzstück des Plugins ist der voucher-Parameter. Du hängst ihn an eine beliebige Storefront-URL an — beim Aufruf des Links wird der angegebene Code automatisch in den Warenkorb gelegt.

Den Link aufbauen

Ergänze deine URL um ?voucher=DEINCODE (oder &voucher=DEINCODE, falls die Adresse bereits Parameter enthält):

https://dein-shop.de/?voucher=SOMMER25
https://dein-shop.de/aktion/sommer?voucher=SOMMER25

Ersetze SOMMER25 durch den Code der Promotion, die du in Shopware angelegt hast. Der Parameter heißt immer voucher und ist fest vorgegeben.

Was beim Aufruf passiert

• Warenkorb enthält Produkte: Der Code wird sofort angewendet. Dein Kunde sieht die Erfolgsmeldung von Shopware und der Rabatt erscheint im Warenkorb.
• Warenkorb ist leer: Der Code wird gemerkt und automatisch eingelöst, sobald das erste Produkt hinzukommt. Optional zeigt dein Shop dazu einen Hinweis an (siehe Konfiguration):

> Promotion wird automatisch dem Warenkorb hinzugefügt, wenn mindestens ein Produkt im Warenkorb liegt.

• Code bereits im Warenkorb: Ein identischer Code wird nicht doppelt hinzugefügt.

Feste und individuelle Codes

Beide Gutschein-Arten von Shopware funktionieren:

• Feste Codes — ein Code für alle Kunden (z. B. SOMMER25).
• Individuelle Codes — pro Kunde generierte Einmal-Codes. Setze den jeweils erzeugten Code als voucher-Wert ein.

Entscheidend ist nur, dass die zugehörige Promotion in Shopware aktiv ist und ihre Bedingungen (etwa ein Mindestbestellwert) erfüllt sind.

Werden Bedingungen noch nicht erfüllt

Erreicht der Warenkorb zum Beispiel einen geforderten Mindestbestellwert noch nicht, kann der Code noch nicht greifen. Dein Kunde erhält beim Öffnen des Links einen entsprechenden Hinweis. Der Gutschein bleibt aber im Warenkorb hinterlegt und wird automatisch eingelöst, sobald die Bedingungen erfüllt sind — der Link muss nicht erneut aufgerufen werden.