Aller au contenu

Une API. Terminal, smartphone, en ligne.

Créer des paiements, piloter les terminaux depuis la caisse, recevoir les événements par webhook. Erreurs claires, idempotence, sandbox sans attente.

Vers la documentationOuvrir une 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"
}

Principes

Des centimes, jamais des francs
Les montants sont des entiers. 2450, c'est CHF 24.50. Pas d'erreur d'arrondi, pas de surprise.
Idempotent
Chaque appel en écriture porte une Idempotency-Key. Les coupures réseau ne créent jamais de paiements en double.
Webhooks signés
HMAC-SHA256 avec horodatage et protection contre le rejeu. Nouvelles tentatives pendant trois jours, journal de livraison dans le dashboard.
Des erreurs qui aident
Problem Details selon la RFC 9457 avec un code stable et le champ concerné. Pas de devinette.
Une clé, deux mondes
fk_test_ et fk_live_. Tout le reste est identique. La sandbox a un terminal de simulation.
OpenAPI d'abord
La référence est générée depuis la spécification. Génère des clients dans n'importe quel langage ou utilise nos SDK.

Piloter les terminaux depuis la caisse

Ta caisse envoie le montant, le terminal prend le relais. Résultat par long polling, WebSocket ou webhook. Avec des états intermédiaires comme « saisie du PIN » pour l'écran de ta caisse.

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

Ressources

Tu développes un système de caisse ou une plateforme ?

Dans le programme partenaires, tu crées des organisations pour ta clientèle par l'API, tu reçois de l'aide pour l'intégration et 10 % des frais en pourcentage, en continu.

Vers le programme partenaires

Prêt en deux minutes.

Créer un compte, tester la sandbox, commander un terminal. Sans contrat, sans frais mensuels.

Créer un compteDes questions ? Écris-nous