PayPal einrichten¶
Zuerst muss der API-Zugriff bei PayPal aktiviert werden, bevor in weiteren zwei Schritten das PayPal-Konto mit dem Kommandozeilen-Tool "aqpaypal-tool" durchgeführt werden kann.
PayPal-API-Zugriff¶
Über https://www.paypal.com/businessmanage/credentials/apiAccess kann der API-Zugriff auch bei Privat-Konten aktiviert werden. Dazu unter "NVP/SOAP-API-Integration (klassisch)" auf den Link "API-Berechtigung verwalten" und den Anweisungen folgen. Es existieren mehrere Schritt-für-Schritt-Anleitungen im Internet, die leicht über die nach der URL gefunden werden können.
Am Ende der Prozedur können- API-Benutzername (APIuserID)
- API-Passwort (APIpassword) und
- Signatur (APIsignature)
abgerufen werden, die in den folgenden Schritten benötigt werden.
Benutzer anlegen¶
# Neuen User anlegen (userID ist Benutzerkennung) aqpaypal-tool adduser -u userID -N realUserName -U APIuserID -P APIpassword -S APIsignature -s serverURL
Die userID wird selbst vergeben und ist z.B. "1".
Die serverURL ist https://api-3t.paypal.com/nvp
realUsername kann frei gewählt werden, z.B. der echte Name des Kontoinhabers.
`adduser` verlangt nach einem selbst vergebenen Passwort, das mindestens sechs Zeichen lang sein muss und in einem zweiten Schritt bestätigt werden muss.
Damit ist die Einrichtung abgeschlossen! Nun können die Kontodaten mit `aqbanking-cli` abgerufen werden.
Eingerichtete User und Accounts listen¶
aqpaypal-tool listusers aqpaypal-tool listaccounts
Kontodaten abrufen mit aqbanking-cli¶
# Kontostand abrufen aqbanking-cli request -a PAYPAL --balance oder aqbanking-cli request --aid=<unique account id> --balance --fromdate=20200401
Die zweite ist die bevorzugte Variante, da hier das Konto eindeutig identifiziert wird (die <unique account id> erhält man im vorherigen Schritt, siehe oben).
Beim Abruf der Überweisungen muss ein Startdatum angegeben werden, sonst bricht die Abfrage mit einer Fehlermeldung ab:
# *Alle* Transaktionen abrufen aqbanking-cli request --aid=<unique account id> --transactions --fromdate=20010101
PayPal-API-ID und Passwort setzen¶
Das mit `adduser` gesetzte Passwort kann mit `setsecrets` geändert werden:
# Username/Password/Signature setzen aqpaypal-tool setsecrets -u userID -U APIuserID -P APIpassword -S APIsignature
Debugging¶
Bei Problemen helfen manchmal ausführlichere Logs. Hierzu wertet das Paypal-Modul die folgenden Umgebungsvariablen aus:
# Loglevel setzen (erlaubte Werte: error, notice, info, debug) export AQPAYPAL_LOGLEVEL=info # schreibe die gesendeten und Empfangenen Daten in die Datei paypal.log im aktuellen Verzeichnis export AQPAYPAL_LOG_COMM=1