Schaltflächen der Zahlungsarten - WEBSALE Dokumentation

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.

<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

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

{BT-BankSelection_OK}
   <input type="submit" name="~BT-BankSelection_OK~" value="Auswahl übernehmen">
{/BT-BankSelection_OK}

Referenz: BANK- (Bankdaten)

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.

{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)

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`

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

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

<form action="~FORM-Basket~" method="post">
   ...
   {ST-PayPalExpressCheckout}
      <input type="submit" name="~BT-PayPalExpressCheckout~"
             value="Bestellen mit PayPal Express Checkout">
   {/ST-PayPalExpressCheckout}
</form>

{ST-PayPalExpressCheckout_selected}
   <input type="submit" name="~BT-PayPalExpressCheckout_reloadplaceorder~" value="aktualisieren">
   <input type="submit" name="~BT-PayPalExpressCheckout_cancel~" value="abbrechen">
{/ST-PayPalExpressCheckout_selected}

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.

<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 · PayPal Checkout with Vault

Klarna Payments

BT-KlarnaPayments_cancel

Bricht die Bestellung mit Klarna ab.

{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

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.

​So funktionieren die BT-Tags

​Die Bankdaten

​BT-BankSelection_OK

​Die Kreditkartenauswahl

​BT-CCardSelection_OK

​Die Suche in gespeicherten Zahlungsdaten

​PayPal Express Checkout

​BT-PPCVault_refresh

​Klarna Payments

​BT-KlarnaPayments_cancel

​Die Tags im Überblick

​Verwandte Themen

So funktionieren die BT-Tags

Die Bankdaten

BT-BankSelection_OK

Die Kreditkartenauswahl

BT-CCardSelection_OK

Die Suche in gespeicherten Zahlungsdaten

PayPal Express Checkout

BT-PPCVault_refresh

Klarna Payments

BT-KlarnaPayments_cancel

Die Tags im Überblick

Verwandte Themen