Häufig gestellte Fragen zur Fundraiser API

Verfügbarkeit

F: Kommt meine gemeinnützige Organisation für die Integration der Fundraiser API infrage?

A: Die Fundraiser API ist öffentlich und für Apps verfügbar, die den App Review durchlaufen. Die Apps können entweder einer gemeinnützigen Organisation oder einem Tech-Anbieter gehören. Damit eine Spendenaktion für eine gemeinnützige Organisation über die API erstellt werden kann, muss die gemeinnützige Organisation für die Spenden-Tools von Meta registriert sein. Das geht hier.

F: Welche Länder werden unterstützt?

A: Die Fundraiser API ist in Ländern verfügbar, in denen sich gemeinnützige Organisationen für die Spenden-Tools bewerben können. Hier findest du eine Liste der unterstützten Länder: https://facebook.com/help/1251484118194936.

F: Wie füge ich die Fundraiser API zu meiner App hinzu?

Auf dieser Seite findest du eine Anleitung, wie du Zugriff auf die API erhältst.

Testen

F: Wie kann ich eine Test-Spendenaktion erstellen?

A: Alle Spendenaktionen auf Facebook sind öffentlich. Du kannst jedoch eine Test-Spendenaktion erstellen, die nur für die Entwickler*innen deiner App sichtbar ist. Erstelle dazu einfach in der App eine Spendenaktion im Entwicklungsmodus. Bei auf diese Weise erstellten Spendenaktionen wird oben ein Banner mit dem Hinweis angezeigt, dass die Spendenaktion nur für App-Entwickler*innen sichtbar ist. Auch wenn du deine App von „In Entwicklung“ zu „Live“ änderst, sind deine Test-Spendenaktionen weiterhin für die Öffentlichkeit nicht sichtbar. Spendenaktionen, die von einer App im Status „Live“ erstellt wurden, bleiben auch dann öffentlich, wenn die App wieder in den Status „In Entwicklung“ versetzt wird.

F: Kann ich eine Spendenaktion mit einem*einer Testnutzer*in erstellen?

A: Der Zugriffsschlüssel für Nutzer*innen in der Anfrage muss einem*einer tatsächlichen Facebook-Nutzer*in gehören. Du kannst den Entwicklungsmodus einer App nutzen, um Test-Spendenaktionen zu erstellen, die vor der Öffentlichkeit verborgen sind.

F: Was ist der Unterschied zwischen einer App, die sich „In Entwicklung“ befindet oder „Live“ ist?

A: Spendenaktionen, die von einer App im Status „Live“ erstellt wurden, sind öffentlich sichtbar und live, während Spendenaktionen, die über eine Entwicklungs-App erstellt wurden, nur für die Entwickler*innen und Admins der App sichtbar sind. Spendenaktionen im Live- und Entwicklungsmodus können Spenden erhalten, aber Webhooks werden nur gesendet, wenn die App live ist.

F: Wie kann ich Spenden testen?

A: Derzeit unterstützen wir keine Testspenden. Alle Spenden müssen mit gültigen Zahlungsdaten getätigt werden. Der Mindestbetrag, den du spenden kannst, beträgt 5 USD. Über das Kontaktformular auf dieser Seite kannst du eine Rückerstattung beantragen.

F: Wie kann ich Webhooks testen?

A: Apps im Entwicklungsmodus erhalten kein Webhook-Event, wenn eine Spende getätigt wird. Daher ist es schwierig, einen End-to-End-Test zu erstellen. Du hast zwei Möglichkeiten, den Webhook zu testen: Du kannst ein Webhook-Event manuell über dein Developer Dashboard auslösen oder eine Spendenaktion mit einer App erstellen, die sich im Entwicklungsmodus befindet (damit die Spendenaktion nicht öffentlich ist). Dann kannst du die App auf „Live“ schalten, sodass Webhooks empfangen werden können, wenn du spendest.

Handlungen von Teilnehmenden

F: Was passiert, wenn ein*e Nutzer*in die Spendenaktion über Facebook löscht?

A: Es kommt zwar selten vor, aber Nutzer*innen können ihre Spendenaktion auf Facebook löschen. In diesem Fall gibt jeder Graph API-Aufruf, der auf die Spendenaktion verweist, einen Fehler zurück. Da es keinen Webhook gibt, der dich in Echtzeit über das Löschen einer Spendenaktion informiert, kannst du mit dem Löschen fortfahren, wenn du beim Versuch, die Spendenaktion zu lesen oder eine neue externe Spende zu posten, einen Fehler zurückgibst. Das Löschen einer Spendenaktion kann nicht rückgängig gemacht werden und ist endgültig. An diesem Punkt kannst du der Person die Möglichkeit bieten, sich über dein Teilnahmezentrum erneut mit Facebook zu verbinden, um eine neue Spendenaktion auf Facebook zu erstellen.

F: Was passiert, wenn Nutzer*innen Spendenaktionen löschen und später über die API neu erstellen?

A: Die neue Spendenaktion auf Facebook wird neu gestartet und berücksichtigt keine früheren Spenden. Um frühere Spenden zu erfassen, solltest du alle Spenden, die du bisher erhalten hast, als externe Spenden verbuchen. Das gilt auch für Spenden, die du zuvor auf Facebook erhalten hast. So stellst du sicher, dass der gespendete Gesamtbetrag mit dem Betrag übereinstimmt, der auf deiner Website angezeigt wird.

F: Wie ist das richtige Vorgehen, wenn Nutzer*innen eine Veranstaltung verlassen oder zu einer neuen Veranstaltung wechseln?

A: In diesen Fällen kannst du entscheiden, ob du die Facebook-Spendenaktion beenden möchtest. Bei Übertragungen von Teilnehmenden kannst du das Enddatum über die API aktualisieren, um sicherzustellen, dass die Facebook-Spendenaktion entsprechend dem neuen Veranstaltungsdatum endet.

Facebook-Spenden

F: Wer kann auf Facebook spenden oder Spendenaktionen erstellen?

A: Wir unterstützen Spenden aus bestimmten Ländern. Hier findest du eine vollständige Liste der Länder: https://facebook.com/help/837523116348786. Personen, die nicht spenden können, wird der „Spenden“-Button ausgegraut angezeigt.

F: Warum erhalten Spender*innen eine Fehlermeldung, wenn sie spenden möchten?

A: Möglicherweise gibt es ein Problem mit der Karte, die der*die Spender*in verwenden möchte. Versuche, die Karte aus den Zahlungseinstellungen zu entfernen und erneut hinzuzufügen: https://secure.facebook.com/settings?tab=payments&section=settings.

F: Wie kann ich auf einen Transaktionsbericht zugreifen, der alle auf Facebook eingegangenen Spenden zeigt?

A: Du kannst Transaktionsberichte über die Seite der Organisation herunterladen. Weitere Informationen findest du hier: https://facebook.com/help/1787615158233986.

F: Kann ich die Informationen der Spender*innen über den Webhook erhalten?

A: Der Webhook enthält keine Informationen über Spender*innen, aber Zahlungs-IDs, die du den IDs in den Transaktionsberichten zuordnen kannst.

Rückerstattungen von Spenden

F: Wird die Spendenaktion aktualisiert, wenn eine Rückerstattung erfolgt?

A: Wenn eine Spende zurückerstattet wird, wird dies derzeit nicht in der Spendenaktion auf Facebook berücksichtigt. Der gespendete Gesamtbetrag bleibt also unverändert. Es wird kein Webhook-Event ausgelöst, um dich über die Rückerstattung zu benachrichtigen.

F: Wie sollte ich mit Rückerstattungen auf der Website der gemeinnützigen Organisation umgehen?

A: Wenn jemand auf deiner Website spendet und später eine Rückerstattung beantragt, solltest du den Spendenbetrag mit Facebook synchronisieren. Bei vollständigen Rückerstattungen kannst du einfach die zuvor verbuchte externe Spende löschen. Bei Teilrückerstattungen kannst du die externe Spende löschen und dann eine neue mit dem aktualisierten Betrag verbuchen.