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

# PAYMORROW- (Paymorrow)

> Die Zahlungsdaten aus der Paymorrow-Antwort auf der Bestellbestätigung ausgeben und im Testmodus die Rohantworten der beiden Anfragen sichtbar machen.

Bei Paymorrow entscheidet nicht der Shop über die Zahlungsart, sondern der Dienstleister. Der Shop fragt für den aktuellen Warenkorb und die Adressdaten an, und Paymorrow antwortet mit einer Freigabe oder einer Ablehnung. Fällt die Freigabe positiv aus, liefert die Antwort zugleich die Bankverbindung, auf die der Käufer überweisen soll.

Daraus ergeben sich zwei Gruppen von Tags. `PAYMORROWPI-` gibt diese Zahlungsinformationen auf der Bestellbestätigung aus, und das ist der Teil, den jedes Template braucht. `PAYMORROW-` zeigt die vollständigen Rohantworten und ist nur im Testmodus gedacht.

Wegweiser: [Paymorrow](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/paymorrow.md)

## Zwei Zahlungsarten, zwei Anfragen

Paymorrow bedient im Shopsystem zwei Zahlungsarten: Rechnungskauf und Lastschrift. Beide laufen über dieselbe Anbindung, haben aber eine eigene Konfiguration und eine eigene Freigabe. Eine Ablehnung beim Rechnungskauf sperrt die Lastschrift also nicht mit.

Jede Zahlungsart durchläuft dabei zwei Anfragen an Paymorrow.

| Schritt | Aufgabe |
| - | - |
| `getPaymentToken` | meldet Warenkorb und Adressdaten an und holt ein Zahlungstoken |
| `authorizeByRef` | autorisiert den Kauf mit diesem Token |

Aus zwei Zahlungsarten mal zwei Anfragen mal zwei Formaten entstehen die acht `PAYMORROW-`Tags weiter unten.

Lehnt Paymorrow endgültig ab, merkt sich das Shopsystem das für die Sitzung und blendet die Zahlungsart in der Auswahl aus oder zeigt sie ausgegraut. Im Template sehen Sie das an `PAY-Data_disabled`. Sie brauchen dafür kein eigenes `PAYMORROW-`Tag.

Referenz: [PAY- (Zahlungsarten anzeigen und auswählen)](https://dokumentation.websale.de/v8s/referenz/tags/pay/zahlungsarten-anzeigen-und-auswaehlen.md)

## Die Zahlungsinformationen ausgeben

Nach einer erfolgreichen Autorisierung liefert Paymorrow die Daten, auf die der Käufer überweisen soll. Die Tags der Familie `PAYMORROWPI-` holen diese Daten einzeln. Der Teil hinter dem Bindestrich ist der Feldname, so wie Paymorrow ihn in der Antwort schreibt.

| Tag | Liefert |
| - | - |
| `PAYMORROWPI-recipientName` | den Namen des Begünstigten |
| `PAYMORROWPI-recipientBankName` | das Kreditinstitut des Zahlungsempfängers |
| `PAYMORROWPI-recipientIBAN` | die IBAN des Zahlungsempfängers |
| `PAYMORROWPI-recipientBIC` | die BIC des Zahlungsempfängers |
| `PAYMORROWPI-recipientNBAN` | die Kontonummer des Zahlungsempfängers |
| `PAYMORROWPI-recipientNBC` | die Bankleitzahl des Zahlungsempfängers |
| `PAYMORROWPI-referenceTextLine1` | den Verwendungszweck, erste Zeile |
| `PAYMORROWPI-referenceTextLine2` | den Verwendungszweck, zweite Zeile |

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{PAYMORROWPI-recipientName}
   <h2>Bitte überweisen Sie auf folgendes Konto</h2>

   <dl>
      <dt>Kontoinhaber</dt>
      <dd>~PAYMORROWPI-recipientName~</dd>

      <dt>Kreditinstitut</dt>
      <dd>~PAYMORROWPI-recipientBankName~</dd>

      <dt>IBAN</dt>
      <dd>~PAYMORROWPI-recipientIBAN~</dd>

      <dt>BIC</dt>
      <dd>~PAYMORROWPI-recipientBIC~</dd>

      <dt>Verwendungszweck</dt>
      <dd>
         ~PAYMORROWPI-referenceTextLine1~
         {PAYMORROWPI-referenceTextLine2}<br>~PAYMORROWPI-referenceTextLine2~{/PAYMORROWPI-referenceTextLine2}
      </dd>
   </dl>
{/PAYMORROWPI-recipientName}
```

> [!WARNING]
>
> Die Tags arbeiten erst, wenn die Bestellung abgeschlossen ist. Vorher gelten sie als ungültiges Tag, auch auf einem der erlaubten Templates. Deshalb stehen sie ausschließlich auf der Bestelleingangsbestätigung, in deren PDF und in der Bestätigungs-E-Mail.

Klammern Sie den ganzen Block mit einem Feld, das immer gefüllt ist, beispielsweise `PAYMORROWPI-recipientName`. Bei jeder anderen Zahlungsart liegen die Daten nicht vor, die Klammerung greift nicht, und die Überschrift verschwindet mitsamt dem Block.

Die beiden Zeilen des Verwendungszwecks sind nicht beide garantiert gefüllt. Klammern Sie die zweite Zeile, sonst steht dort ein leerer Umbruch.

### Weitere Felder aus der Antwort

Das Shopsystem legt alle Felder der Zahlungsinformation als Liste ab und sucht beim Auflösen eines Tags schlicht nach dem Namen dahinter. Liefert Paymorrow ein Feld, das oben nicht steht, erreichen Sie es mit demselben Muster.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{PAYMORROWPI-<Feldname aus der Antwort>}
   ~PAYMORROWPI-<Feldname aus der Antwort>~
{/PAYMORROWPI-<Feldname aus der Antwort>}
```

Ein Feldname, den die Antwort nicht enthält, ist kein Fehler. Der Einzel-Tag gibt dann nichts aus und die Klammerung greift nicht. Sie können also auf ein Feld zugreifen, das nur unter bestimmten Umständen mitgeliefert wird, ohne das Template zu zerlegen.

Die Werte werden HTML-kodiert ausgegeben. Sie können sie ohne weitere Behandlung in die Seite und in die E-Mail setzen.

## Die Rohantworten im Testmodus

Zur Fehlersuche gibt das Shopsystem die vollständigen Antworten von Paymorrow aus. Es gibt sie je Zahlungsart, je Anfrage und in zwei Formaten.

| Tag | Zahlungsart | Anfrage | Format |
| - | - | - | - |
| `PAYMORROW-XMLResponseGetPaymentToken` | Rechnung | `getPaymentToken` | XML |
| `PAYMORROW-JSONResponseGetPaymentToken` | Rechnung | `getPaymentToken` | JSON |
| `PAYMORROW-XMLResponseAuthorizeByRef` | Rechnung | `authorizeByRef` | XML |
| `PAYMORROW-JSONResponseAuthorizeByRef` | Rechnung | `authorizeByRef` | JSON |
| `PAYMORROW-DebitXMLResponseGetPaymentToken` | Lastschrift | `getPaymentToken` | XML |
| `PAYMORROW-DebitJSONResponseGetPaymentToken` | Lastschrift | `getPaymentToken` | JSON |
| `PAYMORROW-DebitXMLResponseAuthorizeByRef` | Lastschrift | `authorizeByRef` | XML |
| `PAYMORROW-DebitJSONResponseAuthorizeByRef` | Lastschrift | `authorizeByRef` | JSON |

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{PAYMORROW-XMLResponseAuthorizeByRef}
   <pre>~PAYMORROW-XMLResponseAuthorizeByRef~</pre>
{/PAYMORROW-XMLResponseAuthorizeByRef}
```

> [!WARNING]
>
> Außerhalb des Testmodus geben alle acht Tags nichts aus, und die Klammerung greift nicht. Sie können sie deshalb dauerhaft im Template stehen lassen, ohne dass ein Käufer je etwas davon sieht. Verlassen Sie sich trotzdem nicht allein darauf: die Antworten enthalten Adress- und Bestelldaten und gehören auf keine Seite, die im Livebetrieb erreichbar ist.

Paymorrow antwortet ausschließlich in XML. Die JSON-Variante ist eine Umwandlung durch das Shopsystem, kein zweites Format vom Dienstleister. Für die Fehlersuche gegenüber Paymorrow ist deshalb die XML-Fassung die maßgebliche.

Die Ausgabe ist HTML-kodiert. Die spitzen Klammern des XML erscheinen also als Text und zerstören die Seite nicht. Ein `pre`-Element um das Tag herum macht die Antwort lesbar.

Jede Antwort steht nur so lange zur Verfügung, wie die zugehörige Anfrage im selben Seitenaufruf stattgefunden hat. Setzen Sie die Tags also auf die Seite, auf der der Vorgang ausgelöst wird, und nicht auf eine beliebige spätere.

## Die Tags im Überblick

| Tag | Einzel-Tag | Bereichs-Tag | negatives Bereichs-Tag | Schleifen-Tag |
| - | - | - | - | - |
| `PAYMORROWPI-<Feldname>` | ja | ja | ja | – |
| `PAYMORROW-XMLResponseGetPaymentToken` | ja | ja | ja | – |
| `PAYMORROW-JSONResponseGetPaymentToken` | ja | ja | ja | – |
| `PAYMORROW-XMLResponseAuthorizeByRef` | ja | ja | ja | – |
| `PAYMORROW-JSONResponseAuthorizeByRef` | ja | ja | ja | – |
| `PAYMORROW-DebitXMLResponseGetPaymentToken` | ja | ja | ja | – |
| `PAYMORROW-DebitJSONResponseGetPaymentToken` | ja | ja | ja | – |
| `PAYMORROW-DebitXMLResponseAuthorizeByRef` | ja | ja | ja | – |
| `PAYMORROW-DebitJSONResponseAuthorizeByRef` | ja | ja | ja | – |

Die `PAYMORROWPI-`Tags gelten auf der Bestelleingangsbestätigung `ws_confirm.htm`, in deren PDF-Fassung `pdf_confirm.htm` und in der Bestelleingangsbestätigungs-E-Mail `mail_customer_order.htm`, jeweils erst nach abgeschlossener Bestellung. Die `PAYMORROW-`Tags sind auf allen Templates zulässig.

## Verwandte Themen

* Wegweiser: [Paymorrow](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/paymorrow.md)
* Wegweiser: Bestelleingangsbestätigung gestalten
* Referenz: [PAY- (Zahlungsarten anzeigen und auswählen)](https://dokumentation.websale.de/v8s/referenz/tags/pay/zahlungsarten-anzeigen-und-auswaehlen.md)


## Related topics

- [Paymorrow](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/paymorrow.md)
- [Materialien Paymorrow-Fehlermeldungen](https://dokumentation.websale.de/v8s/materialien/materialien-paymorrow-fehlermeldungen.md)
- [Zahlungsarten](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/zahlungsarten.md)
- [Sektionen: Positionen und Zahlung](https://dokumentation.websale.de/v8s/schnittstellen/bestellungen/ws-bestelldaten/sektionen-positionen-und-zahlung.md)
- [Rechnungskauf](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/rechnungskauf.md)


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