Paymorrow - WEBSALE Dokumentation

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.

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

Der Käufer wählt die Zahlungsart und ergänzt die fehlenden Angaben.
Nach dem Absenden der Bestellung prüft Paymorrow Anschrift und Bonität über Auskunfteien.
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.
Bei Ablehnung landet er zurück auf der Zahlungs- und Versandartenseite mit einem Hinweis und der Bitte, eine andere Zahlungsart zu wählen.

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

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

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.

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

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 · Abschnitt PaymentDebitNote-Txt · Abschnitt PaymentXXX-Txt

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.

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

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

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

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

Der Filter greift nur, wenn das Feld SalutationCode im Abschnitt <AddressFields-Txt> aktiviert ist.

Referenz: Abschnitt AddressFilter · Konfiguration salutation.dat

Schritt 5: Hinweismeldungen hinterlegen

Der Name der Fehlermeldung unterscheidet sich zwischen den beiden Zahlungsarten.

<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

Schritt 6: AGB-Zustimmung umplatzieren

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

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.

{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

Schritt 8: Firmendaten abfragen (optional)

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

Erweiterten Modus einschalten

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

<Paymorrow-Mapping>
   LegalForm          = Suffix25
   Owner              = Suffix26
   RegistrationNumber = Suffix27
</Paymorrow-Mapping>

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

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 · Abschnitt PaymorrowDebit-Mapping · 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>`

<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

https://www.ihre-shop-url.de/?test=on&payment-test=on

Lastschrift mit Paymorrow braucht zusätzlich den eigenen Parameter:

https://www.ihre-shop-url.de/?test=on&payment-test=on&debitaccount-test=on

Im Template lässt sich der jeweilige Testbetrieb anzeigen:

{ST-PaymentTest}<p class="hinweis">Zahlungsarten-Testmodus aktiv</p>{/ST-PaymentTest}
{ST-DebitAccountTest}<p class="hinweis">Lastschrift-Testmodus aktiv</p>{/ST-DebitAccountTest}

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

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.

​Was Paymorrow verlangt

​Wie der Bezahlvorgang abläuft

​Abweichende Lieferadressen

​Schritt 1: Vertrag und Freischaltung

​Schritt 2: Zahlungsart anlegen

​Schritt 3: Telefonnummer und Geburtsdatum abfragen

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

​Schritt 5: Hinweismeldungen hinterlegen

​Schritt 6: AGB-Zustimmung umplatzieren

​Schritt 7: Kontodaten anzeigen (nur Rechnungskauf)

​Schritt 8: Firmendaten abfragen (optional)

​Erweiterten Modus einschalten

​Felder anlegen und zuordnen

​Eigene Meldungen je Antwort

​Schritt 9: Testen

​Schritt 10: Bisherige Lastschrift abschalten

​Bestelldaten

​Verwandte Themen

Was Paymorrow verlangt

Wie der Bezahlvorgang abläuft

Abweichende Lieferadressen

Schritt 1: Vertrag und Freischaltung

Schritt 2: Zahlungsart anlegen

Schritt 3: Telefonnummer und Geburtsdatum abfragen

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

Schritt 5: Hinweismeldungen hinterlegen

Schritt 6: AGB-Zustimmung umplatzieren

Schritt 7: Kontodaten anzeigen (nur Rechnungskauf)

Schritt 8: Firmendaten abfragen (optional)

Erweiterten Modus einschalten

Felder anlegen und zuordnen

Eigene Meldungen je Antwort

Schritt 9: Testen

Schritt 10: Bisherige Lastschrift abschalten

Bestelldaten

Verwandte Themen