API-Zugangsdaten

Um FlowAlp Pay über die Merchant API (oder Plugins, die einen Schlüssel benötigen) zu integrieren, brauchen Sie ein mit Ihrer Instance verknüpftes API Secret.

Voraussetzungen

• Aktives Händlerkonto unter login.pay.flowalp.com (https://login.pay.flowalp.com)
• Berechtigung zur Verwaltung von API and Plugins auf dem Konto

API-Schlüssel erstellen

• Melden Sie sich im Händler-Dashboard an.
• Öffnen Sie API and Plugins.
• Wählen Sie Add API Key, um eine neue API-basierte Integration zu erstellen.
• Vergeben Sie einen erkennbaren Namen und bestätigen Sie mit Add.
• In der Liste finden Sie den neuen Schlüssel mit diesen Aktionen:

• Copy — kopiert den Schlüsselwert;
• Logs — listet Anfragen zu diesem Schlüssel;
• Configuration — Integration umbenennen oder Schlüssel neu erzeugen.

TODO FlowAlp: acquisire screenshot equivalente nell'account FlowAlp Pay — schermata API and Plugins con pulsante Add API Key

TODO FlowAlp: acquisire screenshot — dialog nome integrazione + Add

TODO FlowAlp: acquisire screenshot — riga chiave con Copy / Logs / Configuration

Was die Zugangsdaten enthalten

Element | Verwendung
API Secret | Geheimer Wert zur Authentifizierung von Anfragen (`X-API-KEY` oder Berechnung von `ApiSignature`)
Integrationsname | Operatives Label im Dashboard
Instance | Getrennt vom Schlüssel: siehe Instance-Name

Legen Sie echte Secrets nie in Dokumentation oder versioniertem Code ab. Verwenden Sie Platzhalter:

# text
<api-secret>

In Anwendungsbeispielen:

# javascript
const apiSecret = process.env.FLOWALP_PAY_API_SECRET;
const instanceName = process.env.FLOWALP_PAY_INSTANCE; // e.g. "demo-shop"

Anfrage-Logs

Für jede Integration (Plugin oder manuelle API) protokollieren die Logs Anfragen zwischen FlowAlp Pay und dem Drittsystem, einschließlich Fehler.

• Gehen Sie zu API and Plugins.
• Klicken Sie neben der betreffenden Zeile auf Logs.
• Wählen Sie eine Zeile, um Anfragedetails anzuzeigen.

TODO FlowAlp: acquisire screenshot — lista log e dettaglio request

Plugin vs manuelle API

Fall | Aktion
Unterstützte Plattform (WooCommerce, Shopify, Shopware, …) | Folgen Sie dem Plugin-Leitfaden; er erstellt/verknüpft den API-Schlüssel in der Regel automatisch
System ohne Plugin | Erstellen Sie den Schlüssel manuell und integrieren Sie die Merchant API

Plugin-Liste: Integration wählen.

In manchen technischen Bildschirmen, Paketen oder Plugin-Namen kann weiterhin Payrexx erscheinen, weil FlowAlp Pay diese Technologie als Zahlungsinfrastruktur nutzt.

API-Version

TODO FlowAlp: the source merchant guide mentions API version "1.13", while the current API Reference exposes v1.16 as the server URL. Confirm which version to recommend officially to FlowAlp Pay merchants before publication.

In den Beispielen dieser Dokumentation verwenden Sie, sofern nicht anders bestätigt:

# text
https://api.pay.flowalp.com/v1.16/

Sicherheit

• Speichern Sie das API Secret in einem Secret Manager oder in Umgebungsvariablen.
• Geben Sie das API Secret nicht im Frontend, in mobilen Apps oder Repositories preis.
• Wenn ein Schlüssel kompromittiert ist, erzeugen Sie ihn unter Configuration neu und aktualisieren Sie verbundene Systeme.
• Beschränken Sie den Zugriff auf Logs (sie können sensible payloads enthalten).

Nächste Schritte

• Authentifizierung
• Erste API-Anfrage