Zum Inhalt springen

Eine API. Terminal, Smartphone, Online.

Zahlungen erstellen, Terminals aus der Kasse steuern, Ereignisse per Webhook empfangen. Klare Fehler, Idempotenz, Sandbox ohne Wartezeit.

Zur DokumentationSandbox eröffnen
POST /v1/paymentsbash
curl https://api.freika.com/v1/payments \
  -H "Authorization: Bearer fk_test_..." \
  -H "Idempotency-Key: bestellung-1042" \
  -d amount=8900 -d currency=CHF -d channel=online \
  -d success_url=https://deinshop.ch/danke

{
  "id": "pay_01J9X3A4Q6",
  "status": "pending",
  "checkout_url": "https://pay.freika.com/c/01J9X3A4Q6"
}

Grundsätze

Rappen, nie Franken
Beträge sind Ganzzahlen. 2450 ist CHF 24.50. Keine Rundungsfehler, keine Überraschungen.
Idempotent
Jeder schreibende Aufruf trägt einen Idempotency-Key. Netzabbrüche führen nie zu doppelten Zahlungen.
Signierte Webhooks
HMAC-SHA256 mit Zeitstempel und Replay-Schutz. Wiederholung bis zu drei Tage, Zustellprotokoll im Dashboard.
Fehler, die helfen
Problem Details nach RFC 9457 mit stabilem Code und Feldangabe. Kein Raten.
Ein Schlüssel, zwei Welten
fk_test_ und fk_live_. Sonst ist alles gleich. Die Sandbox hat ein Simulations-Terminal.
OpenAPI first
Die Referenz ist aus der Spezifikation erzeugt. Generiere Clients in jeder Sprache oder nutze unsere SDKs.

Terminals aus der Kasse steuern

Deine Kasse schickt den Betrag, das Terminal übernimmt. Ergebnis per Long-Polling, WebSocket oder Webhook. Mit Zwischenständen wie «PIN-Eingabe» für dein Kassendisplay.

curl https://api.freika.com/v1/terminals/trm_theke_links/payments \
  -H "Authorization: Bearer fk_live_..." \
  -H "Idempotency-Key: bon-42" \
  -d amount=2450 -d currency=CHF -d tip_prompt=true

# Ergebnis abwarten (Long-Polling, bis 30 s)
curl "https://api.freika.com/v1/payments/pay_01J9XT8?wait=30" \
  -H "Authorization: Bearer fk_live_..."

Ressourcen

Du baust ein Kassensystem oder eine Plattform?

Im Partnerprogramm legst du Organisationen für deine Kundschaft per API an, bekommst Unterstützung bei der Integration und laufend 10 % der prozentualen Gebühren.

Zum Partnerprogramm

In zwei Minuten startklar.

Konto erstellen, Sandbox testen, Terminal bestellen. Ohne Vertrag, ohne Grundgebühr.

Konto erstellenFragen? Schreib uns