FlowAlp Pay
Accetta pagamenti online e sul posto con FlowAlp Pay — checkout ospitato, pay link, codici QR, plugin e-commerce e una REST API completa. Guide per merchant e sviluppatori.
- Per iniziare
- Pagamenti
- Checkout e embedding
- API Reference
- Webhook
- Versamenti
- Integrazioni e plugin
- Test e go-live
- SDK
Per iniziare
Getting started
Scegliere un'integrazione
Guida alla scelta dell'integrazione FlowAlp Pay: confronta pay link e codici QR, plugin per shop, checkout ospitato via API e integrazione completa.
Getting started
Creare il tuo account FlowAlp Pay
Registrati su FlowAlp Pay, ottieni l'URL del tuo tenant, completa la verifica dell'account (KYC) e muovi i primi passi nella dashboard merchant.
Getting started
Attivare i metodi di pagamento (TWINT, carte, wallet)
Come attivare TWINT, carte, wallet e altri metodi di pagamento nella dashboard FlowAlp Pay, inclusi contratti di acquiring e modalità test.
Getting started
Instance name
Cos'è l'instance name in FlowAlp Pay, dove compare nel dominio della pagina di pagamento e come passarlo in ogni richiesta alla Merchant API.
Getting started
Credenziali API
Crea le API key di FlowAlp Pay dalla dashboard merchant, capisci cosa contiene ogni credenziale e applica le best practice per i secret.
Getting started
Prima richiesta API
Invia la prima richiesta alla Merchant API di FlowAlp Pay: verifica le credenziali con SignatureCheck e crea un Gateway minimo con curl o PHP.
Pagamenti
Payments
Accettare un pagamento singolo (one-time)
Accetta pagamenti one-time con FlowAlp Pay: crei un Gateway, reindirizzi il cliente al checkout hosted, confermi via webhook ed evadi l'ordine.
Payments
Metodi di pagamento: TWINT, carte, wallet e altro
Panoramica dei metodi di pagamento FlowAlp Pay: TWINT, carte, wallet, PayPal, Klarna e bonifico — attivazione e limitazione per pagamento.
Payments
Pay link e codici QR
Crea link di pagamento FlowAlp Pay dalla dashboard, condividili via email o codice QR e automatizza fatture e donazioni con l'API Paylink.
Payments
Pre-authorization: riservare e addebitare fondi
Pre-authorization con FlowAlp Pay: riservi un importo al checkout, lo addebiti in seguito via endpoint Transaction — hotel, noleggi e cauzioni.
Payments
Tokenization: addebitare metodi di pagamento salvati
Tokenization con FlowAlp Pay: salvi il metodo di pagamento al checkout (preAuthorization) e lo addebiti dopo lato server — fatturazione flessibile.
Payments
Abbonamenti e pagamenti ricorrenti
Fatturazione ricorrente con gli abbonamenti FlowAlp Pay: checkout subscription, webhook di rinnovo, gestione via API e confronto con la tokenization.
Checkout e embedding
Checkout & embedding
Panoramica dell'embedding del checkout
Confronta le opzioni di embedding del checkout FlowAlp Pay: redirect, iFrame, modal window e app mobile, con consigli su quando usarle.
Checkout & embedding
Embedding iFrame
Incorpora il modulo di pagamento FlowAlp Pay nel tuo sito con un iFrame: URL, attributo allow, limiti dei metodi ed eventi di resize e stato.
Checkout & embedding
Modal window
Apri il checkout FlowAlp Pay in una modal window: snippet dalla dashboard, overlay JavaScript personalizzato, callback e limiti dei metodi.
Checkout & embedding
Integrazione nelle app mobile
Integra FlowAlp Pay nelle app iOS e Android: crea il Gateway lato server, aprilo in una WebView, gestisci gli eventi e rientra con i deep link.
API Reference
API Reference
Panoramica Merchant API
Panoramica della Merchant API di FlowAlp Pay: URL di base e versioni, autenticazione, formato delle request, risorse, errori e rate limit.
API Reference
Versioni API e changelog
Come funzionano le versioni della API di FlowAlp Pay: versioni supportate da v1.14 a v1.16, come fissare la versione, upgrade e changelog.
API Reference
Autenticazione della Merchant API
Autentica le richieste alla Merchant API di FlowAlp Pay con l'header x-api-key o con la firma ApiSignature HMAC-SHA256, con esempi di codice.
API Reference
Formato delle request
Formato delle request della Merchant API FlowAlp Pay: struttura degli URL, body JSON e form-urlencoded, verbi HTTP e importi in unità minime.
API Reference
Errori della Merchant API
Status HTTP della Merchant API FlowAlp Pay, struttura del body JSON di errore e indicazioni pratiche di retry con exponential backoff.
API Reference
Rate limit della Merchant API
Rate limit della Merchant API FlowAlp Pay: 600 request ogni 5 minuti, segnali 405/403 sotto carico e strategia di retry con backoff.
API Reference
SignatureCheck: verifica le credenziali API
Convalida le credenziali API e il calcolo della firma su FlowAlp Pay con l'endpoint SignatureCheck: esempi curl e PHP e risposta tipica.
API Reference
Creare un Gateway
Crea un checkout FlowAlp Pay con POST /Gateway/: tabella completa dei parametri, esempi curl e SDK PHP, campi della response ed errori.
API Reference
Recuperare un Gateway
Recupera un Gateway FlowAlp Pay per ID e controlla lo stato del pagamento (waiting, confirmed, authorized, reserved). Esempi curl e SDK PHP.
API Reference
Eliminare un Gateway
Elimina un Gateway FlowAlp Pay per ID con la Merchant API: request DELETE /Gateway/{id}/, esempi curl e SDK PHP, response ed errori.
API Reference
Creare un Paylink
Crea un Paylink FlowAlp Pay con POST /Invoice/: un link di pagamento da inviare via e-mail o codice QR. Parametri, esempi ed errori.
API Reference
Recuperare ed elencare i Paylink
Recupera un Paylink FlowAlp Pay per ID con GET /Invoice/{id}/ e verifica il pagamento. Esempi curl e SDK PHP, campi della response, errori.
API Reference
Aggiornare ed eliminare un Paylink
Elimina un Paylink FlowAlp Pay con DELETE /Invoice/{id}/ e scopri come sostituirlo quando i parametri cambiano. Esempi curl e SDK PHP.
API Reference
Elencare e recuperare le Transaction
Elenca e filtra le transazioni FlowAlp Pay o recupera una singola transazione tramite ID, con tutti gli stati spiegati per la Merchant API.
API Reference
Addebitare, catturare, rimborsare e annullare le Transaction
Addebita pagamenti tokenizzati, cattura importi riservati, rimborsa in modo totale o parziale e annulla transazioni in attesa con FlowAlp Pay.
API Reference
API Subscription
Crea, recupera, aggiorna e annulla le subscription FlowAlp Pay via API, con intervalli di fatturazione ricorrente, durata del periodo e IVA.
API Reference
API Payout
Elenca i payout FlowAlp Pay e recupera un singolo payout con transazioni, commissioni e riferimento bancario per la tua riconciliazione.
API Reference
Payment provider e identificatori dei metodi
Interroga i payment provider configurati sul tuo account FlowAlp Pay e consulta gli identificatori dei metodi di pagamento come TWINT o Visa.
Webhook
Webhooks
Configurare i webhook
Configura i webhook FlowAlp Pay: impostazione in dashboard, content type, retry, timeout di 20 secondi, idempotenza e conferma sicura degli ordini.
Webhooks
Eventi e payload dei webhook
Riferimento per gli eventi webhook FlowAlp Pay: payload di transazioni, subscription e payout con esempi JSON e consigli per l'idempotenza.
Webhooks
Verificare la firma dei webhook
Verifica l'autenticità dei webhook FlowAlp Pay: controllo firma HMAC-SHA256 in PHP, pattern ApiSignature e test credenziali con SignatureCheck.
Versamenti
Integrazioni e plugin
Integrations & plugins
Panoramica integrazioni e-commerce
Panoramica dei plugin e-commerce FlowAlp Pay per WooCommerce, Shopify, Shopware, Magento 2 e altri, con lo schema generale di installazione.
Integrations & plugins
Guida al plugin WooCommerce
Guida passo passo a WooCommerce con FlowAlp Pay: attiva l'integrazione, installa e collega il plugin, configura i metodi e testa gli ordini.
Integrations & plugins
Panoramica integrazioni CMS
Collega FlowAlp Pay al tuo CMS: WordPress, Drupal, WIX, Jimdo, Weebly e altri — con i pay link come soluzione universale senza codice.
Integrations & plugins
Panoramica business software
Collega FlowAlp Pay ai software aziendali: contabilità con Bexio, automazioni con Zapier e Make, prenotazioni Planyo, tool di raccolta fondi.
Integrations & plugins
Altre integrazioni
Percorsi di integrazione oltre i plugin per shop e CMS: build personalizzate su API FlowAlp Pay, moduli e donazioni, pay link senza codice.
Test e go-live
Testing & go-live
Testing per sviluppatori
Come funziona la modalità test di FlowAlp Pay: simula pagamenti senza muovere denaro reale, cosa testare prima del go-live e come separare i dati.
Testing & go-live
Carte di test e scenari
Le carte di test FlowAlp Pay per simulare pagamenti confermati e rifiutati in modalità test, con scenari per TWINT, wallet e rimborsi.
Testing & go-live
Checklist di go-live
Checklist di produzione per FlowAlp Pay: credenziali live, webhook con verifica firma, redirect URL, gestione errori con backoff e riconciliazione.