FlowAlp

Testing per sviluppatori

July 30, 2026

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.

FlowAlp Pay ti permette di provare l'intero flusso di pagamento — checkout, redirect, webhook, rimborsi — senza muovere denaro reale. La modalità test è un'impostazione dei metodi di pagamento del tuo account, non un sistema separato: mantieni la stessa instance, le stesse credenziali API e gli stessi endpoint.

Come funziona la modalità test

  • Nella dashboard porti un metodo di pagamento (o la configurazione del suo provider) da Live a Test.
  • Con la modalità test attiva, il checkout etichetta i metodi interessati come TEST e mostra le carte di test utilizzabili direttamente sulla pagina di pagamento.
  • Le transazioni create così vengono registrate come transazioni di test: non si muove denaro e nulla viene versato sul tuo conto.
  • I pagamenti di test si possono rimborsare, così provi anche la gestione dei rimborsi.

La disponibilità della modalità test per ciascun metodo dipende dalla configurazione del tuo account. Alcuni metodi, come TWINT e PostFinance, in modalità test si concludono sempre con stato confermato — per simulare esiti rifiutati usa le carte di test.

Cosa testare prima del go-live

  • Credenziali: SignatureCheck riesce con le credenziali che userà il tuo sistema di produzione.
  • Creazione del Gateway con importi realistici in unità minori e un referenceId univoco per ordine (Prima richiesta API).
  • Un pagamento per ogni esito: confermato, rifiutato e annullato — inclusi i rispettivi redirect di successo, fallimento e annullamento (Carte di test e scenari).
  • Ricezione dei webhook, verifica della firma ed elaborazione idempotente delle consegne ripetute (Configurare i webhook).
  • Un rimborso di un pagamento di test, dall'inizio alla fine.
  • Riconciliazione: il recupero della transazione via API restituisce lo stato registrato dal tuo sistema (Elencare e recuperare le Transactions).

Simulare gli esiti

I numeri delle carte di test permettono di provocare in modo deterministico pagamenti confermati e rifiutati. I numeri, insieme agli scenari per TWINT, wallet e rimborsi, sono raccolti in Carte di test e scenari.

Tieni separati test e produzione

  • Durante i test punta i redirect URL al tuo ambiente di staging.
  • Non usare mai API Secret di produzione in setup di test pubblici o automatizzati — vedi Credenziali API.
  • Nella dashboard ogni transazione riporta la propria modalità: puoi filtrare l'elenco per vedere solo i pagamenti reali.
  • Le transazioni di test non si possono eliminare — il filtro è il modo supportato per nasconderle.

Piano di test completo? Prosegui con Carte di test e scenari per i numeri di carta concreti, poi completa la checklist di go-live.