Hosted Payment Page (HPP)
La Hosted Payment Page (HPP) di Numia è una pagina di pagamento preconfigurata e ospitata sull’infrastruttura Numia, progettata per consentire ai merchant di accettare pagamenti online in modo rapido, sicuro e standardizzato.
Attraverso un modello di integrazione basato su inizializzazione transazione,
redirect del cliente e verifica dell’esito,
il merchant delega la fase di raccolta dei dati di pagamento alla piattaforma, mantenendo il controllo completo del flusso ordine e della logica applicativa.
1. Obiettivo della Hosted Payment Page
La HPP è progettata per:
- semplificare l’integrazione dei pagamenti online;
- ridurre la complessità tecnica lato frontend merchant;
- centralizzare la gestione dei metodi di pagamento;
- garantire coerenza nei flussi di autenticazione e autorizzazione.
Il merchant non deve sviluppare form di pagamento personalizzati né gestire direttamente la logica di sicurezza associata alla raccolta dei dati carta.
2. Modello di integrazione
La Hosted Payment Page utilizza un modello articolato in tre fasi principali:
-
Inizializzazione della transazione Il merchant crea la transazione tramite chiamata backend (
Init), definendo importo, valuta, orderId e URL di ritorno. -
Redirect del cliente verso la HPP Il browser viene reindirizzato alla pagina di pagamento generata da Numia, dove il cliente inserisce i dati richiesti.
-
Verifica dell’esito Al termine del pagamento, il merchant interroga il gateway (
Verify) per ottenere lo stato definitivo della transazione e aggiornare correttamente l’ordine.
Questo approccio separa chiaramente:
- esperienza utente di checkout (merchant);
- gestione tecnica del pagamento (Numia).
3. Cosa gestisce Numia
All’interno della Hosted Payment Page, Numia gestisce:
- interfaccia di pagamento;
- raccolta dei dati carta o metodo selezionato;
- validazione form;
- gestione errori di input;
- autenticazione 3D Secure (quando prevista);
- richiesta di autorizzazione verso acquirer e circuito;
- restituzione dell’esito tecnico della transazione.
4. Cosa resta in carico al merchant
Il merchant mantiene la responsabilità di:
- creazione e gestione dell’ordine;
- valorizzazione corretta dei parametri di inizializzazione;
- configurazione di
notifyURL,errorURLecallbackURL; - aggiornamento dello stato ordine in base all’esito della chiamata di verifica;
- gestione dell’esperienza utente prima e dopo il pagamento.
La Hosted Payment Page non sostituisce la logica eCommerce del merchant, ma ne gestisce esclusivamente la fase di pagamento.
5. Quando scegliere la HPP
La Hosted Payment Page è la soluzione consigliata quando:
- si desidera un’integrazione standardizzata e scalabile;
- si vuole ridurre l’impatto tecnico sul frontend;
- si preferisce delegare completamente la gestione dei form di pagamento;
- si punta a tempi di implementazione ridotti.
Per flussi di pagamento personalizzati o integrazioni dirette, consultare le sezioni dedicate della documentazione.