Credenziali API

Per integrare FlowAlp Pay via Merchant API (o tramite plugin che richiedono una chiave) serve un'API Secret associata alla tua instance.

Prerequisiti

• Account merchant attivo su login.pay.flowalp.com (https://login.pay.flowalp.com)
• Permessi per gestire API and Plugins nell'account

Creare un'API key

• Accedi al merchant dashboard.
• Apri API and Plugins.
• Seleziona Add API Key per creare una nuova integrazione basata su API.
• Assegna un nome riconoscibile all'integrazione e conferma con Add.
• Nella lista troverai la nuova chiave con le azioni disponibili:

• Copy — copia il valore della chiave;
• Logs — elenco delle request associate a questa chiave;
• Configuration — modifica del nome o rigenerazione della chiave.

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

Cosa contiene la credenziale

Elemento | Uso
API Secret | Valore segreto usato per autenticare le request (`X-API-KEY` oppure calcolo di `ApiSignature`)
Nome integrazione | Etichetta operativa nel dashboard
Instance | Separata dalla chiave: vedi [Instance name](/docs/flowalp-pay/getting-started/instance-name)

Non inserire mai segreti reali nella documentazione o nel codice versionato. Usa placeholder:

# text
<api-secret>

Negli esempi applicativi:

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

Log delle request

Per ogni integrazione (plugin o API manuale) sono disponibili log che registrano le request tra FlowAlp Pay e il sistema terzi, inclusi eventuali errori.

• Vai su API and Plugins.
• Clicca Logs accanto alla riga desiderata.
• Seleziona una riga per vedere i dettagli della request.

TODO FlowAlp: acquisire screenshot — lista log e dettaglio request

Plugin vs API manuale

Caso | Azione
Piattaforma supportata (WooCommerce, Shopify, Shopware, …) | Segui la guida del plugin; di solito crea/collega l'API key automaticamente
Sistema senza plugin | Crea la chiave manualmente e integra la Merchant API

Elenco plugin: Scegliere un'integrazione (/docs/flowalp-pay/getting-started/choose-an-integration).

In alcune schermate tecniche, nei package o nel nome del plugin può ancora comparire il nome Payrexx, poiché FlowAlp Pay utilizza questa tecnologia come infrastruttura di pagamento.

Versione API

TODO FlowAlp: la guida merchant sorgente indica di usare la versione API "1.13", mentre l'API Reference corrente espone v1.16 come server URL. Verificare quale versione raccomandare ufficialmente ai merchant FlowAlp Pay prima della pubblicazione.

Negli esempi di questa documentazione, salvo diversa verifica, si usa:

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

Sicurezza

• Conserva l'API Secret in un secret manager o in variabili d'ambiente.
• Non esporre l'API Secret nel frontend, nelle app mobile o nei repository.
• Se una chiave è compromessa, rigenerala dalla Configuration e aggiorna i sistemi collegati.
• Limita l'accesso ai log (possono contenere payload sensibili).

Passaggi successivi

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