Identifiants API

Pour intégrer FlowAlp Pay via la Merchant API (ou des plugins qui exigent une clé), vous avez besoin d'un API Secret associé à votre instance.

Prérequis

• Compte marchand actif sur login.pay.flowalp.com (https://login.pay.flowalp.com)
• Permission de gérer API and Plugins sur le compte

Créer une clé API

• Connectez-vous au tableau de bord marchand.
• Ouvrez API and Plugins.
• Choisissez Add API Key pour créer une nouvelle intégration basée sur l'API.
• Attribuez un nom reconnaissable et confirmez avec Add.
• Dans la liste, vous trouverez la nouvelle clé avec ces actions :

• Copy — copie la valeur de la clé ;
• Logs — liste les requêtes associées à cette clé ;
• Configuration — renommer l'intégration ou régénérer la clé.

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

Contenu de l'identifiant

Élément | Usage
API Secret | Valeur secrète utilisée pour authentifier les requêtes (`X-API-KEY` ou calcul de `ApiSignature`)
Nom de l'intégration | Libellé opérationnel dans le tableau de bord
Instance | Distinct de la clé : voir Nom de l'instance

Ne placez jamais de secrets réels dans la documentation ou le code versionné. Utilisez des placeholders :

# text
<api-secret>

Dans les exemples d'application :

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

Journaux de requêtes

Pour chaque intégration (plugin ou API manuelle), les logs enregistrent les requêtes entre FlowAlp Pay et le système tiers, y compris les erreurs.

• Allez dans API and Plugins.
• Cliquez sur Logs à côté de la ligne concernée.
• Sélectionnez une ligne pour afficher le détail de la requête.

TODO FlowAlp: acquisire screenshot — lista log e dettaglio request

Plugin vs API manuelle

Cas | Action
Plateforme prise en charge (WooCommerce, Shopify, Shopware, …) | Suivez le guide du plugin ; il crée/lie généralement la clé API automatiquement
Système sans plugin | Créez la clé manuellement et intégrez la Merchant API

Liste des plugins : Choisir une intégration.

Dans certains écrans techniques, packages ou noms de plugins, vous pouvez encore voir Payrexx, car FlowAlp Pay utilise cette technologie comme infrastructure de paiement.

Version de l'API

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.

Dans les exemples de cette documentation, sauf vérification contraire, utilisez :

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

Sécurité

• Stockez l'API Secret dans un gestionnaire de secrets ou des variables d'environnement.
• N'exposez pas l'API Secret dans le frontend, les applications mobiles ou les dépôts.
• Si une clé est compromise, régénérez-la depuis Configuration et mettez à jour les systèmes connectés.
• Limitez l'accès aux logs (ils peuvent contenir des payloads sensibles).

Étapes suivantes

• Authentification
• Première requête API