> ## 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.

# Schaltflächen der Zahlungsarten

> Die BT-Tags rund um die Zahlung: Bankdaten prüfen, speichern und durchsuchen, Kreditkartendaten suchen sowie die Schaltflächen für PayPal Express Checkout, PayPal Checkout with Vault und Klarna Payments.

Zahlungsarten brauchen mehr Schaltflächen als andere Shopbereiche, weil die Daten geprüft werden müssen, bevor die Bestellung weitergeht. Bei den Bankdaten geschieht das in zwei Schritten, bei den externen Zahlungsdiensten übernimmt der Dienst selbst einen Teil des Ablaufs.

Die Tags dieser Seite verteilen sich auf drei Bereiche: die Bankdaten im Kundenkonto und auf der Bestellübersicht, die Suche in gespeicherten Zahlungsdaten und die Schaltflächen der angebundenen Zahlungsdienste.

## So funktionieren die BT-Tags

Ein `BT-`Tag gibt den technischen Namen der Schaltfläche aus, nicht ihre Beschriftung. Der Shop erkennt an diesem Namen, welche Schaltfläche gedrückt wurde.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<input type="submit" name="~BT-BankSubmit~" value="Bankverbindung speichern">
```

Das Tag gehört in das `name`-Attribut, der Text für den Käufer in `value`. Die Schaltfläche muss absenden und innerhalb des zugehörigen Formulars stehen.

## Die Bankdaten

Die Eingabe der Bankverbindung läuft in zwei Schritten. Im ersten Schritt gibt der Käufer IBAN und BIC ein, im zweiten bestätigt er die vom Shop ermittelte Bank. Vier Tags bilden diesen Ablauf ab.

| Tag | Aktion |
| - | - |
| `BT-BankProof` | Eingaben prüfen, also Schritt 1 abschließen |
| `BT-BankChange` | von Schritt 2 zurück zu Schritt 1 |
| `BT-BankSubmit` | Eingaben absenden |
| `BT-Bank_Refresh` | Anzeige aktualisieren |

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{BT-BankProof}
   <input type="submit" name="~BT-BankProof~" value="Eingaben prüfen">
{/BT-BankProof}

{BT-BankChange}
   <input type="submit" name="~BT-BankChange~" value="Eingaben ändern">
{/BT-BankChange}

{BT-BankSubmit}
   <input type="submit" name="~BT-BankSubmit~" value="Bankverbindung speichern">
{/BT-BankSubmit}
```

`BT-BankProof`, `BT-BankChange` und `BT-BankSubmit` sind auch Bereichs-Tags. Das ist hier keine Spielerei: Die Klammerung zeigt jede Schaltfläche nur in dem Schritt, in dem sie sinnvoll ist. Ohne sie steht die Schaltfläche "Eingaben ändern" schon da, bevor es etwas zu ändern gibt.

`BT-Bank_Refresh` steht in der älteren Dokumentation als `BT-Bank_refresh`. Beide Schreibweisen funktionieren, weil der Shop Tagnamen ohne Rücksicht auf Groß- und Kleinschreibung auflöst.

### BT-BankSelection\_OK

Übernimmt die Auswahl einer gespeicherten Bankverbindung auf der Bestellübersichtsseite. Auch dieses Tag ist ein Bereichs-Tag und zeigt damit an, ob überhaupt mehrere Bankverbindungen zur Auswahl stehen.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{BT-BankSelection_OK}
   <input type="submit" name="~BT-BankSelection_OK~" value="Auswahl übernehmen">
{/BT-BankSelection_OK}
```

Referenz: [BANK- (Bankdaten)](https://dokumentation.websale.de/v8s/referenz/tags/bank.md)

## Die Kreditkartenauswahl

### BT-CCardSelection\_OK

Aktualisiert die Auswahl der gespeicherten Kreditkarte auf der Bestellübersichtsseite. Als Bereichs-Tag greift die Schaltfläche nur, wenn der Käufer angemeldet ist und gespeicherte Kreditkartendaten vorliegen.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{BT-CCardSelection_OK}
   <noscript>
      <input type="submit" name="~BT-CCardSelection_OK~" value="Auswahl übernehmen">
   </noscript>
{/BT-CCardSelection_OK}
```

Die Schaltfläche ist der Rückfallweg für abgeschaltetes JavaScript, genau wie `BT-BankSelection_OK` bei der Bankverbindung. Mit JavaScript löst die Auswahlliste die Aktualisierung selbst aus.

Referenz: [CC- (Kreditkartendaten)](https://dokumentation.websale.de/v8s/referenz/tags/cc.md)

## Die Suche in gespeicherten Zahlungsdaten

Geschäftskunden haben oft mehrere Bankverbindungen und Kreditkarten hinterlegt. Zwei Tags lösen die Volltextsuche darin aus.

| Tag | Sucht in | Template | Formular |
| - | - | - | - |
| `BT-BankSearch` | den Bankdaten | Bankdatenverwaltung (`ws_bank_manage.htm`) | `FORM-BankSearch` |
| `BT-CCardSearch` | den Kreditkartendaten | Kreditkartenverwaltung (`ws_creditcard_manage.htm`) | `FORM-CCardSearch` |

> [!WARNING]
>
> Beide Schaltflächen müssen im jeweils genannten Formular stehen. In einem anderen Formular derselben Seite bleibt die Suche wirkungslos.

Wegweiser: [Volltextsuche für multiple Kundendaten anbieten](https://dokumentation.websale.de/v8s/kundenkonto/volltextsuche-fuer-kundendaten-anbieten.md)

## PayPal Express Checkout

Beim Express Checkout startet der Käufer die Bestellung schon im Warenkorb und kehrt anschließend mit Adresse und Zahlungsart aus seinem PayPal-Konto zurück. Drei Tags gehören dazu, und sie stehen auf zwei verschiedenen Seiten.

| Tag | Schaltfläche | Template |
| - | - | - |
| `BT-PayPalExpressCheckout` | Bestellung mit PayPal starten | Warenkorbseite (`ws_basket.htm`) |
| `BT-PayPalExpressCheckout_cancel` | Bestellung abbrechen | Bestellübersichtsseite (`ws_place_order.htm`) |
| `BT-PayPalExpressCheckout_reloadplaceorder` | Bestellübersicht aktualisieren | Bestellübersichtsseite |

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<form action="~FORM-Basket~" method="post">
   ...
   {ST-PayPalExpressCheckout}
      <input type="submit" name="~BT-PayPalExpressCheckout~"
             value="Bestellen mit PayPal Express Checkout">
   {/ST-PayPalExpressCheckout}
</form>
```

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{ST-PayPalExpressCheckout_selected}
   <input type="submit" name="~BT-PayPalExpressCheckout_reloadplaceorder~" value="aktualisieren">
   <input type="submit" name="~BT-PayPalExpressCheckout_cancel~" value="abbrechen">
{/ST-PayPalExpressCheckout_selected}
```

> [!WARNING]
>
> Die Abbrechen-Schaltfläche gehört dazu. Der Käufer hat den Bestellablauf über PayPal begonnen und kommt ohne sie nicht mehr zu einer anderen Zahlungsart zurück.

### BT-PPCVault\_refresh

Gibt den Namen einer versteckten Schaltfläche für PayPal Checkout with Vault aus. Sie wird nicht angeklickt, sondern per JavaScript ausgelöst.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<button type="submit" name="~BT-PPCVault_refresh~" id="ppcvaultrefresh" hidden></button>
```

Die Schaltfläche bleibt absichtlich leer und unsichtbar. Das JavaScript des Zahlungsdienstes löst sie aus, sobald es eine hinterlegte Zahlungsquelle übernommen hat.

Wegweiser: [PayPal Express Checkout](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/paypal.md#paypal-express-checkout) · [PayPal Checkout with Vault](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/paypal-checkout.md)

## Klarna Payments

### BT-KlarnaPayments\_cancel

Bricht die Bestellung mit Klarna ab.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{ST-KlarnaPayments}
   <button type="submit" name="~BT-KlarnaPayments_cancel~">Zahlung abbrechen</button>
{/ST-KlarnaPayments}
```

Wie beim Express Checkout gibt es auch hier keine Schaltfläche zum Starten in der BT-Gruppe. Klarna wird über die normale Zahlungsartenauswahl gewählt, und nur der Abbruch braucht ein eigenes Tag.

Wegweiser: [Klarna Payments](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/klarna-payments.md)

## Die Tags im Überblick

| Tag | Einzel-Tag | Bereichs-Tag | negatives Bereichs-Tag |
| - | - | - | - |
| `BT-Bank_Refresh` | ja | – | – |
| `BT-BankChange` | ja | ja | ja |
| `BT-BankProof` | ja | ja | ja |
| `BT-BankSearch` | ja | – | – |
| `BT-BankSelection_OK` | ja | ja | ja |
| `BT-BankSubmit` | ja | ja | ja |
| `BT-CCardSelection_OK` | ja | ja | ja |
| `BT-CCardSearch` | ja | – | – |
| `BT-PayPalExpressCheckout` | ja | – | – |
| `BT-PayPalExpressCheckout_cancel` | ja | – | – |
| `BT-PayPalExpressCheckout_reloadplaceorder` | ja | – | – |
| `BT-PPCVault_refresh` | ja | – | – |
| `BT-KlarnaPayments_cancel` | ja | – | – |

Keines ist ein Schleifen-Tag.

## Verwandte Themen

* Wegweiser: [Zahlungsarten anlegen](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/zahlungsarten-anlegen.md)
* Wegweiser: [PayPal-Checkout](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/paypal-checkout.md)
* Referenz: [BANK- (Bankdaten)](https://dokumentation.websale.de/v8s/referenz/tags/bank.md)
* Referenz: [Schaltflächen im Bestellprozess](https://dokumentation.websale.de/v8s/referenz/tags/bt/bestellprozess.md)


## Related topics

- [CC- (Kreditkartendaten)](https://dokumentation.websale.de/v8s/referenz/tags/cc.md)
- [Schaltflächen im Bestellprozess](https://dokumentation.websale.de/v8s/referenz/tags/bt/bestellprozess.md)
- [Standardgrafiken](https://dokumentation.websale.de/v8s/einstellungen/standardgrafiken.md)
- [Zahlungsarten](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/zahlungsarten.md)
- [Schaltflächen für die Adressen](https://dokumentation.websale.de/v8s/referenz/tags/bt/adressen.md)


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