Erste Zahlung
Eine Online-Zahlung erstellen, die Kundschaft zur Zahlungsseite leiten, das Ergebnis empfangen.
Zahlung erstellen
curl https://api.freika.com/v1/payments \
-H "Authorization: Bearer $FREIKA_API_KEY" \
-H "Idempotency-Key: bestellung-1042" \
-H "Content-Type: application/json" \
-d '{
"amount": 8900,
"currency": "CHF",
"channel": "online",
"reference": "Bestellung 1042",
"success_url": "https://deinshop.ch/danke",
"failed_url": "https://deinshop.ch/abgebrochen",
"customer_email": "anna@example.ch"
}'{
"id": "pay_01J9X3A4Q6",
"status": "pending",
"amount": 8900,
"currency": "CHF",
"channel": "online",
"checkout_url": "https://pay.freika.com/c/01J9X3A4Q6",
"created_at": "2026-09-10T09:00:00Z"
}Kundschaft weiterleiten
Leite auf checkout_url weiter. Die Zahlungsseite zeigt deine Marke, die aktiven Zahlungsmethoden und funktioniert auf jedem Gerät. Nach der Zahlung kommt die Person auf success_url zurück.
Nie auf die Rückleitung verlassen
Die Rückleitung auf success_url kann unterbleiben (Browser geschlossen, Netz weg). Verlass dich
für die Auftragsfreigabe immer auf den Webhook payment.succeeded oder auf GET /v1/payments/{id}.
Ergebnis empfangen
Registriere einen Webhook-Endpunkt unter Entwickler → Webhooks oder per API. Bei jeder Statusänderung schicken wir ein Ereignis:
{
"id": "evt_01J9X3B7",
"type": "payment.succeeded",
"created_at": "2026-09-10T09:01:12Z",
"data": {
"id": "pay_01J9X3A4Q6",
"status": "succeeded",
"amount": 8900,
"method": "twint",
"reference": "Bestellung 1042"
}
}Wie du die Signatur prüfst, steht unter Webhooks.
Status abfragen
curl https://api.freika.com/v1/payments/pay_01J9X3A4Q6 \
-H "Authorization: Bearer $FREIKA_API_KEY"Statuswerte: pending, authorized, succeeded, failed, canceled, refunded, partially_refunded.