Verbinden Sie Ihre eigenen Systeme mit TransferGo und rufen Sie Ihren Transaktionsverlauf automatisch ab – kein Einloggen zur Überprüfung erforderlich.
Was sind TransferGo Business-API und was kann ich damit machen?
Wir fügen eine neue Möglichkeit hinzu, sich mit TransferGo zu verbinden: die TransferGo Business API. Dies ermöglicht es Ihrem Unternehmen, Ihren Transaktionsverlauf direkt aus Ihren eigenen Systemen abzurufen – Sie müssen sich nicht jedes Mal im Portal anmelden, wenn Sie Ihre Zahlungen überprüfen möchten.
Dies ist besonders nützlich, wenn:
- Sie regelmäßig Zahlungen abgleichen: Ziehen Sie Ihre Transaktionsdaten direkt in Ihre eigene Buchhaltungs- oder ERP-Software (Enterprise Resource Planning).
- Sie ein Entwicklerteam haben: Einmal verbinden und Ihre Systeme die Überprüfung für Sie erledigen lassen.
Derzeit umfasst dies ausschließlich das Abrufen Ihrer Kontobewegungen. Die Möglichkeit, Zahlungen über die API zu senden, wird im Laufe dieses Jahres verfügbar sein. Wir werden Sie informieren, sobald diese Funktion bereitsteht.
Einen vollständigen Überblick über die Funktionen der API finden Sie in der Entwicklerdokumentation.
Wie beginne ich mit der Anbindung meiner Systeme an die TransferGo Business-API?
- API-Integrationen öffnen: Melden Sie sich bei TransferGo Business an und klicken Sie im linken Menü auf API-Integrationen.
- Verbindung starten: Klicken Sie auf Zustimmen & API-Verbindung erstellen.
- Bedingungen akzeptieren: Die Erstellung einer API-Verbindung erfordert die Zustimmung zu unseren aktualisierten Allgemeinen Geschäftsbedingungen (AGB).
Sie sind nicht der Kontoinhaber? Sie können diesen Schritt nicht selbst bestätigen – im nächsten Artikel erfahren Sie, was zu tun ist.
Genehmigung einer API-Verbindung als Kontoinhaber
Wenn ein Teammitglied mit der Einrichtung einer API-Verbindung beginnt, aber nicht der Kontoinhaber ist, benötigt es Ihre Genehmigung, bevor diese live gehen kann.
- Bestätigungslink erhalten: Ihr Teammitglied sendet Ihnen einen Link zur Bestätigung der Verbindung.
- Überprüfen und akzeptieren: Öffnen Sie den Link und akzeptieren Sie die aktualisierten Allgemeinen Geschäftsbedingungen.
- Fertig: Sobald die Bestätigung vorliegt, kann Ihr Teammitglied mit der Einrichtung des Zertifikats und der Anbindung seiner Systeme fortfahren.
Wie generiere ich mein Zertifikat und stelle eine Verbindung her?
Sobald Ihre Verbindung bestätigt ist, richten Sie ein Client-Zertifikat ein, mit dem Ihre Systeme eine sichere Verbindung herstellen können, und verwenden Sie dieses anschließend, um ein Zugriffstoken zu erhalten.
Wichtige Fakten:
- Ihr privater Schlüssel wird auf Ihrem eigenen Rechner generiert und verlässt diesen niemals.
- Zertifikate sind 1 Jahr lang gültig.
- Zugriffstoken sind 5 Minuten lang gültig. Speichern Sie sie daher im Cache und verwenden Sie sie wieder, anstatt für jeden Aufruf ein neues anzufordern.
- Das Hochladen Ihrer Zertifikatssignierungsanforderung (CSR) ist ein sensibler Schritt, daher werden Sie aufgefordert, diesen mit Ihrem Passwort zu bestätigen.
So geht’s:
- Öffnen Sie API-Integrationen und folgen Sie der Anleitung So stellen Sie eine Verbindung her für Ihr Betriebssystem (Windows oder macOS/Linux).
- Befolgen Sie die angezeigten Schritte, um Ihr Zertifikat zu generieren, holen Sie sich anschließend ein Zugriffstoken und testen Sie Ihre Verbindung.
Kommen Sie nicht weiter? Auf dem Einrichtungsbildschirm finden Sie den Link „Ich brauche Hilfe“.
Die genauen Befehle, Zertifikatsdetails und Token-Anfragen finden Sie im Leitfaden zur Authentifizierung und Autorisierung.
Wie verwalte ich meine API-Zertifikate?
Sie können Ihre Zertifikate jederzeit über „API-Integrationen“ verwalten.
A. Herunterladen Ihres Zertifikats
- Gehen Sie zu API-Integrationen.
- Suchen Sie Ihr Zertifikat in der Tabelle und klicken Sie auf .CRT herunterladen.
B. Hinzufügen eines sekundären Zertifikats
- Gehen Sie zu API-Integrationen.
- Klicken Sie auf Sekundäres Zertifikat hinzufügen.
Dies ist nützlich, wenn Sie ein Backup-Zertifikat bereithalten möchten, bevor Ihr primäres abläuft.
C. Widerrufen eines Zertifikats
- Gehen Sie zu API-Integrationen.
- Suchen Sie das Zertifikat, das Sie entfernen möchten, und klicken Sie daneben auf das Symbol zum Widerrufen.
- Bestätigen Sie die Entfernung.
Sobald es widerrufen wurde, kann dieses Zertifikat nicht mehr für Verbindungen verwendet werden – stellen Sie sicher, dass Ihre Systeme nicht mehr darauf angewiesen sind, bevor Sie es widerrufen.
Wichtig zu wissen: Zertifikate sind 1 Jahr lang gültig. Um eine Rotation ohne Ausfallzeiten durchzuführen, fügen Sie vor Ablauf Ihres primären Zertifikats ein sekundäres Zertifikat hinzu, stellen Sie Ihre Systeme darauf um und widerrufen Sie anschließend das primäre Zertifikat.
Weitere Informationen zu Ablauf und Rotation finden Sie unter „Ablauf und Rotation von Zertifikaten“.
Was kann ich über die TransferGo Business-API abrufen?
Sobald die Verbindung hergestellt ist, können Sie Ihre Kontobewegungen direkt in Ihre eigenen Systeme importieren. Dies umfasst Überweisungen und Aufladungen sowie Währungsumrechnungen, Ein- und Auszahlungen auf Sparkonten, Zinsen und Saldenanpassungen.
Zu jeder Transaktion erhalten Sie Details wie Status, Datum und Uhrzeit, Beträge und Währungen, Gebühren, Ihre Verwendungszwecke sowie Angaben zum Absender und Empfänger, wobei Kartennummern aus Sicherheitsgründen maskiert sind.
Die Ergebnisse sind paginiert und filterbar, sodass umfangreiche Transaktionsverläufe in überschaubaren Teilen geladen werden.
Derzeit ist diese Funktion schreibgeschützt: Sie können Daten abrufen, aber noch keine Zahlungen über die API senden. Diese Funktion ist für später in diesem Jahr geplant.
Eine vollständige Liste der Felder, Status und Filteroptionen finden Sie in der Transaktionsreferenz.