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

> Wie Sie Rechnungskauf und Lastschrift über Paymorrow in WEBSALE V8s einrichten, welche Zusatzangaben Paymorrow verlangt und wie sich Ablehnungen behandeln lassen.

Rechnungskauf und Lastschrift kann ein Shop selbst anbieten oder abgeben. Paymorrow ist der Weg, sie abzugeben: Der Anbieter prüft Anschrift und Bonität, übernimmt das Ausfallrisiko und führt das Debitorenmanagement. Bei der Lastschrift verwaltet er zusätzlich die SEPA-Mandate, Rückbuchungen und Nachbelastungen.

Für den Käufer ändert sich der Ablauf kaum. Er zahlt auf Rechnung wie gewohnt, überweist aber an ein Konto von Paymorrow statt an Ihres, und er muss zwei Angaben mehr machen als sonst.

Beide Zahlungsarten lassen sich unabhängig voneinander über Paymorrow abwickeln, und die Einrichtung läuft für beide fast gleich. Diese Seite beschreibt sie gemeinsam und nennt die Unterschiede an den Stellen, an denen es welche gibt.

> [!WARNING]
>
> Die Lastschrift lässt sich **entweder** über Paymorrow **oder** direkt abwickeln, nicht beides nebeneinander. Beide Wege belegen denselben Konfigurationsabschnitt `<PaymentDebitNote-Txt>`.

## Was Paymorrow verlangt

| Angabe | Von wem |
| - | - |
| Telefonnummer | von allen |
| Geburtsdatum | nur von Privatkunden |
| Rechtsform, Firmeninhaber, Registernummer | optional von Firmenkunden, erhöht die Annahmequote |

Ob jemand Privat- oder Firmenkunde ist, entscheidet allein das Feld **Firma** in der Rechnungsadresse. Ist es gefüllt, meldet der Shop den Vorgang als B2B an, sonst als B2C.

Die Telefonnummer nimmt der Shop bevorzugt aus der Rechnungsadresse, Festnetz oder Mobil. Erst wenn dort keine steht, greift er auf das Feld zurück, das Sie bei der Zahlungsart abfragen. Fragen Sie die Telefonnummer also ohnehin schon in der Adresse ab, ist das Zusatzfeld nur die Rückfallebene.

Auch die Umsatzsteuer-Identifikationsnummer geht mit, sobald sie in der Rechnungsadresse steht. Dafür brauchen Sie nichts einzurichten.

## Wie der Bezahlvorgang abläuft

![Paymorror](https://mintcdn.com/websaleag-44ee7ea6/qbW8uRSswcI46vuk/images/paymorror.png?fit=max\&auto=format\&n=qbW8uRSswcI46vuk\&q=85\&s=d5fdc88ad2bb4409d471bc774b6e874e)

1. Der Käufer wählt die Zahlungsart und ergänzt die fehlenden Angaben.
2. Nach dem Absenden der Bestellung prüft Paymorrow Anschrift und Bonität über Auskunfteien.
3. **Bei Erfolg und Rechnungskauf** bekommt der Käufer die Bankverbindung von Paymorrow angezeigt, an die er überweist. **Bei Erfolg und Lastschrift** ist der Vorgang für ihn beendet.
4. **Bei Ablehnung** landet er zurück auf der Zahlungs- und Versandartenseite mit einem Hinweis und der Bitte, eine andere Zahlungsart zu wählen.

> [!WARNING]
>
> Die Bankverbindung, die der Käufer beim Rechnungskauf sieht, ist **nicht Ihre**. Es ist ein Konto von Paymorrow, von dem die Zahlungen an Sie weitergeleitet werden. Eingerichtet wird das im Abwicklungskonto bei Paymorrow, nicht im Shop.

## Abweichende Lieferadressen

> [!WARNING]
>
> Für **Neukunden** ist eine abweichende Lieferadresse grundsätzlich nicht zulässig. Für Bestandskunden kann sie erlaubt werden, das müssen Sie aber vorher mit Paymorrow abstimmen. Schalten Sie sie nicht einfach frei.

## Schritt 1: Vertrag und Freischaltung

Schließen Sie einen Vertrag mit Paymorrow ab und lassen Sie die Zahlungsart anschließend von WEBSALE freischalten. Dabei wird auch eine besondere Konfiguration eingerichtet, die für den Testbetrieb gebraucht wird.

Für die Lastschrift über Paymorrow kommt eine Voraussetzung dazu: Das SEPA-Lastschriftverfahren muss in Ihrem Shop bereits eingerichtet sein.

Wegweiser: [Lastschrift, für die Einrichtung des SEPA-Verfahrens](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/lastschrift.md)

## Schritt 2: Zahlungsart anlegen

Welcher Abschnitt es ist, hängt von der Zahlungsart ab.

| Zahlungsart | Abschnitt |
| - | - |
| Rechnung mit Paymorrow | `<PaymentPaymorrow-Txt>` |
| Lastschrift mit Paymorrow | `<PaymentDebitNote-Txt>` |

Bei der Lastschrift übernehmen Sie den bestehenden Abschnitt der bisherigen Lastschrift und ergänzen die Paymorrow-Parameter. Alle Parameter des SEPA-Verfahrens bleiben dabei erhalten.

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<PaymentPaymorrow-Txt>
   Allow            = yes
   TestMode         = yes
   Name             = Kauf auf Rechnung mit Paymorrow
   NameSuffix       = Zahlen Sie erst, wenn Sie mit der Bestellung zufrieden sind.
   Img              = logo-paymorrow.png
   RadioOnClick     = selectPayment('~ID~');
   ImgOnClick       = selectPaymentImage('~ID~');
   DelivererID-List = standard,express

   BillCountry-Rule                       = AllowCountries
   BillCountry-List                       = DEU
   NewUser-Allow                          = yes
   DenyDifferentDeliveryAddressForNewUser = yes
   ExplicitAllowDifferentDeliveryAddress  = no
   InstantVoucherProducts-Allow           = no

   PaymorrowRequestLanguageCode         = de
   SalutationCodeFemale-List            = 02
   SalutationCodeMale-List              = 01
   PaymorrowExternalNotifyMessagePrefix = <div class="box_error">
   PaymorrowExternalNotifyMessageSuffix = </div>

   PaymorrowLineItemPaymentCostNumber = 111111
   PaymorrowLineItemPaymentCostName   = Zahlungskosten
   PaymorrowLineItemAdditionNumber    = 222222
   PaymorrowLineItemAdditionName      = Zusatzkosten
   PaymorrowLineItemReductionNumber   = 333333
   PaymorrowLineItemReductionName     = Rabatte
   PaymorrowLineItemShippingNumber    = 444444
   PaymorrowLineItemShippingName      = Versandkosten
   PaymorrowLineItemDefaultName       = Produkt
</PaymentPaymorrow-Txt>
```

| Parameter | Bedeutung |
| - | - |
| `SalutationCodeFemale-List` | Anredecodes, die Paymorrow als weiblich gemeldet werden |
| `SalutationCodeMale-List` | Anredecodes, die als männlich gemeldet werden |
| `PaymorrowRequestLanguageCode` | Sprache der Anfrage an Paymorrow |
| `PaymorrowExternalNotifyMessagePrefix` | HTML vor einer Meldung, die von Paymorrow kommt |
| `PaymorrowExternalNotifyMessageSuffix` | HTML danach |
| `PaymorrowLineItem…Number` | Produktnummer der jeweiligen Sammelposition |
| `PaymorrowLineItem…Name` | Bezeichnung der jeweiligen Sammelposition |
| `PaymorrowLineItemDefaultName` | Bezeichnung für Positionen ohne eigenen Namen |

Die Anredecodes stammen aus Ihrer `salutation.dat`. Fehlt ein Code in beiden Listen, meldet der Shop kein Geschlecht an Paymorrow. Das ist kein Fehler, kann aber die Annahmequote drücken.

> [!WARNING]
>
> Die vier `…Number`-Parameter sind Pseudo-Produktnummern und dürfen **nicht** aus dem Nummernkreis Ihrer echten Produkte stammen. Die zugehörigen `…Name`-Parameter dürfen außerdem **nicht leer** bleiben. Stimmen Sie die Nummern mit dem Verantwortlichen für die Warenwirtschaft ab.

Paymorrow bekommt den Warenkorb positionsweise übergeben. Zahlungskosten, Zuschläge, Rabatte und Versandkosten lassen sich dort nicht als Korrektur abbilden, sie gehen deshalb als eigene Positionen mit. Deshalb brauchen sie Nummer und Namen.

Referenz: [Abschnitt PaymentPaymorrow-Txt](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/zahlungsarten.md#paymentpaymorrow-txt) · [Abschnitt PaymentDebitNote-Txt](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/zahlungsarten.md#paymentdebitnote-txt) · [Abschnitt PaymentXXX-Txt](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/zahlungsarten.md)

## Schritt 3: Telefonnummer und Geburtsdatum abfragen

Zwei Zusatzabfragen im selben Abschnitt. Die Kennungen sind fest vorgegeben, nur beim Geburtsdatum unterscheiden sie sich zwischen den beiden Zahlungsarten.

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<+CountryRule>
   CountryList-ISO          = *
   UseAddressInput          = customer
   FieldDescr-Txt           = Telefonnummer
   Type                     = input
   Required                 = yes
   RequiredErrorMessage-Txt = Bitte geben Sie eine Telefonnummer an.
   ID                       = ws_clearing_paymorrow_phone
   HideInReadableOrder-Allow = no
</+CountryRule>

<+CountryRule>
   CountryList-ISO          = *
   UseAddressInput          = customer
   FieldDescr-Txt           = Geburtsdatum
   Type                     = dateofbirth
   Required                 = yes
   RequiredErrorMessage-Txt = Bitte geben Sie Ihr Geburtsdatum an.
   ID                       = dateofbirthpaymorrow
   UserDependency           = private
   HideInReadableOrder-Allow = no
</+CountryRule>
```

| Abfrage | Kennung bei Rechnung | Kennung bei Lastschrift |
| - | - | - |
| Telefonnummer | `ws_clearing_paymorrow_phone` | `ws_clearing_paymorrow_phone` |
| Geburtsdatum | `dateofbirthpaymorrow` | `dateofbirthdebitpaymorrow` |

`UserDependency = private` sorgt dafür, dass das Geburtsdatum nur abgefragt wird, wenn das Feld Firma leer ist. Firmenkunden bekommen es nicht zu sehen.

Referenz: [Abschnitt +CountryRule](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/zahlungsarten.md#countryrule)

## Schritt 4: Zahlungsart auf eine Kundenart beschränken (optional)

Wollen Sie Paymorrow nur Privatkunden anbieten, schließen Sie die Firmenanrede aus.

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<AddressFilter>
   Allow              = yes
   TechnicalFieldName = SalutationCode
   Rule               = Deny
   Values-List        = 03
</AddressFilter>
```

`03` steht in diesem Beispiel für „Firma". Prüfen Sie den Code in Ihrer eigenen `salutation.dat` nach.

> [!WARNING]
>
> Der Filter greift nur, wenn das Feld `SalutationCode` im Abschnitt `<AddressFields-Txt>` aktiviert ist.

Referenz: [Abschnitt AddressFilter](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/zahlungsarten.md#addressfilter) · [Konfiguration salutation.dat](https://dokumentation.websale.de/v8s/referenz/konfigurationen/konfiguration-salutation-dat.md)

## Schritt 5: Hinweismeldungen hinterlegen

Der Name der Fehlermeldung unterscheidet sich zwischen den beiden Zahlungsarten.

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<NotifyMessages-Txt>
   Paymorrow-ClearingError = Der Bezahlvorgang mit Paymorrow wurde abgelehnt. Bitte wählen Sie eine andere Zahlungsart.
   Debit-ClearingError     = Der Bezahlvorgang mit Paymorrow wurde abgelehnt. Bitte wählen Sie eine andere Zahlungsart.
   PaymentInputSuffix      = Bitte ergänzen Sie die erforderlichen Angaben zu Ihrer gewählten Zahlungsart.
</NotifyMessages-Txt>
```

| Zahlungsart | Fehlermeldung |
| - | - |
| Rechnung mit Paymorrow | `Paymorrow-ClearingError` |
| Lastschrift mit Paymorrow | `Debit-ClearingError` |

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

## Schritt 6: AGB-Zustimmung umplatzieren

> [!WARNING]
>
> Die Zustimmung zu den AGB muss bei Paymorrow zwingend auf der Adressseite `ws_address_combined.htm` erfolgen, nicht erst auf der Bestellübersicht. Steht das Auswahlkästchen in Ihrem Shop woanders, müssen Sie es umplatzieren.

Wegweiser: [AGB akzeptieren](https://dokumentation.websale.de/v8s/bestelluebersicht-bestelleingangsbestaetigung/agb-akzeptieren.md)

## Schritt 7: Kontodaten anzeigen (nur Rechnungskauf)

Beim Rechnungskauf braucht der Käufer die Bankverbindung, an die er überweisen soll. Sie gehört auf die Bestelleingangsbestätigung in allen drei Ausprägungen: `ws_confirm.htm`, `pdf_confirm.htm` und `mail_customer_order.htm`.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{PAYMORROWPI-recipientName}
   <h2>Ihre Zahlungsanweisung</h2>
   <p>Kontoinhaber: ~PAYMORROWPI-recipientName~</p>
   <p>IBAN: ~PAYMORROWPI-recipientIBAN~</p>
   <p>BIC: ~PAYMORROWPI-recipientBIC~</p>
   <p>Kreditinstitut: ~PAYMORROWPI-recipientBankName~</p>
   <p>Verwendungszweck: ~PAYMORROWPI-referenceTextLine1~ ~PAYMORROWPI-referenceTextLine2~</p>
{/PAYMORROWPI-recipientName}
```

Die Klammerung sorgt dafür, dass der Block nur bei einer Bestellung mit Paymorrow erscheint.

Zusätzlich gibt es `~PAYMORROWPI-recipientNBAN~` für die Kontonummer und `~PAYMORROWPI-recipientNBC~` für die Bankleitzahl. Für den SEPA-Zahlungsverkehr reichen IBAN und BIC.

Referenz: [PAYMORROWPI-Tags](https://dokumentation.websale.de/v8s/referenz/tags/paymorrow.md)

## Schritt 8: Firmendaten abfragen (optional)

Bei Firmenkunden lässt sich die Annahmequote erhöhen, indem Sie Rechtsform, Firmeninhaber und Registernummer mitschicken.

### Erweiterten Modus einschalten

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
B2BMode = advanced
```

Das gehört in denselben Abschnitt wie die Zahlungsart selbst. Der Modus wirkt nur, wenn das Feld Firma gefüllt ist.

### Felder anlegen und zuordnen

Legen Sie für Rechtsform, Firmeninhaber und Registernummer Suffix-Felder in den Adressdaten an. Danach verknüpfen Sie diese Felder mit den Parametern von Paymorrow.

| Zahlungsart | Zuordnungsabschnitt |
| - | - |
| Rechnung mit Paymorrow | `<Paymorrow-Mapping>` |
| Lastschrift mit Paymorrow | `<PaymorrowDebit-Mapping>` |

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<Paymorrow-Mapping>
   LegalForm          = Suffix25
   Owner              = Suffix26
   RegistrationNumber = Suffix27
</Paymorrow-Mapping>
```

> [!WARNING]
>
> Übergeben Sie **entweder** Rechtsform und Firmeninhaber **oder** Rechtsform und Registernummer. Alle drei zusammen führen zu Fehlern.

Die Umsatzsteuer-Identifikationsnummer gehört nicht in diese Zuordnung. Sie geht ohnehin mit, sobald sie in der Rechnungsadresse steht, und zwar unabhängig vom erweiterten Modus.

> [!WARNING]
>
> Wenn Sie die Rechtsform als Auswahlliste anbieten, dürfen die Werte in `Value` **nicht nur aus Ziffern** bestehen. Ein Eintrag `01` wird von Paymorrow abgelehnt. Welche Werte erwartet werden, erfahren Sie bei Paymorrow.

Felder, die im Einzelfall nicht gebraucht werden, beispielsweise die Registernummer bei einer Einzelfirma, blenden Sie über den Abschnitt `<AddressFields-InputVisibility>` aus.

Referenz: [Abschnitt Paymorrow-Mapping](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/zahlungsarten.md) · [Abschnitt PaymorrowDebit-Mapping](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/zahlungsarten.md) · Wegweiser: Prüfungen von Adressdaten festlegen

### Eigene Meldungen je Antwort

Paymorrow antwortet nicht nur mit Ja oder Nein, sondern mit einer Kombination aus mehreren Angaben. Darauf lassen sich eigene Texte legen, damit der Käufer erfährt, woran es lag.

| Zahlungsart | Meldungsabschnitt |
| - | - |
| Rechnung mit Paymorrow | `<[Paymorrow-NotifyMessages](/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/zahlungsarten)>` |
| Lastschrift mit Paymorrow | `<PaymorrowDebit-NotifyMessages>` |

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<Paymorrow-NotifyMessages>
   <+Entry>
      responseStatus = OK
      customerStatus = DECLINED
      declineFinal   = Y
      Message        = Diese Zahlungsart steht für Ihre Bestellung nicht zur Verfügung. Bitte wählen Sie eine andere.
   </+Entry>

   <+Entry>
      responseStatus = OK
      customerStatus = DECLINED
      declineFinal   = N
      declineType    = INVALID_ADDRESS
      Message        = Bitte prüfen Sie Ihre Adressangaben.
   </+Entry>
</Paymorrow-NotifyMessages>
```

`declineFinal = N` bedeutet, dass der Käufer es nach einer Korrektur erneut versuchen kann. Bei `Y` ist die Entscheidung endgültig, und ein Hinweis auf die Adresse wäre irreführend.

Materialien: Beispiel-Konfiguration für Fehlermeldungen

## Schritt 9: Testen

Beide Zahlungsarten setzen `TestMode = yes` in ihrem Abschnitt voraus. Der Aufruf unterscheidet sich.

**Rechnung mit Paymorrow**

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
https://www.ihre-shop-url.de/?test=on&payment-test=on
```

**Lastschrift mit Paymorrow** braucht zusätzlich den eigenen Parameter:

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
https://www.ihre-shop-url.de/?test=on&payment-test=on&debitaccount-test=on
```

Im Template lässt sich der jeweilige Testbetrieb anzeigen:

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{ST-PaymentTest}<p class="hinweis">Zahlungsarten-Testmodus aktiv</p>{/ST-PaymentTest}
{ST-DebitAccountTest}<p class="hinweis">Lastschrift-Testmodus aktiv</p>{/ST-DebitAccountTest}
```

> [!WARNING]
>
> Für den Testbetrieb richtet WEBSALE eine eigene Konfiguration ein. Das geschieht zusammen mit der Freischaltung. Melden Sie sich nach den Tests wieder bei Ihrem WEBSALE-Ansprechpartner, damit auf den Produktivbetrieb umgestellt wird. Ohne diesen Schritt bleibt die Anbindung im Testbetrieb, auch wenn Sie `TestMode` auf `no` setzen.

Wegweiser: [Testmodi des Shops ein- und ausschalten](https://dokumentation.websale.de/v8s/domains/testmodi-des-shops-ein-ausschalten.md)

## Schritt 10: Bisherige Lastschrift abschalten

Dieser Schritt betrifft nur die Lastschrift. Haben Sie sie bisher direkt angeboten, darf die alte Konfiguration nicht daneben stehen bleiben, denn beide belegen denselben Abschnitt.

Setzen Sie den bisherigen Abschnitt zunächst auf `Allow = no` und löschen Sie ihn, sobald die Umstellung steht.

## Bestelldaten

| Zahlungsart | Wo die Daten stehen |
| - | - |
| Rechnung mit Paymorrow | im eigenen Abschnitt `<PayMorrow>` |
| Lastschrift mit Paymorrow | im Abschnitt `<PaymorrowClearingData>` innerhalb von `<DebitNote>` |

Die Feldbeschreibungen stehen in der Dokumentation der Bestelldaten-Schnittstelle.

## Verwandte Themen

* Wegweiser: [Zahlungsarten anlegen, für die allgemeinen Parameter und die ausgegraute Anzeige](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/zahlungsarten-anlegen.md)
* Wegweiser: [Lastschrift, für das SEPA-Verfahren als Voraussetzung](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/lastschrift.md)
* Wegweiser: [AGB akzeptieren](https://dokumentation.websale.de/v8s/bestelluebersicht-bestelleingangsbestaetigung/agb-akzeptieren.md)
* Wegweiser: [Klarna Payments, für einen weiteren Anbieter mit Rechnungskauf](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/klarna-payments.md)


## Related topics

- [PAYMORROW- (Paymorrow)](https://dokumentation.websale.de/v8s/referenz/tags/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.