> ## Documentation Index
> Fetch the complete documentation index at: https://dokumentation.websale.de/llms.txt
> Use this file to discover all available pages before exploring further.

# Sicherheitshinweis bei Online-Zahlungsarten

> Warum WEBSALE V8s die Sitzung während eines externen Bezahlvorgangs sperrt, wie Sie die Hinweisseite gestalten und wie der Käufer eine neue Sitzung starten kann.

Bei allen Zahlungsarten, bei denen der Käufer den Shop verlässt und seine Angaben beim Zahlungsdienstleister macht, sperrt WEBSALE V8s die Sitzung für die Dauer des Bezahlvorgangs. Betroffen sind unter anderem PayPal, die Kreditkarte mit 3D-Secure-Abfrage und alle Verfahren, die zur Bank des Käufers weiterleiten.

Der Grund ist die Unveränderbarkeit des Warenkorbs. Der Betrag, den der Käufer beim Dienstleister freigibt, muss derselbe sein, der im Shop zur Bestellung wird. Hätte der Käufer den Shop parallel in einem zweiten Tab offen und legte dort weitere Produkte in den [Warenkorb](https://dokumentation.websale.de/v8s/marketing-produkte/geschenkprodukte.md#warenkorb), gäbe es zwei verschiedene Summen für dieselbe Bestellung. Der Shop merkt sich beim Sperren die Gesamtsumme und prüft sie bei der Rückkehr.

Während der Sperre kann der Käufer im Shop nichts tun. Sie wird aufgehoben, sobald er den Bezahlvorgang abschließt oder abbricht.

## Wenn der Käufer nicht zurückkommt

Der Regelfall löst sich von selbst. Es gibt aber Fälle, in denen der Käufer weder abschließt noch abbricht: Er schließt das Bezahlfenster, er benutzt die Zurück-Schaltfläche seines Browsers, oder das System des Dienstleisters antwortet nicht mehr.

Dann bleibt die Sitzung gesperrt, und der Käufer sieht bei jedem weiteren Aufruf des Shops nur noch die Hinweisseite. Damit er aus dieser Lage herauskommt, braucht die Hinweisseite einen Ausweg.

> [!WARNING]
>
> Setzen Sie auf der Hinweisseite immer einen Link mit dem Ziel `~WS-UnlockSessionOnlineClearingLink~`. Ohne ihn sitzt der Käufer fest, bis seine Sitzung von selbst abläuft. Das ist der einzige wirklich kritische Punkt dieser Seite.

Über diesen Link startet der Käufer eine neue Sitzung. Dabei werden übernommen:

* der Warenkorb
* alle bisherigen Eingaben
* die Anmeldung, sofern er angemeldet war

Zurückgesetzt werden dagegen die Daten, die zu dem abgebrochenen Bezahlvorgang gehören, also die Bestellnummer und die Zwischenstände des jeweiligen Zahlungsdienstleisters. Bereits erzeugte Sofortgutscheine im Warenkorb werden ebenfalls zurückgesetzt, damit derselbe Gutschein nicht zweimal gekauft werden kann.

Die neue Sitzung bekommt eine neue Sitzungskennung. Der Käufer landet anschließend auf der Warenkorbseite und kann die Bestellung erneut aufgeben, auch mit einer anderen Zahlungsart.

Referenz: [WS-UnlockSessionOnlineClearingLink](https://dokumentation.websale.de/v8s/referenz/tags/ws/bestellprozess-adressen-und-pruefungen.md#die-tags-im-uberblick)

## Variante 1: Das allgemeine Hinweis-Template verwenden

Ohne weitere Einstellung zeigt der Shop bei gesperrter Sitzung das allgemeine Hinweis-Template an, also das, was im Abschnitt `<Templates>` beim Parameter `Notify` steht. Den Text dazu hinterlegen Sie als Hinweismeldung.

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<NotifyMessages-Txt>
   SessionLockedForOnlineclearing = Sie hatten einen Bezahlvorgang eingeleitet und wurden zum Zahlungsanbieter weitergeleitet. Im Shop liegen jedoch keine Informationen über eine Bezahlung vor.<br><br>Bitte schließen Sie den Bezahlvorgang ab, sofern das möglich ist.<br><br>Falls Sie mit der Zurück-Schaltfläche Ihres Browsers zurückgekehrt sind, das Bezahlfenster geschlossen haben oder nach längerer Wartezeit keine Bestellbestätigung erhalten haben, führen Sie die Bestellung bitte erneut durch. <a href="~WS-UnlockSessionOnlineClearingLink~">Hier gelangen Sie zurück zu Ihrem Warenkorb.</a> Sie können dabei auch eine andere Zahlungsart wählen.
</NotifyMessages-Txt>
```

> [!WARNING]
>
> Der Parametername endet auf `clearing` mit kleinem `c`, nicht auf `Clearing`. Schreiben Sie ihn genau so, wie er hier steht.

Nennen Sie in dem Text keine feste Wartezeit, wenn Sie sie nicht belegen können. Wie lange eine Bestätigung im Einzelfall braucht, hängt vom Zahlungsdienstleister ab. Eine zu knappe Angabe verleitet Käufer dazu, eine Bestellung ein zweites Mal aufzugeben, die beim Dienstleister längst durchgelaufen ist.

Referenz: [Abschnitt NotifyMessages-Txt](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/texte-und-meldungen.md#notifymessages-txt) · [Abschnitt Templates](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/grundlagen-und-technik.md#templates)

## Variante 2: Eine eigene Hinweisseite verwenden

Statt der allgemeinen Hinweisseite können Sie ein eigenes Template verwenden. Das lohnt sich, wenn der Text länger wird, wenn Sie ihn gestalten wollen oder wenn der Käufer an dieser Stelle mehr als einen Absatz Erklärung braucht.

### Schritt 1: Template zuweisen

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<Templates>
   SessionLockedForOnlineclearing = ws_session_locked_for_onlineclearing.htm
</Templates>
```

Ist hier ein Template angegeben und im Templateverzeichnis vorhanden, wird es anstelle der allgemeinen Hinweisseite angezeigt.

### Schritt 2: Template anlegen

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<h1>Ihr Bezahlvorgang ist noch offen</h1>

<p>
   Sie hatten einen Bezahlvorgang eingeleitet und wurden zum Zahlungsanbieter
   weitergeleitet. Im Shop liegen jedoch keine Informationen über eine Bezahlung vor.
   Bitte schließen Sie den Bezahlvorgang ab, sofern das möglich ist.
</p>

<p>Führen Sie die Bestellung bitte erneut durch, wenn Sie</p>

<ul>
   <li>mit der Zurück-Schaltfläche Ihres Browsers in den Shop zurückgekehrt sind,</li>
   <li>das Bezahlfenster geschlossen haben</li>
   <li>oder nach längerer Wartezeit keine Bestellbestätigung erhalten haben.</li>
</ul>

<p>
   <a href="~WS-UnlockSessionOnlineClearingLink~">Hier gelangen Sie zurück zu Ihrem Warenkorb.</a>
   Sie können dabei auch eine andere Zahlungsart wählen.
</p>
```

> [!WARNING]
>
> Auch hier gilt: ohne den Link mit `~WS-UnlockSessionOnlineClearingLink~` kommt der Käufer nicht weiter.

## Den Neustart im Warenkorb bestätigen

Nach dem Start der neuen Sitzung landet der Käufer auf der Warenkorbseite. Dort sollte er erfahren, was gerade passiert ist, sonst wundert er sich über den Sprung. Die Klammerung `{MSG-SessionUnlockedOnlineClearing}` greift genau einmal, unmittelbar nach dem Neustart.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{MSG-SessionUnlockedOnlineClearing}
   <p class="hinweis">
      Sie haben eine neue Sitzung gestartet.
      {ST-LoggedIn}
         Ihr Warenkorb und Ihre Anmeldung wurden übernommen.
      {/ST-LoggedIn}
      {!ST-LoggedIn}
         Ihr Warenkorb und alle Ihre Eingaben wurden übernommen.
      {/!ST-LoggedIn}
   </p>
{/MSG-SessionUnlockedOnlineClearing}
```

Der Block gehört auf die Warenkorbseite, also das Template aus dem Parameter `Basket` im Abschnitt `<Templates>`.

`{MSG-SessionUnlockedOnlineClearing}` ist ausschließlich als Klammerung verwendbar, einfach oder negiert. Als einzelnes Tag liefert es nichts.

Referenz: [MSG-SessionUnlockedOnlineClearing](https://dokumentation.websale.de/v8s/referenz/tags/msg-meldungen.md#bestellprozess) · [ST-LoggedIn](https://dokumentation.websale.de/v8s/referenz/tags/st/seitenzustand-und-navigation.md)

## Verwandte Themen

* Wegweiser: [Zahlungsarten anlegen, für die Zahlungsarten mit Online-Clearing](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/zahlungsarten-anlegen.md)
* Wegweiser: Hinweisseite, für das allgemeine Hinweis-Template
* Wegweiser: [Warenkorb, für die Warenkorbseite](https://dokumentation.websale.de/v8s/marketing-produkte/geschenkprodukte.md#warenkorb)


## Related topics

- [PayPal](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/paypal.md)
- [Sicherung Zahlungsvorgang gegen Brute-Force-Angriffe](https://dokumentation.websale.de/v8s/weitere-funktionen-im-bestellprozess-kontext/sicherung-zahlungsvorgang-gegen-brute-force-angriffe.md)
- [Auftragsnummern-Vergabe](https://dokumentation.websale.de/v8s/weitere-funktionen-im-bestellprozess-kontext/auftragsnummern-vergabe.md)
- [Übersicht - Zahlungsarten](https://dokumentation.websale.de/frontend/funktionsubersicht/zahlungsarten.md)
- [Zahlungsarten](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/zahlungsarten.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.