Modul GiroCheckout¶
Mit dem Modul GiroCheckout bezahlen Ihre Kunden über GiroCheckout (S-Public Services / GiroSolution) mit Wero, Kreditkarte oder SEPA-Lastschrift. Das Modul gibt es seit Version 4.6.1. Es ist ein Kaufmodul und nur in Pro und Enterprise erhältlich, siehe Kaufmodule aktivieren.
Jede Zahlart ist im GiroCockpit ein eigenes Projekt und im Shop eine eigene Zahlungsart, die Sie einzeln einschalten. Das Modul arbeitet im klassischen Checkout und im SmartCheckout.
Das frühere Modul Giropay wird nicht mehr ausgeliefert.
Voraussetzungen¶
- Ein Händlerkonto bei GiroCheckout mit einem Projekt je Zahlart, die Sie anbieten möchten.
- Der Shop rechnet in Euro. Ist unter wpShopGermany → Konfiguration → Einstellungen → Allgemein ein anderer Währungscode eingestellt, meldet der Systemcheck „GiroCheckout rechnet in Euro. Bitte den Währungscode in den Einstellungen auf "EUR" stellen.“
Einrichten im GiroCockpit¶
- Legen Sie im GiroCockpit für jede Zahlart ein Projekt an (Wero, Kreditkarte, SEPA-Lastschrift).
- Notieren Sie die Händler-ID sowie je Projekt die Projekt-ID und das Projektkennwort.
Eine Benachrichtigungsadresse müssen Sie dort nicht hinterlegen; das Modul übergibt sie bei jeder Zahlung selbst.
Einstellungen¶
Öffnen Sie wpShopGermany → Konfiguration → Module und aktivieren Sie in der Gruppe „Zahlungsarten“ das Modul GiroCheckout.
Zugang zu GiroCheckout¶
| Einstellung | Beschreibung |
|---|---|
| Händler-ID | Ihre Händler-ID aus dem GiroCockpit. Sie gilt für alle Zahlarten. |
Wero, Kreditkarte, SEPA-Lastschrift¶
Für jede Zahlart gibt es einen eigenen Kasten:
| Einstellung | Beschreibung |
|---|---|
| Aktiv | Nur wenn aktiv, steht die Zahlart im Checkout zur Auswahl. |
| Verbindung | Beim Speichern prüft das Modul Händler-ID, Projekt-ID und Projektkennwort. Hier steht dann „Verbindung erfolgreich“ oder „Anmeldung fehlgeschlagen“ mit dem Grund, z. B. „Händler-ID, Projekt-ID oder Projektkennwort stimmen nicht.“ Ohne Zugangsdaten steht „Keine Zugangsdaten hinterlegt“, vor dem ersten Speichern „Noch nicht geprüft, bitte speichern“. |
| Projekt-ID | Die ID des Projekts im GiroCockpit. |
| Projektkennwort | Das Kennwort des Projekts. Es wird nicht angezeigt. Ist eines gespeichert, steht darunter „Gespeichert. Zum Ändern neu eingeben, sonst leer lassen.“ |
| Bezeichnung | Name der Zahlungsart im Checkout und in den Mails. Vorgabe: „Wero“, „Kreditkarte“ bzw. „SEPA-Lastschrift“. |
| Hinweistext | Erklärung bei der Auswahl der Zahlungsart. |
| Gebühr/Rabatt | Gebühr oder Rabatt für diese Zahlart, als Betrag oder in Prozent. |
| Mehrwertsteuersatz | Steuersatz für eine Gebühr. |
Fehlen für eine aktive Zahlart Händler-ID, Projekt-ID oder Projektkennwort, weist der Systemcheck darauf hin.
Zahlungsablauf¶
| Einstellung | Beschreibung |
|---|---|
| Verwendungszweck | Erscheint in der Zahlung bei GiroCheckout. Platzhalter der Bestellung und des Kunden sind möglich (siehe Platzhalter), Vorgabe: O%order_id% - K%kunde_id%. Höchstens 27 Zeichen, längere werden gekürzt. |
| Zahlung sofort starten | Vorgabe: an. Der Kunde wird direkt nach dem Bestellabschluss zur Zahlung weitergeleitet. Ist die Option aus, bezahlt er über den Knopf „Jetzt mit … bezahlen“ auf der Abschlussseite oder über den Zahlungslink in der Bestellmail. |
Erstattung bei Statuswechsel¶
Wechselt eine über GiroCheckout bezahlte Bestellung in einen der markierten Status, wird der noch nicht erstattete Betrag automatisch erstattet. Vorgabe: zurückgezahlt und storniert.
Ablauf im Shop¶
- Der Kunde wählt im Checkout eine der Zahlarten und schließt die Bestellung ab.
- Er wird zu GiroCheckout weitergeleitet und bezahlt dort. Ist Zahlung sofort starten aus, steht auf der Abschlussseite „Bitte bezahlen Sie den Betrag jetzt mit …“ und der Knopf Jetzt mit … bezahlen.
- Nach der Zahlung kehrt der Kunde auf die Abschlussseite seiner Bestellung zurück. Verbucht wird die Zahlung, sobald GiroCheckout sie bestätigt; die Bestellung erhält dann den Status „Zahlung akzeptiert“, bis dahin bleibt sie offen.
- Die Abschlussseite zeigt den Stand der Zahlung:
- bezahlt: „Die Zahlung mit … ist eingegangen.“
- nicht abgeschlossen oder abgebrochen: „Die Zahlung wurde nicht abgeschlossen. Sie können es erneut versuchen.“ und darunter wieder der Knopf Jetzt mit … bezahlen
- noch offen: „Das Ergebnis der Zahlung steht noch nicht fest. Sobald es vorliegt, wird die Bestellung aktualisiert.“
Bei der Kreditkarte übergibt das Modul für 3-D Secure die Rechnungsadresse und die E-Mail-Adresse des Kunden.
Bestellverwaltung¶
In der Bestellansicht stehen bei der Zahlungsart:
- GiroCheckout Status, z. B. „bezahlt“, „offen“, „unbekannt“, „vom Kunden abgebrochen“ oder „abgelaufen“, mit dem Knopf Status aktualisieren. Er fragt den Stand bei GiroCheckout ab und meldet „GiroCheckout: Status der Zahlung ist "…".“
- GiroCheckout Referenz und Transaktions-ID
- Bezahlt und, nach einer Erstattung, Erstattet
- Erstattungsbetrag mit dem Knopf Betrag erstatten: Das Feld ist mit dem noch nicht erstatteten Betrag vorbelegt (Hinweis „Höchstens …“); ein kleinerer Betrag erstattet einen Teil. Nach der Rückfrage „Den Betrag über GiroCheckout erstatten?“ meldet der Shop „GiroCheckout: … erstattet.“ oder „GiroCheckout: Die Erstattung ist fehlgeschlagen. Bitte das Bestellprotokoll beachten.“
Alle Schritte der Zahlung stehen im Bestellprotokoll.