Überblick APIs (Programmier-Schnittstellen) und Parameter-Übernahmen

INHALTSVERZEICHNIS

• Gut zu wissen
• 1. GET-Parameter
• 2. Benutzerdefinierte GET-Parameter
• 3. Parameter bei der Individuellen Erfolgsseite
• 4. API-Package
• 5. Form-API
• 6. Payment-API

In diesem Artikel erhalten Sie einen vollständigen Überblick über die möglichen APIs und Parameter-Übernahmen der FundraisingBox.

Gut zu wissen

• Es gibt verschiedene APIs (Application Programming Interfaces), sowie Parameter-Übernahmen, die für verschiedene Zwecke eingesetzt werden können. 
• Somit können z. B. individuelle Anpassungen umgesetzt oder bestimmte Vorgänge automatisiert. 

1. GET-Parameter

• Per GET-Parameter können verschiedene Werte Ihrem Formular, entweder fix oder variabel, übergeben werden. 
• Meistens wird in der Praxis der Betrag, sowie das Projekt übergeben.
• Sie können aber auch andere Felder/Checkboxen vorab belegen oder ein Land vorauswählen.
• Bestimmte GET-Parameter können schnell über den Button-Generator ohne manuelle Anpassung erstellt werden.

2. Benutzerdefinierte GET-Parameter

• Zusätzlich stehen Ihnen benutzerdefinierte GET-Parameter bzw. Custom Fields zur Verfügung.
• Diese sind natürlich auch in unserer DeveloperZone angeführt.
• Diese dienen z.B. der Übermittlung von Tracking-Codes oder Werten, die bei einem eigenen und vorgeschalteten Formular abgefragt werden.

3. Parameter bei der Individuellen Erfolgsseite

• Standardmäßig wird Ihrem Spender, nach einer erfolgreichen Transaktion, die automatische Erfolgsseite im Browser angezeigt.
• Wenn Sie stattdessen eine individuelle Erfolgsseite anlegen bzw. nach erfolgter Transaktion auf diese verlinken möchten, stehen Ihnen auch hier verschiedene Parameter zur Verfügung, (inklusive der Custom Variablen abhängig Ihrer Variante).
• Weitere Informationen zu der individuellen Erfolgsseite finden Sie hier.

4. API-Package

• Das API-Package bietet Ihrer IT Abteilung einen standardisierten Zugriff auf eine Vielzahl der Daten innerhalb der FundraisingBox.
• Mit etwas Programmierung können sie so einfach Daten (z.B. Spenden) in andere Software-Systeme (z.B. Banking-Software, externes CRM) synchronisieren.
• Somit können alle Spenderdaten automatisch übermittelt werden, ohne dass Sie diese über manuellen Export/Import synchronisieren müssen. 
• Gleichzeitig können Sie auch Informationen über die API zurück in die FundraisingBox übermitteln und diese dort nutzen (z.B. im Spendenmanagement).

Für folgende CRM-Anbieter steht eine direkte Schnittstelle über das API-Package zur Verfügung, sodass die Anbindungen schnell erfolgen: 

• SEXTANT von ANT Informatik AG
• raise-it von ifunds
• FundraisePlus von stehli software dataworks GmbH
• unitop NPO Fundraising von GOB (Microsoft Dynamics NAV)

5. Form-API

• Die Form-API ist eine der mächtigsten und umfangreichsten Schnittstellen und richtet sich an alle, die in Zusammenarbeit mit der eigenen IT-Abteilung und / oder Agentur hochindividuelle Fundraising-Lösungen  umsetzen möchten.
• Anstatt ein fertiges Formular in die eigene Webseite einzubinden, kann die Organisation ihren eigenen Rahmen,  z.B. dieses mehrschrittige Formular, entwickeln.
• Dazu wird mit einigen Zeilen Programmiercode der sogenannte FormAPI-Client eingebunden und die FundraisingBox übernimmt dabei wie gewohnt alle komplexen Aufgaben wie z. B. Payment-Processing, Verschlüsselung, Bedankung, Datennormalisierung, etc.

6. Payment-API

• Durch die Payment-API lassen sich hochindividualisierte Fundraising-Tools realisieren, um auch komplett individuelle Anwendungsfälle wie z.B. eigene Charity-Chat-Bots und Hardware-Spendenlösungen umsetzen zu können.