Zahlungsseite

Jede Online-Zahlung, die du per API erstellst, bekommt eine checkout_url. Dahinter liegt die Zahlungsseite von Freika: mobil optimiert, mehrsprachig, mit deinen Farben und deinem Logo. Kartendaten berühren deine Systeme nie, deshalb bleibt dein PCI-Aufwand minimal.

Anpassen

Unter Einstellungen → Zahlungsseite stellst du ein:

• Logo und Akzentfarbe
• Sprache (automatisch nach Browser, mit Umschalter)
• Impressum- und Datenschutz-Link
• Welche Zahlungsmethoden angezeigt werden

Eine Vorschau zeigt Änderungen sofort.

Ablauf

1. Deine Anwendung erstellt die Zahlung (POST /v1/payments) mit success_url und failed_url.
2. Du leitest auf checkout_url weiter.
3. Die Kundschaft wählt die Methode und bezahlt.
4. Freika leitet zurück und schickt payment.succeeded oder payment.failed an deinen Webhook.

Sprache und Betrag vorgeben

curl https://api.freika.com/v1/payments \
  -H "Authorization: Bearer $FREIKA_API_KEY" \
  -d amount=12000 -d currency=CHF -d channel=online \
  -d locale=fr \
  -d "allowed_methods[]=twint" -d "allowed_methods[]=visa" -d "allowed_methods[]=mastercard"

Zeitlimit

Eine Zahlung im Status pending verfällt nach 30 Minuten (expires_at). Danach ist checkout_url ungültig und der Status wird canceled mit failure_code: expired.

Einbettung

Die Zahlungsseite lässt sich auch als iframe einbetten (checkout_url mit ?embed=1). Für native Apps empfehlen wir die Weiterleitung im Systembrowser.