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