FlowAlp

FlowAlp Pay

Instance name

July 15, 2026

Cos'è l'instance in FlowAlp Pay e come usarla nel dominio e nelle request API.

L'instance è l'identificativo tecnico del merchant all'interno di FlowAlp Pay. Viene utilizzato nel dominio della pagina di pagamento e nelle richieste alla Merchant API.

Concetti principali

Non confondere l'instance con:

Identificatore | Significato
Instance name | Nome tecnico del merchant FlowAlp Pay (questo articolo)
Organization ID FlowAlp | Identificativo organizzazione nella Dashboard FlowAlp
User ID | Account utente
Gateway ID | ID di un Gateway di pagamento
Transaction ID | ID di una singola transazione
API Secret | Credenziale di autenticazione (vedi [Credenziali API](/docs/flowalp-pay/getting-started/api-credentials))

Formato del dominio

# text
Instance:
demo-shop

Pagina di pagamento:
https://demo-shop.pay.flowalp.com

Richiesta API:
https://api.pay.flowalp.com/v1.16/Gateway/?instance=demo-shop

Formato generale:

# text
https://<instance>.pay.flowalp.com

Uso nella Merchant API

Il parametro instance è obbligatorio nelle request e va passato come query parameter.

Esempio di URL base:

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

Dove:

Parte | Descrizione
`:object` | Risorsa (ad esempio `Gateway`, `Transaction`, `Subscription`)
`:id` | Usato per GET, PUT e DELETE su una singola entità
`instance` | Instance name del merchant

Per le request POST, tutti i query parameter eccetto instance devono essere nel body.

Esempio

# bash
curl --request GET \
  --url "https://api.pay.flowalp.com/v1.16/SignatureCheck/?instance=demo-shop" \
  --header "X-API-KEY: <api-secret>"

TODO FlowAlp: confermare se SignatureCheck è l'endpoint ufficiale consigliato per un smoke test sulle credenziali nella versione corrente prima della pubblicazione.

Sicurezza

  • Non esporre l'instance insieme all'API Secret nel frontend.
  • L'instance da sola non autentica: senza API Secret (o ApiSignature) le request falliscono.
  • Nei log applicazione puoi registrare l'instance; non registrare l'API Secret.

Passaggi successivi

  • Credenziali API (/docs/flowalp-pay/getting-started/api-credentials)
  • Autenticazione (/docs/flowalp-pay/api/authentication)
  • Prima richiesta API (/docs/flowalp-pay/getting-started/first-api-request)