M0083 PayPal-Helper für Gambio
Handbuch
1. Was dieses Modul leistet
Wenn ein Kunde über PayPal bezahlt, vergibt der Zahlungsdienst zu jeder Buchung eine eigene Transaktionsnummer. Sie ist der Schlüssel, mit dem sich eine Zahlung im PayPal-Konto eindeutig wiederfinden lässt – bei Rückfragen, bei Erstattungen und gegenüber der Buchhaltung.
Ihr Shop kennt diese Nummer zwar, führt sie von sich aus aber nirgends mit. Wer eine Zahlung zuordnen will, muss Bestellung und PayPal-Konto von Hand nebeneinanderlegen. Genau diese Lücke schließt unser Modul: Es holt die Transaktionsnummer zu jeder Bestellung ein, merkt sie sich im Shop und druckt sie – auf Wunsch – auf die Rechnung und in die Bestellbestätigung.
Damit haben Sie und Ihr Kunde dieselbe Nummer auf demselben Beleg stehen. Eine Rückfrage wie „Welche Zahlung gehört zu dieser Rechnung?" ist mit einem Blick beantwortet.
Das Modul arbeitet ausschließlich mit den Zahlungswegen, die Ihr Shop ohnehin nutzt. Es braucht keine eigenen Zugangsdaten zu PayPal und keine Fremdschnittstelle.
2. Wo Sie das Modul im Backend finden
Das Setup erreichen Sie über das Menü „Xycons-Module" ► „Kundenkonto / Setups" und dort über den TAB „PayPalHelper".
Eine eigene Arbeitsoberfläche hat das Modul nicht – es arbeitet im Hintergrund. Was es tut, sehen Sie an der Stelle, an der es wirkt: auf der Rechnung und in der Bestellbestätigung.
3. Das Setup
Das Setup ist kurz. Sie schalten das Modul ein und entscheiden, auf welchen der beiden Belege die Zahlungsnummer erscheinen soll.
Grundeinstellungen
| Einstellung | Bedeutung |
|---|---|
| Modulstatus - PayPalHelper | Schaltet das Modul ein oder aus. Steht es auf Ausgeschaltet, verhält sich Ihr Shop exakt so wie ohne das Modul: Es werden keine Nummern mehr geholt, keine gespeichert und auf keinem Beleg angedruckt. Bereits gespeicherte Nummern bleiben dabei unangetastet – nach dem Wiedereinschalten stehen sie sofort wieder zur Verfügung. (Standard: Ausgeschaltet) |
| Ihre Lizenz: | Reine Anzeige. Hier steht, welche Lizenzart für Ihren Shop erkannt wurde – etwa eine Voll-Lizenz mit unbegrenzter Laufzeit. Sie müssen an dieser Stelle nichts eintragen. |
Andruck auf Rechnung und Bestellbestätigung
| Einstellung | Bedeutung |
|---|---|
| RG-Info | Bestimmt, ob die Zahlungsnummer auf der Rechnung erscheint. Sie wird dort im Rechnungshinweis direkt unter der Zahlungsmethode ausgewiesen. Liegt zu einer Bestellung keine Nummer vor, bleibt die Zeile weg – es entsteht keine leere Beschriftung. (Standard: Ja, in RG-Info andrucken) Empfehlung: eingeschaltet lassen. Der Andruck kostet nichts und erspart im Rückfragefall die Suche. |
| Bestellbestätigung | Bestimmt, ob die Zahlungsnummer der Bestellbestätigung zur Verfügung gestellt wird. Anders als bei der Rechnung genügt dieser Schalter allein nicht: Sie müssen zusätzlich einen Platzhalter in die Mailvorlage einsetzen. Wie das geht, steht in Kapitel 5. (Standard: Ja, auf Bestellbestätigung andrucken) |
Diagnose
| Einstellung | Bedeutung |
|---|---|
| Debug-Info | Schreibt zusätzliche Protokolle mit, während das Modul arbeitet. Das ist für die Fehlersuche gedacht und im Alltag nicht nötig. (Standard: Nein) Empfehlung: nur einschalten, wenn wir Sie im Supportfall darum bitten – und danach wieder ausschalten. Die dabei entstehenden Aufzeichnungen enthalten vollständige Zahlungsdaten und werden nach einer Woche selbsttätig aufgeräumt. |
4. Die Zahlungsnummer auf der Rechnung
Für die Rechnung müssen Sie nichts weiter einrichten. Ist das Modul eingeschaltet und steht RG-Info auf Andruck, erscheint die Nummer automatisch im Rechnungshinweis – direkt unter der Zahlungsmethode.
Die Beschriftung vor der Nummer können Sie frei ändern, siehe Kapitel 8.
Auf dem Lieferschein erscheint die Nummer bewusst nicht. Er geht dem Paket bei und ist oft für Dritte einsehbar; eine Zahlungsreferenz gehört dort nicht hin.
5. Die Zahlungsnummer in der Bestellbestätigung
Die Bestellbestätigung ist keine feste Vorlage, sondern Ihr eigener Text – deshalb entscheiden Sie selbst, ob und an welcher Stelle die Zahlungsnummer darin auftaucht. Das Modul stellt sie bereit, eingesetzt wird sie von Ihnen.
Den Platzhalter in die Mailvorlage einsetzen
Öffnen Sie im Backend „Kunden" ► „E-Mails" ► „E-Mail Vorlagen" und dort die Vorlage „Bestellbestätigung". Schalten Sie im Bearbeitungsfenster über die Schaltfläche „Quellcode" in die Quelltextansicht.
Setzen Sie an der gewünschten Stelle – bewährt hat sich direkt unter der Zeile mit der Zahlungsmethode – diesen Platzhalter ein:
{if $PAYPAL_TRANSACTIONS}<strong>Transaktion:</strong> {$PAYPAL_TRANSACTIONS}<br />{/if}
Die Umklammerung mit {if ...} ist wichtig: Sie sorgt dafür, dass die ganze Zeile verschwindet, wenn zu einer Bestellung keine Zahlungsnummer vorliegt. Ohne sie stünde in solchen Mails eine Beschriftung ohne Inhalt.
Alternativ können Sie die fertig beschriftete Fassung verwenden. Sie bringt die Beschriftung schon mit und lässt sich wie jeder andere Modultext ändern:
{if $PAYPAL_TRANSACTIONS_LINE}{$PAYPAL_TRANSACTIONS_LINE}<br />{/if}
Denken Sie daran, den Platzhalter in beiden Fassungen der Vorlage einzusetzen – in der HTML- und in der Textfassung – und in jeder Sprache, die Ihr Shop anbietet. Die Reiter dafür finden Sie oberhalb des Bearbeitungsfensters.
Das Ergebnis sieht dann so aus:
Wenn die Nummer noch nicht vorliegt
Die Bestellbestätigung entsteht unmittelbar nach dem Bestellabschluss. Die Transaktionsnummer meldet der Zahlungsdienst manchmal erst kurz danach. Trifft das zusammen, geht die Bestätigung ohne Nummer hinaus – die Zeile bleibt dank der {if ...}-Umklammerung einfach weg.
6. Mehrere Zahlungsnummern zu einer Bestellung
Zu einer Bestellung können durchaus mehrere Buchungen gehören – etwa wenn ein Betrag nachträglich in zwei Schritten eingezogen wurde. Das Modul unterschlägt in diesem Fall nichts: Es führt alle zugehörigen Nummern auf, durch Leerzeichen getrennt.
Erfasst werden dabei nicht nur einfache Sofortbuchungen, sondern auch Reservierungen, spätere Einzüge und Erstattungen.
7. Eigene Auswertungen über die Zahlungsnummern
Das Modul legt die ermittelten Nummern im Shop ab und nutzt diese Ablage als Zwischenspeicher – ein zweiter Blick auf dieselbe Bestellung kostet deshalb keine erneute Nachfrage beim Zahlungsdienst.
Die Ablage steht auch Ihnen offen. Wenn Sie unseren SQL-Reporter einsetzen, können Sie damit eigene Berichte bauen – etwa eine Liste aller Bestellungen eines Monats samt Zahlungsnummer für die Buchhaltung. Sie brauchen dafür lediglich zwei Angaben:
| Angabe | Inhalt |
|---|---|
| orders_id | die Bestellnummer, über die Sie mit Ihren übrigen Bestelldaten verknüpfen |
| transaction_id | die Zahlungsnummer; ein leerer Eintrag bedeutet „geprüft, es lag noch keine Nummer vor" |
Die Ablage trägt den Namen xy_paypal_transactions.
8. Modultexte ändern
Modultexte können Sie – wie bei allen Modulen von uns – über die Shopfunktion „Texte ändern" im Admin-Bereich an eigene Bedürfnisse anpassen.
Für dieses Modul betrifft das vor allem die Beschriftung, die vor der Zahlungsnummer steht. Ab Werk lautet sie PayPal-TrANr. Wenn Ihnen das zu knapp ist, machen Sie daraus etwa PayPal-Transaktion oder Zahlungsreferenz – die Beschriftung auf der Rechnung und die in der Bestellbestätigung lassen sich getrennt einstellen.
9. Shopupdate und Modulpflege
Bitte beachten Sie vor jedem Shopupdate zwei Punkte:
- Vorher prüfen, ob das Modul für die neue Shopversion freigegeben ist. Den aktuellen Stand finden Sie auf unserer Seite. Beginnen Sie das Update erst, wenn die Freigabe vorliegt.
- Beim Update immer die neuesten Fassungen von Modul und Modulumgebung mitinstallieren – nicht nur den Shop selbst aktualisieren. Ein Modul passt sich einer neuen Shopversion nicht von allein an; wer nur den Shop aktualisiert, hat danach ein Modul, das nicht mehr greift, und sucht die Ursache erfahrungsgemäß an der falschen Stelle.
Lassen Sie das Shopupdate durch uns durchführen, bringen wir Modul und Modulumgebung immer mit auf den passenden Stand.
10. Häufige Stolpersteine
Auf der Rechnung steht keine Nummer. Prüfen Sie der Reihe nach: Ist das Modul eingeschaltet? Steht RG-Info auf Andruck? Wurde die Bestellung überhaupt über PayPal bezahlt? Bei allen anderen Zahlarten gibt es keine Nummer, und das Modul hält sich dann bewusst heraus.
Die Rechnung zeigt einen alten Stand. Eine einmal erzeugte Rechnung wird von Ihrem Shop aufbewahrt und unverändert wieder ausgegeben – das muss so sein, eine Rechnung darf sich nachträglich nicht ändern. Bestellungen, die vor dem Einschalten des Moduls berechnet wurden, bekommen die Nummer deshalb nicht rückwirkend.
In der Bestellbestätigung fehlt die Nummer, auf der Rechnung steht sie. Das ist der Normalfall aus Kapitel 5.2: Zum Zeitpunkt der Bestätigung lag die Nummer noch nicht vor.
In der Bestellbestätigung fehlt die Nummer immer. Dann ist der Platzhalter nicht in der Mailvorlage – oder nur in einer der beiden Fassungen. Prüfen Sie HTML- und Textfassung und jede Sprache.
In der Mail steht eine leere Beschriftung. Der Platzhalter wurde ohne die {if ...}-Umklammerung eingesetzt. Ergänzen Sie sie wie in Kapitel 5.1 gezeigt.
Kommen Sie nicht weiter, melden Sie sich bei uns – am besten mit einer Bestellnummer, bei der Sie das Verhalten beobachtet haben.
Wir wünschen Ihnen viel Erfolg beim Einsatz dieses Moduls!
