Besonderheiten im Zahlungs-Plugin JTL PayPal Checkout¶
Template-Selectoren (JTL PayPal Checkout)¶
Nachfolgende Selectoren werden im "JTL PayPal Checkout"-Plugin verwendet. Bitte stellen Sie sicher, dass diese Selektoren im Template enthalten sind und die adäquaten Bereiche wie im NOVA-Template referenzieren, um eine korrekte Funktion des "JTL PayPal Checkout"-Plugins zu gewährleisten.
Selectoren in der: CheckoutPage.php (phpQuery)
*_phpqSelector#complete-order-buttonbody.checkout-payment-method.checkout-shipping-form#fieldset-payment#result-wrappermeta[itemprop="price"]
Selectoren in der: CheckoutPage.php (phpQuery)
#miniCart-ppc-paypal-standalone-button#cart-ppc-paypal-standalone-button#*-ppc-*-standalone-button#productDetails-ppc-paypal-standalone-button#cart-checkout-btn#add-to-cart button[name="inWarenkorb"]meta[itemprop="price"]#buy_form#complete-order-button#paypal-button-container#complete_order#comment#comment-hiddenform#complete_order.checkout-payment-method#za_ppc_*_inputinput[type=radio][name=Zahlungsart]#fieldset-payment .jtl-spinner
Debug-ID ermitteln bei Onboarding-Fehlern¶
Ggfs. kommt es vor, dass beim automatischen Onboarding Fehler mit nichtssagenden Meldungen ("Etwas ist schiefgelaufen") auftreten und das Onboarding dadurch nicht abgeschlossen werden kann. Der normale PayPal-Support kann in solchen Fällen meist nicht weiterhelfen und es müssen Tickets beim Tech-Support eröffnet werden, die eine PayPal-Debug-ID erfordern.
Nachfolgend wird beschrieben, wie Sie als Entwickler, Servicepartner oder technisch versierter Anwender diese ID ermitteln können.
Bevor Sie den Onboarding-Vorgang erneut starten, überprüfen Sie bitte die PayPal-Status-Seite auf aktuell offene Probleme. Gehen Sie dazu auf https://www.paypal-status.com/product/production und prüfen Sie diese auf aktuelle Einschränkungen. Prüfen Sie auch den JTL-Issue-Tracker unter https://issues.jtl-software.de/issues?project=shop&component=11101&type=bug&status=open auf offene Fehler für das JTL-PayPal-Plugin, die das Onboarding betreffen.
Wenn auf der PayPal-Status-Seite keine Probleme gelistet werden und auch keine diesbezgl. Fehler im JTL-IssueTracker zu finden sind, können Sie folgendermassen vorgehen:
- Starten Sie das PayPal-Onboarding im Plugin-Backend
- Aktivieren Sie die Entwickler-Tools des Browsers (Rechtsklick mit der Maus innerhalb des Minibrowser-Fensters und dann auf "Untersuchen" klicken)
- Führen Sie das Onboarding bis zu der Stelle aus, an der der Fehler angezeigt wird
- Klicken Sie in den Entwickler-Tools den Tab "Inspektor" (Firefox) bzw. "Elements" (Chrome) an
- Klicken Sie im angezeigten DOM-Baum auf das oberste Element (<html...) und starten Sie die Suche (Strg+F)
- Tippen Sie "debug" in die Sucheingabe und durchsuchen Sie den DOM-Baum nach einem (oder mehreren) Treffer für "debug-id" oder auch "debug_id"
- Die PayPal-Debug-ID ist ein hexadezimal-Wert mit typischwerweise 13 Stellen (dies kann jedoch variieren)
- Eine PayPal-Debug-ID sieht z.B.: so aus: 8f5bd2e03a959
- Notieren Sie sich die gefundene(n) Debug-ID(s)
Unter Angabe Ihrer Merchant-ID (diese finden Sie in Ihrem Kunden-Account bei PayPal), der genauen Zeit des Onboardings, der angezeigten Fehlermeldung (oder des Fehlerzustandes) und der ermittelten PayPal-Debug-ID(s) können Sie sich an den PayPal-Support wenden.
Ggfs. bitten Sie dort gleich um Weiterleitung an den Tech-Support von PayPal. Sollte Ihnen der PayPal-Support nicht weiterhelfen können, eröffnen Sie bitte mit denselben Informationen zzgl. der Angabe Ihrer PayPal Support Ticket-ID / Vorgangsnummer und dem Namen des PayPal-Mitarbeiters, ein Ticket beim Support von JTL. Wir werden die Informationen dann unsererseits an PayPal weitergeben.