Vai al contenuto

Un'API. Terminale, smartphone, online.

Creare pagamenti, comandare i terminali dalla cassa, ricevere eventi via webhook. Errori chiari, idempotenza, sandbox senza attesa.

Alla documentazioneApri una sandbox
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"
}

Principi

Centesimi, mai franchi
Gli importi sono numeri interi. 2450 è CHF 24.50. Nessun errore di arrotondamento, nessuna sorpresa.
Idempotente
Ogni chiamata in scrittura porta una Idempotency-Key. Le interruzioni di rete non creano mai pagamenti doppi.
Webhook firmati
HMAC-SHA256 con timestamp e protezione dal replay. Nuovi tentativi fino a tre giorni, registro delle consegne nella dashboard.
Errori che aiutano
Problem Details secondo RFC 9457 con codice stabile e indicazione del campo. Niente indovinelli.
Una chiave, due mondi
fk_test_ e fk_live_. Il resto è identico. La sandbox ha un terminale di simulazione.
OpenAPI prima di tutto
Il riferimento è generato dalla specifica. Genera client in qualsiasi linguaggio o usa i nostri SDK.

Comandare i terminali dalla cassa

La tua cassa invia l'importo, il terminale fa il resto. Risultato via long polling, WebSocket o webhook. Con stati intermedi come «inserimento PIN» per il display della tua cassa.

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_..."

Risorse

Sviluppi un sistema di cassa o una piattaforma?

Nel programma partner crei organizzazioni per la tua clientela via API, ricevi supporto per l'integrazione e il 10 % delle commissioni percentuali, in modo continuativo.

Al programma partner

Pronto in due minuti.

Crea un account, prova la sandbox, ordina un terminale. Senza contratto, senza canone mensile.

Crea un accountDomande? Scrivici