Panoramica FlowAlp Pay per sviluppatori

FlowAlp Pay è la soluzione di pagamento white-label di FlowAlp. Espone una Merchant API e strumenti di checkout che puoi integrare in siti, e-commerce, app e software gestionali.

Questa documentazione è rivolta a sviluppatori, integratori e merchant con competenze tecniche. Non presuppone conoscenza della tecnologia sottostante.

Concetti principali

Concetto | Ruolo
Instance | Identificativo tecnico del merchant. Compare nel dominio della pagina di pagamento e come query parameter `instance` nelle request API.
Merchant API | API REST su `https://api.pay.flowalp.com` per creare Gateway, gestire transazioni, subscription e altre risorse.
Gateway | Checkout personalizzabile creato via API per flussi di pagamento custom.
Tool merchant | Strumenti pronti all'uso configurati dal backoffice (nessuna o minima programmazione).
Plugin | Integrazioni predefinite per e-commerce, CMS e business software.

Opzioni di integrazione

Gateway custom

Usa il Gateway quando il pagamento deve inserirsi nel tuo checkout:

• crei un Gateway via Merchant API;
• reindirizzi (o incorpori) il cliente alla pagina di pagamento;
• ricevi aggiornamenti via webhook e verifiche server-side.

Vedi Accettare un pagamento (/docs/flowalp-pay/payments/one-time) e Creare un Gateway (/docs/flowalp-pay/api/gateway/create).

TODO FlowAlp: creare e collegare la pagina interna payments/one

Plugin e integrazioni esistenti

Per molte piattaforme e-commerce, CMS e software business sono disponibili integrazioni pronte. Consulta:

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

TODO FlowAlp: creare e collegare le pagine overview integrazioni

Embedding

Il Gateway (o i tool merchant) può essere presentato come:

• redirect verso la pagina di pagamento;
• iFrame;
• modal window;
• integrazione in app mobile.

Vedi Panoramica embedding (/docs/flowalp-pay/checkout/overview).

TODO FlowAlp: creare e collegare checkout/overview

Tool merchant

Se non serve un checkout custom, puoi usare i tool configurabili dall'account merchant senza sviluppare contro la API. Per l'embedding di questi strumenti valgono le stesse modalità di embedding del Gateway.

Percorso consigliato

• Scegliere un'integrazione (/docs/flowalp-pay/getting-started/choose-an-integration)
• Instance name (/docs/flowalp-pay/getting-started/instance-name)
• 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)
• Webhook e verifica del pagamento (non affidarti solo al redirect)

Domini FlowAlp Pay

Uso | URL
Merchant API | `https://api.pay.flowalp.com`
Login merchant | `https://login.pay.flowalp.com`
Registrazione | `https://signup.pay.flowalp.com`
Backoffice piattaforma | `https://backoffice.pay.flowalp.com`
Pagina di pagamento | `https://<instance>.pay.flowalp.com`

TODO FlowAlp: verificare lo stato operativo di https://pay.flowalp.com (host radice) prima della pubblicazione.

Passaggi successivi

• Scegliere un'integrazione (/docs/flowalp-pay/getting-started/choose-an-integration)
• Panoramica Merchant API (/docs/flowalp-pay/api/overview)

TODO FlowAlp: creare e collegare api/overview