Panoramica di FlowAlp Pay
July 30, 2026
Panoramica di FlowAlp Pay: checkout ospitato, pay link e codici QR, plugin per shop, REST API e POS per accettare TWINT, carte e wallet in Svizzera.
FlowAlp Pay è la piattaforma di pagamento svizzera di FlowAlp per incassare online e di persona. Con un unico account merchant hai a disposizione un checkout ospitato, pay link e codici QR, plugin pronti per gli shop, una Merchant API REST e opzioni POS (punto vendita) — con metodi di pagamento svizzeri come TWINT accanto a carte e wallet internazionali.
Questa documentazione si rivolge a due tipi di lettori: merchant che vogliono farsi pagare con poca o nessuna configurazione tecnica e sviluppatori che integrano i pagamenti in siti, shop e app. Ogni funzionalità elencata qui sotto rimanda a una guida dedicata.
Cosa offre FlowAlp Pay
| Funzionalità | A cosa serve |
|---|---|
| Checkout ospitato (Gateway) | Una pagina di pagamento pronta all'uso, creata per ogni ordine tramite la Merchant API. Il cliente viene reindirizzato oppure la vede incorporata nel tuo sito. |
| Pay link e codici QR | Link di pagamento e codici QR da condividere, creati dalla dashboard — senza scrivere codice. |
| Plugin | Integrazioni predefinite per piattaforme e-commerce, CMS e software gestionali. |
| Merchant API | API REST per creare checkout e gestire transazioni, subscription, rimborsi e versamenti. |
| POS | Opzioni di pagamento di persona; la disponibilità dipende dalla configurazione del tuo account. |
I metodi di pagamento includono TWINT, Visa, Mastercard, American Express, PostFinance, Apple Pay, Google Pay, PayPal e Klarna. Quali metodi puoi offrire dipende dalla configurazione del tuo account — vedi Attivare i metodi di pagamento.
Concetti principali
| Concetto | Significato |
|---|---|
| Instance | L'identificativo tecnico del tuo account merchant. Compare nel dominio della pagina di pagamento e come query parameter instance in ogni richiesta API. |
| Gateway | Una sessione di checkout creata via API per un singolo pagamento. |
| Dashboard | Il back office merchant dove configuri metodi di pagamento, strumenti, API key e webhook. |
| Webhook | Una notifica server-to-server che informa il tuo sistema sui cambi di stato del pagamento. |
| Payout | Il versamento dei fondi incassati sul tuo conto bancario. |
Per approfondire l'instance vedi Instance name.
Due modi di integrare
Per merchant (senza codice o quasi)
- Crea il tuo account e attiva i metodi di pagamento.
- Crea pay link e codici QR direttamente dalla dashboard e condividili via e-mail, chat, fattura o stampa.
- Se usi una piattaforma shop, installa un plugin — parti dalla panoramica delle integrazioni e-commerce o dalla guida WooCommerce.
Per sviluppatori (API REST)
- Individua il tuo instance name e crea le credenziali API.
- Invia la tua prima richiesta API per verificare la configurazione.
- Crea un Gateway e porta il cliente al checkout ospitato, oppure incorporalo — vedi la panoramica dell'embedding del checkout.
- Elabora gli esiti lato server con i webhook e la verifica della firma.
- Testa tutto in modalità test e completa la checklist di go-live.
Esplora la documentazione
- Primi passi — Scegliere un'integrazione, Creare l'account, Credenziali API
- Pagamenti — Accettare un pagamento singolo, Pay link e codici QR, Abbonamenti
- Checkout — Panoramica embedding (redirect, iFrame, modale, mobile)
- API reference — Panoramica Merchant API, Autenticazione, Creare un Gateway
- Webhook — Configurare i webhook, Verificare la firma dei webhook
- Versamenti — Payout e riconciliazione
- Integrazioni — E-commerce, CMS, Software gestionali, Altre integrazioni
- Test — Testing per sviluppatori, Carte di test e scenari, Checklist di go-live
- SDK — SDK PHP
URL principali
| Uso | URL |
|---|---|
| Dashboard e registrazione | https://pay.flowalp.com |
| Il tuo tenant (accesso e pagine di pagamento) | https://tenantname.pay.flowalp.com |
| Merchant API | https://api.pay.flowalp.com/v1.16/ |
La Merchant API supporta le versioni v1.14, v1.15 e v1.16; per le nuove integrazioni usa v1.16. Vedi Versioni API e changelog.
Nuovo su FlowAlp Pay? Crea il tuo account e segui Scegliere un'integrazione. Se sviluppi, passa direttamente alla prima richiesta API.