PaymentPaypal-Txt
In diesem Abschnitt der Konfiguration "shop.config" konfigurieren Sie die Zahlungsart "PayPal".
Wegweiser: PayPal
Die für alle Zahlungsarten möglichen Standard-Parameter finden Sie unter
Referenz: Abschnitte PaymentXXX-Txt
<PaymentPayPal-Txt>
...
CapturingMode =
CompuTopTxType =
ExpressCheckout-Allow =
ExpressCheckoutMaxAmountAddition =
ExpressCheckoutNoShipping =
InstantPaymentOnly-Allow =
LanguageCode =
PassBasketToPayPal-DummyAddition =
PassBasketToPayPal-DummyReduction =
PassBasketToPayPal-ModeExpressCheckout =
PassBasketToPayPal-ModeBasisCheckout =
PassToPaypalAsCustomParameter =
PayPalBrandName =
PayPalCartBorderColor =
PaypalDenyPendingPayments-Allow =
PayPalLogoImg =
PaypalPaymentAction =
PaypalSendUserActionCommitToPayPal-Allow =
...
</PaymentPayPal-Txt>
Je nach Integration sind nicht alle der oben aufgelisteten Parameter nötig. Auskunft darüber, welche Parameter für Ihre Integration der Zahlungsart "PayPal" unterstützt werden bzw. notwendig sind, erhalten Sie in der nachfolgenden Tabelle.
Parameter |
Zweck |
Werte |
CapturingMode |
Bei PayPal via Computop: auto: Zahlung sofort abgebucht manual: Zahlung wird nur reserviert (nähere Definition mittels CompuTopTxType)
|
auto manual Std.: auto |
CompuTopTxType |
Bei PayPal via Computop, wenn CapturingMode = manual: order: Bestellung wird generiert bzw. der Versand vorbereitet. Sie erhalten die Zahlung jedoch nicht automatisch. authorization: PayPal genehmigt eine spätere Zahlung. Bevor Sie die Zahlung erhalten, sind Sie jedoch verpflichtet, die Bestellung an den Kunden auszuliefern.
|
order authorization Std.: order |
ExpressCheckout-Allow |
PayPal Express Checkout aktivieren
|
yes no Std.: no |
ExpressCheckoutMaxAmountAddition |
Maximaler Aufschlag auf die Zwischensumme. Bei einem Kauf mit PayPal Express wird nur die Zwischensumme des Warenkorbs an PayPal übergeben. Erst danach wählt der Kunde Versandart, Zusatzleistungen wie "klimaneutrale Produktion" etc. aus, wodurch sich die Gesamtsumme noch erhöhen kann. Wenn im Shop zusätzliche Kosten entstehen können, welche nicht automatisch berücksichtigt werden, muss der Shopbetreiber hier einen bestimmten Betrag angeben. Um diesen Betrag muss das PayPal-Konto des Kunden zusätzlich zur Zwischensumme "gedeckt" sein, um die Bestellung abschließen zu können. Der angegebene Betrag sollte die Summe der höchsten Beträge sein (wenn möglich/bekannt). Relevant hierfür sind händlerabhängige/produktabhängige Versandkosten und alle anderen zusätzlichen Kosten. Versand-/Zahlungskosten, TrustedShops und OrderOptions werden automatisch berücksichtigt.
|
Betrag (Punkt als Dezimaltrenner) |
ExpressCheckoutNoShipping |
0 – PayPal zeigt die Lieferadresse auf den PayPal-Seiten an. 1 – PayPal zeigt keinerlei Lieferadress-Felder an. 2 – Gibt der Kunde keine Lieferadresse an, übernimmt PayPal diese direkt aus dem Kundenkonto des Shops.
|
0 1 2 |
InstantPaymentOnly-Allow |
Ausschließlich Zahlungsmethoden mit sofortiger Abbuchung (z. B. Kreditkarte) bei der Zahlungsart-Auswahl bei PayPal verwenden (yes/no).
|
yes no Std.: yes |
LanguageCode |
zwei- oder fünfstelliger Code nach PayPal-Vorgabe für die PayPal-Zahlungsseite (optional)
|
z. B. Deutschland de_DE, Niederlande nl_NL, Frankreich fr_FR, Großbritannien en_GB, USA en_US, Spanien es_ES (vollständige Tabelle siehe https://developer.paypal.com/api/rest/reference/locale-codes/) |
PaypalPaymentAction |
Zeitpunkt/Art des Zahlungseinzugs sale: Die Zahlung wird sofort abgebucht authorization: Die Zahlung wird lediglich autorisiert. Dabei prüft PayPal die Bonität des Käufers. Autorisierungen sind maximal 29 Tage gültig. In diesem Zeitraum kann ein Teil- oder Gesamtbetrag eingezogen oder die Autorisierung storniert werden. order: Der Nutzer erteilt eine Zustimmung, dass innerhalb eines gesetzten Zeitraums eine Zahlung angestoßen werden kann. Es wird seitens PayPal kein Check der Verfügbarkeit von Mitteln angestoßen. Auf diese Order können Sie dann eine Autorisierung anlegen und das Geld einziehen. Orders lassen sich länger als 29 Tage offen halten. Sie können bei PayPal beantragen, die Gültigkeitsdauer der Order zu erhöhen.
Hinweis: Bei order und authorization muss InstantPaymentOnly-Allow = no gesetzt sein!
|
sale authorization order Std: sale |
PassBasketToPayPal-ModeExpressCheckout |
Übergabe des Warenkorbs an PayPal (bei PayPal Express Checkout) AllEntriesAsSingleLineItem-TotalSum: gesamte Bestellung wird als eine Position übergeben OneEntryPerLineItem-SubTotalSum: ein Eintrag pro Position im Warenkorb ohne eventuellen Auf-/Abschlag OneEntryPerLineItemWithDummies-TotalSum: ein Eintrag pro Position im Warenkorb plus eventuellen Auf-/Abschlag Hinweis: Wird autom. auf AllEntriesAsSingleLineItem-TotalSum gestellt, wenn PassBasketToPayPal-DummyAddition und/oder PassBasketToPayPal-DummyReduction leer sind.
|
AllEntriesAsSingleLineItem-TotalSum OneEntryPerLineItem-SubTotalSum OneEntryPerLineItemWithDummies-TotalSum Std: AllEntriesAsSingleLineItem-TotalSum |
PassBasketToPayPal-ModeBasisCheckout |
Übergabe des Warenkorbs an PayPal (bei Anbindung "PayPal als Zahlungsart") AllEntriesAsSingleLineItem-TotalSum: gesamte Bestellung wird als eine Position übergeben OneEntryPerLineItemWithDummies-TotalSum: ein Eintrag pro Position im Warenkorb plus eventuellen Auf-/Abschlag Hinweis: Wird autom. auf AllEntriesAsSingleLineItem-TotalSum gestellt, wenn PassBasketToPayPal-DummyAddition und/oder PassBasketToPayPal-DummyReduction leer sind.
|
AllEntriesAsSingleLineItem-TotalSum OneEntryPerLineItemWithDummies-TotalSum Std: AllEntriesAsSingleLineItem-TotalSum |
PassBasketToPayPal-DummyAddition |
"Dummyprodukt" für sonstige Kosten Das "Dummyprodukt" wird als Warenkorbposition an PayPal übergeben, wenn die Gesamtsumme in PayPal nicht mit der Gesamtsumme im WEBSALE Shop übereinstimmt (z. B. aufgrund von Kosten durch "klimaneutrale Produktion").
|
Produktname, z. B. sonstige Kosten |
PassBasketToPayPal-DummyReduction |
"Dummyprodukt" für sonstige Abschläge/Rabatte Das "Dummyprodukt" wird als Warenkorbposition an PayPal übergeben, wenn die Gesamtsumme in PayPal nicht mit der Gesamtsumme im WEBSALE Shop übereinstimmt (z. B. aufgrund von Rabatten).
|
Produktname, z. B. Rabatte/Abzüge |
PassToPaypalAsCustomParameter |
Optional: Beliebiger Text (inklusive WEBSALE-Tags) der im Feld CUSTOM an PayPal übergeben und dort zur Suche in den Transaktionen verwendet werden kann. Hinweis: Es PayPal unterstützt hier maximal 256 alphanumerische Zeichen. Alle anderen Zeichen werden nicht an PayPal übergeben (Leerzeichen, Umlaute, Sonderzeichen, etc...)
|
beliebiger Text/WEBSALE-Tags, z. B. ~A-Number~ |
PayPalLogoImg |
Optional: Shop- oder Firmen-Logo, das auf der PayPal-Checkout-Seite angezeigt wird. Die vorgegebene Größe des Logo-Bilds ist 190x60 px. Der Dateityp (JPEG, GIF, PNG) ist nicht vorgegeben. Wird kein Logo definiert, wird der unter PayPalBrandName definierte Firmenname angezeigt oder, falls dort nicht eingetragen, die im PayPal-Account hinterlegte Firmenbezeichnung.
|
Pfad https://... |
PayPalCartBorderColor |
Optional: HTML-Farbcode für die PayPal-Seite (Rahmen)
|
Hexadezimal-Wert, z. B. 4A3BB1 |
PayPalBrandName |
Optional: Firmenname, der auf der PayPal-Seite angezeigt werden soll. Die Anzeige erfolgt z. B. im Link "Abbrechen und zurück zu....". Wird kein Logo definiert (Parameter PayPalLogoImg), wird der angegebene Firmenname auch als Überschrift auf der PayPal-Checkout-Seite verwendet. Wird kein PayPalBrandName definiert, wird der im PayPal-Account hinterlegte Firmenname verwendet.
|
freie Eingabe (max. 127 Zeichen) |
PaypalDenyPendingPayments-Allow |
Vorgehensweise beim "schwebenden" (pending) Status der Zahlung. yes: Abbruch der Transaktion, Bestellung wird nicht generiert. no: Transaktion wird akzeptiert, Bestellung wird generiert.
|
yes no Std.: no |
PaypalSendUserActionCommitToPayPal-Allow |
Nur für PayPal Direktanbindung (nicht für PayPalCheckout, nicht für PayPal via CompuTop, nicht für Express-Checkout):
Bei yes wird PayPal signalisiert, dass bei Rückkehr in den Shop die Bestellung abgeschlossen wird und nicht mehr änderbar ist. Somit wird auf der PayPal-Seite stets der Button "Bestellung abschließen" angezeigt. |
yes no Std.: no |