Konto und Schlüssel
Konto erstellen, Organisation anlegen, API-Schlüssel holen.
1. Konto erstellen
Registriere dich unter dashboard.freika.com/registrieren mit E-Mail-Adresse und Passwort. Bestätige die E-Mail-Adresse über den Link, den wir dir schicken.
2. Organisation anlegen
Eine Organisation ist dein Unternehmen bei Freika. Sie hält Standorte, Terminals, Zahlungen, Auszahlungen und Team. Gib Firmenname, Rechtsform, Adresse und Branche an. Das dauert rund zwei Minuten.
Du kannst mehrere Organisationen haben und mit einem Klick wechseln, zum Beispiel für zwei Betriebe mit getrennter Buchhaltung.
3. API-Schlüssel holen
Unter Entwickler → API-Schlüssel erstellst du einen Schlüssel. Wähle einen Namen und die Berechtigung:
| Berechtigung | Erlaubt |
|---|---|
| Lesen | Zahlungen, Auszahlungen und Terminals abfragen |
| Schreiben | Zahlungen, Rückerstattungen und Zahlungslinks erstellen |
| Terminals steuern | Zahlungen an Terminals starten und abbrechen |
Der Schlüssel wird nur einmal angezeigt. Bewahre ihn wie ein Passwort auf und lege ihn nie in Frontend-Code oder in ein Repository.
# Test-Schlüssel beginnen mit fk_test_, Live-Schlüssel mit fk_live_
export FREIKA_API_KEY=fk_test_...4. Ersten Aufruf machen
curl https://api.freika.com/v1/balance \
-H "Authorization: Bearer $FREIKA_API_KEY"{
"available": 0,
"pending": 0,
"currency": "CHF",
"environment": "sandbox"
}Weiter mit Erste Zahlung.