Store Credit

Das Store Credit Plugin für Shopware 6 bietet eine flexible und bequeme Lösung für die Verwaltung von Rückgaben und Rückerstattungen von Kunden. Anstatt herkömmliche Rückerstattungen zu bearbeiten, können Shop-Administratoren Store Credit direkt auf das Kundenkonto gutschreiben. Dieses Guthaben kann anschließend für zukünftige Einkäufe verwendet werden, sodass Kunden weiterhin im Shop einkaufen können, während ihr Geld innerhalb des Stores bleibt.
Das Plugin stellt sicher, dass Store Credits über mehrere Bestellungen hinweg angewendet werden können, bis der zugewiesene Betrag vollständig genutzt ist, wodurch Kunden maximale Flexibilität bei der Einlösung ihrer Guthaben erhalten.

Administratoren haben volle Kontrolle über die Vergabe, Nachverfolgung und Verwaltung von Guthaben, was eine präzise Buchführung und ein nahtloses Kundenerlebnis ermöglicht. Durch die Bereitstellung von Store Credit anstelle von Rückerstattungen können Händler die Kundenbindung verbessern, Transaktionsgebühren reduzieren und wiederholte Einkäufe fördern, während der Rückgabeprozess effizienter gestaltet wird. Das Store Credit Plugin integriert sich nahtlos in die Shopware-Umgebung, sodass Guthaben einfach beim Checkout angewendet und im Admin-Panel vollständig überwacht werden können.

Hauptfunktionen

2. Plugin in Shopware 6 installieren

3.Activate the Plugin

4. Installation überprüfen

1. Auf die Plugin-Einstellungen zugreifen

2. Allgemeine Einstellungen
1.Minimale Konfiguration:Nach der Installation des Store-Credit-Plugins müssen Sie in der Konfiguration den Store-Credit-Rückerstattungstyp aktivieren.
Da dieses Plugin mit Swag Commercial verknüpft ist, muss der Schalter für die Option Store Credit Refund Type aktiviert werden, um Rückerstattungen per Store Credit zu ermöglichen.

2.Store Credit Add State: Aktivieren oder deaktivieren Sie diese Funktion über den Schalter.
3.Post-Purchase-Funktionen: Beschränken Sie die Nutzung des Store-Guthabens auf bestimmte Produkte.

Nach der Installation und Aktivierung des Plugins im Administrationsbereich können Kunden ihr verfügbares Guthaben sowie den Transaktionsverlauf in den Profileinstellungen ihres Kundenkontos im Storefront einsehen.

Administratoren können Store-Guthaben manuell zum Kundenkonto hinzufügen oder davon abziehen.

Teilweise & vollständige Rückerstattungen:

Storefront – Wichtige Dateien/Ordner

Core – Wichtige Dateien/Ordner

Resources – Wichtige Dateien/Ordner

Admin-Bereich – Zentrale Funktionen

Get Store Credit Balance
– Pfad: /store-api/store-credit/balance/{customer_id}
– Methode: GET
– Zweck: Ruft das aktuelle Store-Credit-Guthaben eines Kunden ab.
– Antwort: Gibt das verfügbare Guthaben zurück.

Add Store Credit
– Pfad: /store-api/store-credit/add
– Methode: POST
– Request Body:
– customer_id (string, erforderlich)
– amount (float, erforderlich)
– reason (string, optional)
– Antwort: Gibt die aktualisierten Store-Credit-Daten zurück.

Deduct Store Credit
– Pfad: /store-api/store-credit/deduct
– Methode: POST
– Request Body:
– customer_id (string, erforderlich)
– amount (decimal, erforderlich)
– order_id (string, optional)
– Antwort: Gibt die aktualisierten Store-Credit-Daten zurück.

– Refund to Store Credit
– Pfad: /store-api/store-credit/add
– Methode: POST
– Request Body:
– order_id (string, erforderlich)
– amount (decimal, erforderlich)
– Antwort: Rückerstattung wird verarbeitet und im Store-Credit-Verlauf protokolliert.
– reason (string, optional)

POST /api/store-credit/add

Adds a store credit amount to a specific customer’s balance. This can optionally be linked to an order and currency.

Authorization: Bearer
Content-Type: application/json

{
"customerId": "3c2a178f96b7345ad27051c34609e52",
"amount": 50.0,
"reason": "Manual admin adjustment"
}

{
"success": true,
"historyId": "f84b5a7a4fce4a1db9d693c8be304a1e"
}

{
"success": false,
"message": "Customer ID is missing."
}

POST /api/store-credit/deduct

"Zieht einen Store-Credit-Betrag vom Guthaben eines Kunden ab. Die Abziehung kann einen Grund zur Protokollierung enthalten."

Authorization: Bearer
Content-Type: application/json

{
"customerId": "3c2a178f96b7345ad27051c34609e52",
"amount": 20.0,
"reason": "Refund adjustment"
}

{
"success": true,
"historyId": "a9d2554b0ce847cd82f3ac9bd1c0aa2f"
}

{
"success": false,
"message": "Amount exceeds the maximum allowed credit for order."
}

{
"success": true,
"historyId": "a9d2554b0ce847cd82f3ac9bd1c0aa2f"
}

{
"success": true,
"historyId": "a9d2554b0ce847cd82f3ac9bd1c0aa2f"
}

Endpunkt

Ruft das aktuelle Store-Credit-Guthaben eines Kunden ab.

Authorization: Bearer<

GET /api/store-credit/balance?customerId=3c2a178f96b7345ad27051c309e52

{
"success": true,
"balance": 80.0,
"currencyId": "b7d2554b0ce847cd82f3ac9bd1c0dfca"
}

{
"success": false,
"message": "Customer not found."
}

Diese Endpunkte sind geschützt und erfordern ein Bearer-Token, das über die Shopware-Admin-API erhalten wird.

1.Store-Credit-Rückerstattungen aktivieren
Stellen Sie sicher, dass die Option Store Credit Refund Type unter Einstellungen > System > Plugins aktiviert ist.
Ermöglicht, Rückerstattungen als Store Credit statt als Bargeld auszustellen.

2.Pro-Bestellung-Guthabengrenzen festlegen
Definieren Sie ein maximales Limit für die Nutzung von Store Credit pro Bestellung (z. B. 50 Euro).
Hilft, zu kontrollieren, wie viel Guthaben beim Checkout verwendet werden kann.
3.Store-Credit-Transaktionen überwachen
Überprüfen Sie regelmäßig die Store-Credit-Transaktionsprotokolle, um die Nutzung durch Kunden nachzuverfolgen.
Dies hilft, Fehler und Unstimmigkeiten zu vermeiden.
4.Kunden über ihr Guthaben informieren
Stellen Sie sicher, dass Kunden ihr verfügbares Store-Credit-Guthaben in ihrem Konto einsehen können.
Senden Sie Benachrichtigungen, wenn Store Credit hinzugefügt oder verwendet wird.

5.Vor dem Livegang testen
Testen Sie verschiedene Szenarien, wie Rückerstattungen, Teilzahlungen und Store-Credit-Anwendungen während des Checkouts.
Stellen Sie sicher, dass alles korrekt funktioniert, bevor Sie live gehen.
6.API nutzen, um individuelle Anpassungen vorzunehmen
Verwenden Sie API-Endpunkte, um Store-Credit-Regeln anzupassen und mit anderen Shop-Funktionen zu integrieren.
Dies ermöglicht Flexibilität bei der Anwendung von Store Credit.
7.Store Credit für bestimmte Produkte einschränken
Falls erforderlich, beschränken Sie die Nutzung von Store Credit auf bestimmte Produkte oder Verkaufskanäle.
Dies stellt sicher, dass Store Credit nur dort verwendet wird, wo es sinnvoll ist.

1.Store Credit wird beim Checkout nicht angezeigt

Stellen Sie sicher, dass der Store Credit Refund Type in den Plugin-Einstellungen aktiviert ist.

Überprüfen Sie, ob der Kunde genügend Store Credit in seinem Konto hat.

2.Rückerstattungen werden nicht als Store Credit ausgegeben

Vergewissern Sie sich, dass die Rückerstattungsmethode beim Bearbeiten von Rücksendungen auf Store Credit eingestellt ist.

Prüfen Sie auf Konflikte mit anderen rückerstattungsbezogenen Plugins.
3.Guthaben des Kunden wird nicht aktualisiert

Stellen Sie sicher, dass die geplanten Aufgaben mit den folgenden Befehlen ausgeführt werden:

bin/console scheduled-task:register
bin/console scheduled-task:run
bin/console messenger:consume

Überprüfen Sie, ob der Store-Credit-Verlauf in der Datenbank protokolliert wird.

Administratoren können Store Credit nicht ändern
4.Stellen Sie sicher, dass der Administrator die erforderlichen Berechtigungen zum Bearbeiten des Store-Credit-Guthabens der Kunden hat.

Überprüfen Sie, dass API-Aufrufe für Store-Credit-Anpassungen korrekt funktionieren.
5.Bestellungen nutzen Store Credit beim Checkout nicht

Stellen Sie sicher, dass keine Einschränkung für Store Credit bei den ausgewählten Produkten besteht.

Überprüfen Sie, dass der Guthabenbetrag innerhalb des erlaubten Limits pro Bestellung liegt.

1.Kann ich die Nutzung von Store Credit auf bestimmte Produkte beschränken?

Ja, Sie können die Nutzung von Store Credit für bestimmte Produkte oder Kategorien über die Post-Purchase-Funktionen einschränken.
2.Wie füge ich einem Kundenkonto Store Credit hinzu?

Administratoren können Store Credit manuell über den Bereich Kundendetails im Admin-Panel hinzufügen.

3.Kann Store Credit ablaufen?

Derzeit unterstützt das Plugin keine automatische Ablauf-Funktion für Store Credit, aber diese Funktion kann angepasst werden.

4.Können Kunden ihr Store-Credit-Guthaben einsehen?

Ja, Kunden können ihr verfügbares Guthaben sowie den Transaktionsverlauf in ihren Kontoeinstellungen einsehen.

Lesen Sie mehr über die Plugin-Konfiguration in unserem WIKI.