Tamaro in einem Bezahl-Checkout einsetzen

Das Tamaro Widget kann soweit reduziert werden, dass es ausschließlich als Bezahl-Checkout zur Auswahl der Zahlungsart eingesetzt werden kann. Hierzu werden alle Elemente des Tamaro ausser dem Block mit den Zahlungsarten ausgeblendet. Der Code dafür ist relativ kompakt : 

<div class="rnw-widget-container"></div>
<script src="https://tamaro.raisenow.com/WIDGET-ID/latest/widget.js"></script> 
<script>
  window.rnw.tamaro.runWidget('.rnw-widget-container', {
    language: 'de',
    paymentWidgetBlocks: [
      "payment_payment_methods",
      {
        if: "showPaymentAddress() == true",
        then: ['payment_address'],
      },
    ],
    currencies: ['chf'],
    amounts: [50],
    paymentValidations: {
    }, 
  }).then(function(api) {
    window.api = api;
  });
</script>

Die Zeilen 1-5 und 17-20 entsprechen dem üblichen Code zum Einbau des Widgets; Du musst also nur die Zeilen 6-16 (ab einschließlich "paymentWidgetBlocks: [") einfügen, wenn Du das Widget bereits in Betrieb genommen haben.

Bitte beachten: Bei einigen Zahlungsarten wie z.B. Kreditkartenzahlung erfordert der Finanzdienstleister die Eingabe zusätzlicher Adressdaten. Bei Auswahl einer solchen Zahlungsart wird daher ein entsprechendes zusätzliches Adressfeld eingeblendet. Wenn Du dies nicht wünscht, kannst Du Dich entweder auf Zahlungsarten beschränken, die solche Anforderungen nicht haben (TWINT, Paypal) oder diese Daten ebenfalls im Code oder per Url übergeben und die Ausgabe des Adressfeldes im Code unterdrücken. Wende Dich mit Fragen hierzu gerne an unseren Support. Die Auswahl der angebotenen Zahlungsarten kann ebenfalls über unseren Support festgelegt werden.

Im folgenden werde ich die Bedeutung einzelner Codezeilen erklären, in die Du eigene Werte eintragen musst : 

currencies: ['chf'],

Hiermit legst Du die Bezahlwährung fest. Da nur die Zahlungsmethoden als Auswahlfelder angeboten werden, müssen die anderen erforderlichen Informationen dem Widget anderweitig übergeben werden. Andere zulässige Währungen hier sind z.B. "eur" für Euro oder "usd" für US-Dollar. 

amounts: [50],

Trage zwischen den eckigen Klammern den Betrag ein, der gezahlt werden soll. Ebenso wie bei der Währung muss auch dieser Betrag vorab übergeben werden.

Die restlichen Codezeilen sind aus formalen Gründen erforderlich und dürfen nicht weggelassen werden.

Alternative Vorgehensweise : Anstatt amounts und defaultCurrency im Code festzulegen, kannst Du diese auch als URL-Parameter übergeben. Die Syntax dafür ist :

https://www.webseite.de/?rnw-amount=50&rnw-currency=eur

In diesem Fall musst Du zwingend alle auswählbaren Zahlungsarten im currencies-Objekt vorher definieren.

Beispiel : Wenn Du z.B. generell Zahlungen sowohl in USD, EUR und CHF annehmen willst und im konkreten Fall eine Zahlung von 200 USD vornehmen willst, musst Du  im Code die Zeile 

currencies: ['chf'],

wie folgt abändern : 

currencies: ['chf', 'usd', 'eur'],

und dann das Widget mit dieser URL aufrufen : 

https://www.webseite.de/?rnw-amount=200&rnw-currency=usd

Die Zeile amounts muss nicht verändert werden; der Wert wird hier einfach vom URL-Parameter überschrieben.

Wenn Du der Anleitung bis hierhin gefolgt bist, sieht das Widget jetzt z.B so aus :

Damit ist das Widget einsatzbereit. Beachte bitte noch, dass es angeraten ist, auf dieser Checkout-Seite noch einmal separat den Gesamtbetrag und die Währung anzuzeigen, da das Widget dies in dieser reduzierten Version nicht mehr vornimmt.

Ein letzter Hinweis noch : Das es sich hierbei um Javascript-Code handelt, der auf kundenseitig  ausgeführt und daher vom Kunden verändert werden kann, sollte bei Einsatz des Widgets in einem kommerziellen Umfeld wie in solchen Fällen üblich nach Zahlungsabschluss noch eine serverseitige Prüfung der Zahlung durchgeführt werden, bevor eventuelle Lieferzusagen gemacht werden.