Nom d'instance

L'instance — aussi appelée nom du tenant — est l'identifiant technique de votre compte marchand dans FlowAlp Pay. Elle apparaît dans le domaine de vos pages de paiement et doit être envoyée comme paramètre de requête instance avec chaque appel à la Merchant API.

Où apparaît l'instance#

Instance:      demo-shop
Tenant URL:    https://demo-shop.pay.flowalp.com
API request:   https://api.pay.flowalp.com/v1.16/SignatureCheck/?instance=demo-shop

La forme générale de votre domaine tenant est https://<instance>.pay.flowalp.com. Vous l'utilisez pour vous connecter au dashboard, et vos pages de paiement hébergées sont servies sous ce même domaine.

Instance et autres identifiants#

Ne confondez pas l'instance avec les autres identifiants que vous rencontrerez dans la documentation :

Utiliser l'instance dans la Merchant API#

Chaque requête transporte l'instance comme paramètre de requête :

https://api.pay.flowalp.com/v1.16/:object/:id?instance=<instance>

Pour les requêtes POST, tous les autres paramètres vont dans le corps de la requête ; seul instance reste dans la query string. Détails : vue d'ensemble de la Merchant API et Authentification.

Vérifier votre configuration#

Associez votre instance à un API Secret (voir Identifiants API) et vérifiez la paire avec SignatureCheck :

curl --request GET \
  --url "https://api.pay.flowalp.com/v1.16/SignatureCheck/?instance=demo-shop" \
  --header "x-api-key: <api-secret>"

Une réponse avec le statut HTTP 200 et un statut de succès confirme que l'instance et l'API Secret sont valides.

Notes de sécurité#

• Le nom d'instance est visible dans les URL et n'est pas un secret en soi — mais ne l'exposez jamais avec l'API Secret dans du code frontend.
• Les requêtes avec une instance valide mais un API Secret manquant ou incorrect sont rejetées.
• Vous pouvez consigner le nom d'instance dans vos logs ; ne consignez jamais l'API Secret.