Scegliere un'integrazione

FlowAlp Pay offre più modalità di integrazione. La scelta dipende dalla piattaforma che usi e dal livello di controllo richiesto sul checkout.

Prerequisiti

• Account merchant FlowAlp Pay (registrazione (https://signup.pay.flowalp.com) o login (https://login.pay.flowalp.com))
• Almeno un payment provider configurato nell'account
• Accesso al codice del sito / shop / app, se integri via API o embedding

Decisioni rapide

Scenario | Approccio consigliato | Dove andare
Usi un e-commerce, CMS o business software supportato | Plugin / integrazione ufficiale o di terze parti | [Integrazioni](/docs/flowalp-pay/integrations/other-integrations)
Hai già una pagina di pagamento configurata nel backoffice e vuoi mostrarla sul sito | iFrame o modal window | [iFrame](/docs/flowalp-pay/checkout/iframe), [Modal window](/docs/flowalp-pay/checkout/modal-window)
Serve un checkout custom (importo dinamico, redirect, carrello, app) | Merchant API — Gateway | [Accettare un pagamento](/docs/flowalp-pay/payments/one-time)

TODO FlowAlp: creare e collegare le pagine citate se non ancora presenti

Plugin di terze parti

Se la piattaforma dispone di un plugin, preferiscilo a un'integrazione custom: riduce manutenzione e allinea il flusso a quanto già testato. Elenco e guide:

• E-commerce (/docs/flowalp-pay/integrations/ecommerce/overview)
• CMS (/docs/flowalp-pay/integrations/cms/overview)
• Business software (/docs/flowalp-pay/integrations/business-software/overview)

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.

Embedding di una pagina esistente

Se la pagina di pagamento è già configurata dal merchant backend e non serve un flusso API dinamico:

• genera o recupera l'URL / snippet della pagina;
• incorporala via iFrame oppure aprila in modal window;
• per mobile, vedi Mobile apps (/docs/flowalp-pay/checkout/mobile-apps).

Il redirect del browser alla success URL non sostituisce la verifica server-side dello stato di pagamento.

Gateway via Merchant API

Usa il Gateway quando:

• l'importo e i metadati dell'ordine sono generati dal tuo backend;
• vuoi success / failed / cancel redirect controllati;
• gestisci subscription, tokenization o pre-authorization;
• integri un checkout custom o un'app.

Flusso tipico:

• backend crea un Gateway (POST /Gateway/);
• cliente completa il pagamento sulla pagina FlowAlp Pay (redirect o embed);
• ricevi webhook e/o interroghi la Merchant API;
• aggiorni l'ordine solo dopo conferma server-side.

Dettagli: Creare un Gateway (/docs/flowalp-pay/api/gateway/create) e Configurare i webhook (/docs/flowalp-pay/webhooks/configuration).

Passaggi successivi

• Instance name (/docs/flowalp-pay/getting-started/instance-name)
• Credenziali API (/docs/flowalp-pay/getting-started/api-credentials)
• Prima richiesta API (/docs/flowalp-pay/getting-started/first-api-request)