PayPal PLUS ist eine optimierte Kaufabwicklung für Händler. PayPal PLUS kombiniert drei Zahlungsmethoden in einer Zahlungslösung: PayPal, Lastschrift und Kreditkarte.

Mit PayPal PLUS können Käufer selbst dann bei Ihnen bestellen, wenn sie kein PayPal-Konto haben.

Inhalt

Funktionsweise

Integration

Funktionsweise

Im Bestellprozess werden dem Käufer unter "PayPal PLUS" mehrere Zahlungsmethoden angeboten. Er kann sich, auch ohne im Besitz eines PayPal-Kontos zu sein, für eine der angezeigten Zahlungsarten entscheiden und wird nach Klick auf "Bestellung absenden" zu PayPal geleitet. Dort gibt er die nötigen Daten ein (je nach Zahlungsart, bei Auswahl SEPA z. B. seine IBAN). Danach kommt er zurück in den Shop und die Bestellung wird sofort ausgeführt.

Integration

Voraussetzungen

Um die Zahlungsart "PayPal PLUS" in Ihrem Shop anzubieten, muss ein Geschäftskonto bei PayPal eröffnet worden sein. Bitte wenden Sie sich diesbezüglich direkt an PayPal.

Schritt 1: Freischaltung/Aktivierung

Die Zahlungsart "PayPal PLUS" muss bei WEBSALE freigeschaltet werden. Bitte wenden Sie sich hierzu an Ihren WEBSALE Ansprechpartner.

Schritt 2: Konfiguration im Online-Servicebereich vornehmen

Einen Teil der Konfiguration von PayPal PLUS nehmen Sie direkt im Online-Servicebereich vor. Dort steht Ihnen nach Beauftragung der Zahlungsart ein separater Dienst ("Paypal PLUS Manager") zur Verfügung. Mit diesem Dienst können Sie Ihr PayPal-Geschäftskonto mit WEBSALE verknüpfen und Einstellungen (Shop-Logo, angezeigter Firmenname im PayPal-Zahlungsprozess etc.) vornehmen.

Schritt 3: Zahlungsart in der Shopkonfiguration shop.config ergänzen

Fügen Sie der Shopkonfiguration shop.config den neuen Abschnitt <PaymentPayPalPlus-Txt> mit den folgenden Parametern hinzu.

Die "ExperienceProfileID" haben Sie bei Schritt 2 im Online-Servicebereich angelegt. Bitte tragen Sie diese beim Parameter ExperienceProfileID ein.

<PaymentPayPalPlus-Txt>
   Allow                = yes
   TestMode             = yes
   Name                 = PayPal PLUS
   NameSuffix           = Schnell und sicher online bezahlen.
   ImgOnClick           = selectPaymentImage('~ID~');
   RadioOnClick         = selectPayment('~ID~');
   Img                  = <logo-XYZ.png>
   DelivererID-List     = <Ihre Versandarten-IDs>
   ...
   PassBasketToPayPal-DummyAddition     = Zusatzkosten
   PassBasketToPayPal-DummyReduction    = abzüglich gewährter Rabatte
   PaypalDenyPendingPayments-Allow      = no
   ExperienceProfileID                  = XXX
   ...
</PaymentPayPalPlus-Txt>

Referenz: Abschnitt PaymentPayPalPlus-Txt

Die für alle Zahlungsarten möglichen Standard-Parameter finden Sie unter:

Referenz: Abschnitt PaymentXXX-Txt

Schritt 4: Hinweismeldungen definieren

Legen Sie Hinweismeldungen fest, um Ihre Kunden bei Fehlern im Bezahlvorgang zu informieren.

Definieren Sie in der Shopkonfiguration shop.config im Abschnitt <NotifyMessages-Txt> folgende Hinweismeldungen:

<NotifyMessages-Txt>
   ...
   PayPalPlus-ClearingCancel   = Sie haben den Bezahlvorgang mit PayPal PLUS abgebrochen.
   PayPalPlus-ClearingError    = Der Bezahlvorgang mit PayPal PLUS wurde abgelehnt oder abgebrochen.
n  ...
</NotifyMessages-Txt>

Referenz: Abschnitt NotifyMessages-Txt

Schritt 5: Neues Template anlegen

Legen Sie ein neues Template an, z. B. ws_paypalplus_docheckout.htm und speichern Sie es in Ihrem Template-Verzeichnis, z. B. benutzer/templates/translation.

Ergänzen Sie in Ihrer Shopkonfiguration shop.config im Abschnitt <Templates> den Parameter PayPalPlusDoCheckout und tragen Sie den Namen des eben angelegten Templates ein:

<Templates>
   ...
   PayPalPlusDoCheckout =  ws_paypalplus_docheckout.htm  
   ...
</Templates>

Referenz: Abschnitt Templates

Fügen Sie auf diesem Template den folgenden Code ein, um die automatische Weiterleitung zu PayPal PLUS zu realisieren:

<script src="https://www.paypalobjects.com/webstatic/ppplus/ppplus.min.js" type="text/javascript"></script>
<script type="text/javascript">
   PAYPAL.apps.PPP.doCheckout();
</script>

 

Schritt 6: Zahlungs- und Versandarten-Seite (ws_pay_deliv.htm) ergänzen

Fügen Sie am Ende der Zahlungs- und Versandarten-Seite (ws_pay_deliv.htm) folgenden Code ein:

...
{PPP-ShowPayPalMethodsAtPayDeliv}
   <script src="https://www.paypalobjects.com/webstatic/ppplus/ppplus.min.js" type="text/javascript"></script>
   <script type="application/javascript">
      let ppPlusId = 31;
      let ppPlusElement;
      let ppFirstTime = true;
      ppPlusElement = document.querySelector("#ws_paymentdiv_inputelement_" + ppPlusId);
 
      var ppp = PAYPAL.apps.PPP({
         "approvalUrl": "~PPP-ApprovalURL~",
         "placeholder": "~PPP-PayPalMethodsDivContainerID~",
         "country": "~PPP-CountryCode~",
         "language": "de_DE",
         "useraction": "commit",
         "showPuiOnSandbox": "true",
         {!ST-Payment(31)}"preselection": "none",{/!ST-Payment(31)}
         "buttonLocation": "outside",
         "enableContinue": function(){
            if (ppPlusElement.attributes.checked == undefined) {
               if (ppFirstTime) {
                  ppp.deselectPaymentMethod();
                  ppFirstTime = false;
               } else {
                  ppPlusElement.click();
               }
            }
         },
         "disableContinue": function(){
            //move to default payment
         }
      });
   </script>
{/PPP-ShowPayPalMethodsAtPayDeliv}

 

Referenz: PPP-ShowPayPalMethodsAtPayDeliv

Referenz: PPP-ApprovalURL

Referenz: PPP-PayPalMethodsDivContainerID

Referenz: PPP-CountryCode

Referenz: DC-FPX_set

Referenz: DC-FPX_contains

Schritt 7: Bestellübersichtsseite (ws_place_order.htm) anpassen

Fügen Sie auf der Bestellübersichtsseite (ws_place_order.htm) folgenden Code dort ein, wo die Zahlungsartenauswahl von PayPal im Falle von FastOrder (Schnellbestellung) einmalig angezeigt werden muss.

Die Auswahl der Zahlungsart bei PayPal Plus wird im angegebenen DIV-Container geladen/angezeigt.

 

...
{PPP-ShowPayPalMethodsAtPlaceOrder}
   <script src="https://www.paypalobjects.com/webstatic/ppplus/ppplus.min.js" type="text/javascript"></script>
   <div id="~PPP-PayPalMethodsDivContainerID~"></div>
   <script type="application/javascript">
      var ppp = PAYPAL.apps.PPP({
         "approvalUrl": "~PPP-ApprovalURL~",
         "placeholder": "~PPP-PayPalMethodsDivContainerID~",
         "country": "~PPP-CountryCode~",
         "buttonLocation": "outside"
      });
   </script>
{/PPP-ShowPayPalMethodsAtPlaceOrder}
...

Referenz: PPP-ShowPayPalMethodsAtPayOrder

Referenz: PPP-PayPalMethodsDivContainerID

Referenz: PPP-ApprovalURL

Referenz: PPP-CountryCode

Referenz: DC-FPX_set()

Referenz: DC-FPX_contains()

Schritt 8: Daten von PayPal PLUS in JSON-Schnittstelle laden (optional)

Um die Daten von PayPal PLUS in die JSON-Schnittstelle zu laden, fügen Sie auf der HTML-Bestelleingangsbestätigungsseite (ws_confirm.htm) folgenden Code ein:

...
~EJD-SetRawDataHexCodedInput($PPP-ResponseJSONHexCoded$)~
~EJD-LoadData(intern,rawdatahexcodedinput,ppp)~
...

Wegweiser: JSON-Schnittstelle

Referenz: EJD-SetRawDataHexCodedInput

Referenz: EJD-LoadData()

Schritt 9: Bankverbindung des Händlers anzeigen (optional)

Wenn Sie mit PayPal PLUS die Zahlungsart Rechnung anbieten, fügen Sie auf der HTML-Bestelleingangsbestätigungsseite (ws_confirm.htm) folgenden Code ein, um die Bankverbindung des Händlers anzuzeigen:

...
   {ST-Payment(31)}
      {PPP-ResponseJSONHexCoded}
         ~EJD-SetRawDataHexCodedInput($PPP-ResponseJSONHexCoded$)~
         ~EJD-LoadData(intern,rawdatahexcodedinput,paypalplus)~
         {EJD-DataOK(paypalplus)}
            ~EJD-SetUseID(paypalplus)~
            {EJD-DA-NameExists(payment_instruction.recipient_banking_instruction)}
               ~EJD-DA-TouchValue(payment_instruction.instruction_type)~
               ~DC-FPpp_set($EJD-LastValueAccessed$)~
               {DC-FPpp(PAY_UPON_INVOICE)}
                  Zahlungsinformationen:
                  Bitte überweisen Sie bis zum ~EJD-DA-Value(payment_instruction.payment_due_date)~ den Betrag von
                  ~EJD-DA-Value(payment_instruction.amount.value)~ ~EJD-DA-Value(payment_instruction.amount.currency)~
                  mit Verwendungszweck ~EJD-DA-Value(payment_instruction.reference_number)~ auf folgendes Konto:
                  ~EJD-DA-Value(payment_instruction.recipient_banking_instruction.bank_name)~
                  ~EJD-DA-Value(payment_instruction.recipient_banking_instruction.account_holder_name)~
                  ~EJD-DA-Value(payment_instruction.recipient_banking_instruction.international_bank_account_number)~
                  ~EJD-DA-Value(payment_instruction.recipient_banking_instruction.bank_identifier_code)~   
               {/DC-FPpp(PAY_UPON_INVOICE)}
            {/EJD-DA-NameExists(payment_instruction.recipient_banking_instruction)}
         {/EJD-DataOK(paypalplus)}
      {/PPP-ResponseJSONHexCoded}
   {/ST-Payment(31)}
...

Wegweiser: JSON-Schnittstelle

Referenz: EJD-Tags

Referenz: PPP-ResponseJSONHexCoded

 

Schritt 10: WEBSALE informieren für technische Aktivierung

Bitte wenden Sie sich nun an Ihren WEBSALE Ansprechpartner und beauftragen Sie ihn, die technische Aktivierung der Zahlungsart PayPal PLUS für Ihren Shop zu veranlassen. Teilen Sie für jeden Subshop die zu verwendende ID mit, die Sie im Online-Servicebereich jeweils angelegt haben.

Schritt 11: Zahlungsart testen

Um PayPal PLUS in Ihrem Shop zu testen, stellt Ihnen WEBSALE einen Zahlungsarten-Testmodus zur Verfügung. Die Zahlungsart PayPal PLUS ist nur in diesem Testmodus sichtbar; der Produktivbetrieb Ihres Shops wird dadurch nicht beeinflusst.

Der Shop muss sich bereits im allgemeinen Testmodus befinden (Parameter ?test=on). Hängen Sie jetzt zum Aktivieren des Zahlungsarten-Testmodus an einen beliebigen Shop-Aufruf die beiden Parameter &payment-test=on und &paypalplusaccount-test=on an.

Aktivieren des Testmodus:

http://www.xyz.de/?test=on&payment-test=on&paypalplusaccount-test=on

Im Template kann hierbei durch das Tag ST-PaymentTest ein Hinweis angezeigt werden, wenn der Shop im Zahlungsarten-Testmodus aufgerufen wurde:

{ST-PaymentTest}
   Zahlungsarten-Testmodus an
{/ST-PaymentTest}

Referenz: ST-PaymentTest

Hängen Sie nach erfolgreich abgeschlossenem Test zum Deaktivieren des Zahlungsarten-Testmodus an einen beliebigen Shop-Aufruf die Parameter ?test=off, &payment-test=off und &paypalplusaccount-test=off an.

Deaktivieren des Testmodus:

http://www.xyz.de/?test=off&payment-test=off&paypalplusaccount-test=off

Wegweiser: Testmodi des Shops ein-/ausschalten

Schritt 12: Zahlungsart PayPal PLUS für den Produktivbetrieb aktivieren

Setzen Sie im Abschnitt <PaymentPayPalPlus-Txt> der Shopkonfiguration shop.config den Parameter TestMode auf no und achten Sie darauf, dass der Parameter Allow auf yes steht:

<PaymentPayPalPlus-Txt>
   Allow                        = yes
   TestMode                     = no
   ...
</PaymentPayPalPlus-Txt>

Referenz: Abschnitt PaymentPayPalPlus-Txt

 

Haben Sie alle Schritte durchgeführt, ist die Zahlungsart "PayPal PLUS" vollständig integriert.