NGO.tools Hilfe

ConnectedAccountProviders (app/Support/ConnectedAccountProviders/AGENTS.md)

Aktualisiert am 13.11.2026

Außerhalb von NGO.tools

  • Deine REST-App bei PayPal braucht die Funktion „Transaction search“, sonst lehnt PayPal den Abruf der Umsätze ab.

In NGO.tools: Einstellungen › Finanzen › Zahlungskonten

  • NGO.tools ruft die Umsätze verbundener Bankkonten automatisch dreimal täglich ab.
  • Je Konto läuft nur ein Abruf gleichzeitig; findet ein Abruf einen bereits laufenden, wird er übersprungen.
  • Beim Aktivieren eines verbundenen Kontos startet NGO.tools sofort einen Abruf der Umsätze.
  • Den direkten PayPal-Abruf über die PayPal-API gibt es nur, wenn diese Funktion für deine Organisation freigeschaltet ist; sie ist auf Anfrage erhältlich.
  • Wird die Funktion für den direkten PayPal-Abruf abgeschaltet, ruft NGO.tools keine neuen PayPal-Umsätze mehr ab, die bereits importierten Umsätze bleiben aber erhalten.
  • Für den direkten PayPal-Abruf brauchst du eine eigene REST-App deiner Organisation bei PayPal, deren Zugangsdaten je Bankkonto gespeichert werden.
  • Die PayPal-Zugangsdaten des Bankkontos sind getrennt von denen des Spendenformulars; der Dialog bietet dir lediglich an, die Zugangsdaten des Spendenformulars zu übernehmen.
  • Der direkte PayPal-Abruf reicht höchstens drei Jahre zurück, und der gewählte Starttag wird ab seinem Beginn in der Zeitzone deiner Organisation gelesen.
  • Weil PayPal Umsätze verzögert liefert, liest jeder PayPal-Abruf die letzten 72 Stunden vor dem bisherigen Stand erneut.
  • Ein einzelner PayPal-Abruf liest höchstens 12 Zeitfenster von je höchstens 31 Tagen.
  • Scheitert ein späterer Teil eines PayPal-Abrufs, bleiben die bis dahin gelesenen Umsätze erhalten.
  • Stellst du ein vorhandenes PayPal-Konto auf den direkten PayPal-Abruf um, trennt NGO.tools die bisherige FinAPI-Verbindung.
  • Beim Umstellen von FinAPI auf den direkten PayPal-Abruf schlägt NGO.tools als Beginn den Tag des neuesten FinAPI-Umsatzes vor, und du kannst bis zu drei Jahre zurück wählen.

In NGO.tools: Finanzen › Bankvorgänge

  • Liefert der Anbieter einen Umsatz erneut, legt NGO.tools ihn nicht doppelt an, sondern aktualisiert den vorhandenen Umsatz.
  • Auch wenn automatischer, manueller Abruf und Aktivierung zusammentreffen, entsteht kein Umsatz und keine PayPal-Gebühr doppelt.
  • Der PayPal-Abruf importiert abgeschlossene und rückabgewickelte Zahlungen, wobei eine Rückbuchung als eigener Umsatz kommt; abgelehnte Zahlungen überspringt er.
  • Ausstehende PayPal-Zahlungen prüft NGO.tools bei jedem Abruf erneut, höchstens 50 je Abruf und die am längsten nicht geprüften zuerst.
  • Ein PayPal-Umsatz enthält den Bruttobetrag, und die PayPal-Gebühr legt NGO.tools als eigenen Umsatz an.
  • Liefert PayPal einen Umsatz erneut, aktualisiert NGO.tools dessen Daten und zieht die Gebühr nach, eine bereits gebuchte Position behält aber ihren Betrag.
  • Der Verwendungszweck eines PayPal-Umsatzes besteht aus Artikelnamen, Betreff und Notiz, dahinter steht die E-Mail-Adresse des Zahlenden.
  • Als Adresse eines PayPal-Umsatzes gilt die Adresse des PayPal-Kontos des Zahlenden, die Lieferadresse nur bei gleichem Namen, weil sie sonst ein Geschenk an jemand anderen sein kann.
  • Nach dem Umstellen von FinAPI auf PayPal überspringt NGO.tools während der Übernahme PayPal-Umsätze, die FinAPI schon geliefert hat, damit kein Umsatz doppelt entsteht.
  • Beim Abgleich nach dem Umstellen vergleicht NGO.tools zuerst die PayPal-Transaktions-ID und sonst Tag, Betrag, Währung und Zahler, wobei jeder FinAPI-Umsatz für genau einen PayPal-Umsatz steht.
  • Ein übernommener FinAPI-Umsatz erhält die PayPal-Daten samt Adresse und, solange nichts darauf gebucht ist, den PayPal-Verwendungszweck mit den Artikelnamen; gebuchte Umsätze behalten ihren Text.

In NGO.tools: Spenden › Spendenerfassung

  • Buchst du einen PayPal-Umsatz als Spende, ergänzt NGO.tools die PayPal-Adresse bei Kontakten, die noch keine Adresse haben.