In diesen Unterabschnitten der Konfiguration "shop.config" konfigurieren Sie Zusatzinformationen zu einer Zahlungsart. Der Abschnitt +CountryRule kann bis zu 10 mal innerhalb eines Abschnitts <PaymentXXX-Txt> angelegt werden. Die Reihenfolge der einzelnen +CountryRule-Abschnitte bestimmt die Reihenfolge im Shop.


Hinweis:

Wenn Sie zusätzliche Informationen zur Zahlungsart abfragen, achten Sie darauf, dass im Abschnitt NotifyMessages-Txt die Fehlermeldung PaymentInputSuffix hinterlegt ist.
Referenz: Abschnitt NotifyMessages-Txt

Folgende Einstellungen werden bei einer Zusatzinformation unterstützt:

<PaymentXXX-Txt>
   ...
   <+CountryRule>
      CountryList-ISO             =
      FieldDescr-Txt              =
      HideInReadableOrder-Allow   =
      ID                          =
      MaxLength                   =
      Required                    =
      RequiredErrorMessage-Txt    =
      SaveInputForNextOrder-Allow =
      Type                        =
      UseAddressInput             =
      UserDependency              =
 
      <+listentry>
         Entry-Txt             =
         ID                    =
      </+listentry>
      ...
   </+CountryRule>
</PaymentXXX-Txt>

Referenz: Abschnitte PaymentXXX-Txt

Wegweiser: Zusatzinformationen zur Zahlungsart abfragen

 

Parameter

Zweck

Werte

CountryList-ISO

Liste mit 3-stelligen ISO-Ländercodes, für die diese Zusatzinformation abgefragt werden soll. Wenn diese Zusatzinformation unabhängig vom gewählten Land abgefragt werden soll, muss als Wert * angegeben werden.

Hinweise: Ob der ISO-Code der gewählten Rechnungs- oder Lieferadresse verwendet werden soll, wird über den Parameter UseAddressInput konfiguriert!

Eine Zusatzinformation wird nur dann abgefragt, wenn der Käufer eines der hier angegebenen Länder ausgewählt hat (UseAddressInput).

Eine Zusatzinformation wird nur dann abgefragt, wenn alle Abhängigkeiten zu anderen Eingaben der Adressdaten erfüllt sind (UserDependency).

Kommaseparierte Liste an 3-stelligen ISO-Ländercodes oder
* für jedes beliebige Land

FieldDescr-Txt

Zusatzinformation

Dieser Text wird vor dem Eingabefeld bzw. der/den Auswahllisten angezeigt.

Wenn die Zusatzinformationen im lesbaren Teil der Bestellung ausgegeben werden, wird dieser Text dort verwendet.

Text, maximale Länge: 4096 Zeichen

HideInReadableOrder-Allow

Über diesen Parameter wird festgelegt, ob die eingegebene Zusatzinformation im lesbaren Teil der Bestellung ausgegeben werden soll oder nicht.

no (Die Eingabe wird im lesbaren Teil der Bestellung ausgegeben)

yes (Die Eingabe wird im lesbaren Teil der Bestellung nicht ausgegeben)

Standard: no

ID

Technische ID der Zusatzinformation.

Achtung: Dieser Parameter sollte stets angegeben werden.

Hinweis: Alle IDs mit dem Präfix ws_ sind reserviert. Zusatzinformationen mit diesen IDs werden speziell verwendet, z. B. für Bonitäts- oder Clearingverfahren. Eine Liste mit allen vordefinierten IDs finden Sie weiter unten im Absatz "Speziell behandelte IDs".

Hinweis: Es werden maximal 64 Zeichen unterstützt.

 

MaxLength

Die maximale Länge der Eingabe

Hinweis: Es werden maximal 128 Zeichen unterstützt

 

Required

Legt fest, ob die Zusatzinformation ein Pflichtfeld ist.

yes
no

Standard: no

RequiredErrorMessage-Txt

Die Fehlermeldung wird bei dem Eingabefeld bzw. der/den Auswahllisten angezeigt, wenn die Zusatzinformation ein Pflichtfeld ist und der Käufer keine Angabe gemacht hat.

 

SaveInputForNextOrder-Allow

Normalerweise werden die Eingaben der CountryRules (wenn der Käufer angemeldet ist) der letzten verwendeten Zahlungsart mit im Kundenkonto abgespeichert.

Dadurch kann, auch wenn bei einer Zahlungsart Zusatzeingaben notwendig sind, die Fast-Order-Funktion für die nächste Bestellung verwendet werden.

Wenn nun z. B. ein Clearer allerdings möchte, dass z. B. die Checkbox zur Akzeptanz der Datenverarbeitung oder die Akzeptanz zu einer erneuten Bonitätsprüfung explizit erneut gegeben/angehakt werden muss, so kann die Speicherung für diese Felder durch diesen Schalter deaktiviert werden.

yes

(Eingaben der CountryRules werden gespeichert)
no

(Eingaben müssen bei jeder Bestellung erneut angegeben werden)

 

Standard: yes

Type

Hier können Sie die Eingabeart der Zusatzinformation festlegen.

Hinweis: Die Einträge der Auswahlliste listbox werden durch die Abschnitte <+listentry> festgelegt.

Achtung: Wenn als Type dateofbirth angegeben ist, wird hier das Feld "Geburtstag" wie auf der Seite zur Eingabe der Rechnungsadresse angeboten. Als Parameter UseAddressInput wird in diesem Fall immer customer verwendet! Diese Eingabe wird auch bei den Kundendaten gespeichert!

Jeder Type besitzt eine technische ID:
0 = listbox
1 = input
2 = DateOfBirth
3 = checkbox

input
(Es wird ein einzeiliges Eingabefeld zur Eingabe der Zusatzinformation angeboten)

listbox
(Es wird eine Auswahlliste zur Eingabe der Zusatzinformation angeboten)

dateofbirth
(Es wird ein 3-teiliges Eingabefeld Geburtstag angeboten)

checkbox
(Es wird eine Checkbox zur Bestätigung  angezeigt)

Standard: input

UseAddressInput

Über diesen Parameter wird festgelegt, welches vom Käufer ausgewählte Land berücksichtigt wird, um festzustellen, ob die Zusatzinformation abgefragt wird oder nicht.

customer
(Land der Rechnungsadresse verwenden)

delivery
(wenn eine Lieferadresse gewählt wurde, Land der Lieferadresse, ansonsten Land der Rechnungsadresse verwenden)

onlydelivery
(Land der Lieferadresse verwenden. Die Zusatzinformation wird nicht abgefragt, wenn der Käufer keine abweichende Lieferadresse gewählt hat)

Standard: customer

UserDependency

Über diesen Parameter wird festgelegt, ob eine Zusatzinformation nur abgefragt werden soll, wenn der Käufer einen Firmennamen angegeben hat.

no
(Es besteht keine Abhängigkeit zu anderen Adressfeldern)

private
(die Zusatzinformation wird nur dann abgefragt, wenn der Käufer keinen Firmennamen angegeben hat)

company
(die Zusatzinformation wird nur dann abgefragt, wenn der Käufer einen Firmennamen angegeben hat)

Standard: no

<+listentry>

In diesem Abschnitt können Sie einen Eintrag der Auswahlliste vorgeben. Es sind bis zu 100 <+listentry>-Einträge möglich.

Hinweis: Diese Abschnitte werden nur benötigt, wenn Sie für den Parameter type den Wert listbox angeben.

 

Entry-Txt

Parameter in einem Abschnitt <+listentry>.

Textuelle Beschreibung des Eintrags. Dieser Wert wird ggf. in der lesbaren Bestellung ausgegeben, wenn der Käufer den Eintrag gewählt hat. Dem Käufer wird dieser Wert in der Auswahlliste angezeigt.
Der Eintrag kann maximal 128 Zeichen lang sein.

 

ID

Parameter in einem Abschnitt <+listentry>.

Technischer Wert des Eintrags. Dieser Wert wird in der technischen Bestellung ausgegeben, wenn der Käufer den Eintrag gewählt hat. Dem Käufer wird dieser Wert nicht angezeigt. Der Eintrag kann maximal 64 Zeichen lang sein.

Hinweis: Wenn Sie diesen Parameter bei einem Auswahllisten-Eintrag nicht angeben, können Sie die Auswahlmöglichkeit "Bitte wählen Sie" ohne technischen Wert realisieren.

Achtung: Dieser Wert wird an das entsprechende externe System übermittelt, wenn die Zusatzinformation für Zahlungs- oder Clearingverfahren verwendet wird.

 

Alle IDs mit dem Präfix ws_ sind reserviert. Zusatzinformationen mit diesen IDs werden speziell verwendet, z. B. für Bonitäts- oder Clearingverfahren. Je nach Verwendung werden bestimmte Einstellungen der Zusatzinformation automatisch gesetzt.

ID

Zweck

Automatische Einstellungen

ws_clearing_easycredit

Wird für die Checkbox der Zustimmung und Datenübermittlung beim easyCredit-Ratenkauf benötigt.

 

ws_clearing_computop_paypal_state

Die eingegebene Zusatzinformation wird bei der Zahlungsart PayPal als Parameter "State" an Computop übermittelt.

UseAddressInput = delivery

ws_clearing_computop_clickandbuy_customer_state

Die eingegebene Zusatzinformation wird bei der Zahlungsart ClickAndBuy als Parameter "State der Rechnungsadresse" an Computop übermittelt.

UseAddressInput = customer

ws_clearing_computop_clickandbuy_delivery_state

Die eingegebene Zusatzinformation wird bei der Zahlungsart ClickAndBuy als Parameter "State der Lieferadresse" an Computop übermittelt.

UseAddressInput = onlydelivery

ws_clearing_paymorrow_phone

Die eingegebene Zusatzinformation wird bei der Zahlungsart Paymorrow als Parameter "Phone" an Paymorrow übermittelt.

UseAddressInput = customer
CountryListISO = *
Required = yes

ws_clearing_paypal_state

Die eingegebene Zusatzinformation wird bei der Zahlungsart PayPal als Parameter "State" an PayPal übermittelt (Direktanbindung).

UseAddressInput = delivery

ws_clearing_ppc_invoice_phone

Die einzugebende Telefonnummer wird bei der Zahlungsart Kauf auf Rechnung (über RatePay/PayPal Checkout) benötigt.