- Cos'è una notifica di pagamento?
- Un errore di notifica non influisce sull'incasso
- Come faccio a sapere se il problema mi riguarda?
- Le 3 verifiche fondamentali
- Una notifica fallita non può essere reinviata
- Tabella di riferimento dei codici di risposta
-
Avete bisogno di aiuto?
Cos'è una notifica di pagamento?
La notifica di pagamento (IPN) è il messaggio che i server di Payplug inviano al vostro sito a ogni pagamento o rimborso. Trasmette le informazioni di pagamento e attiva l'aggiornamento dello stato dell'ordine nel vostro back-office.
In condizioni normali, la transazione mostra un codice di risposta 200: il pagamento è stato incassato e l'informazione è stata trasmessa correttamente al vostro sito.
Un errore di notifica non influisce sull'incasso
Un errore di notifica non ha alcuna ripercussione sulla ricezione del pagamento sul vostro conto Payplug. Indica semplicemente che non è stato possibile trasmettere correttamente l'informazione al vostro sito, e di conseguenza l'ordine potrebbe non essersi aggiornato automaticamente.
Come faccio a sapere se il problema mi riguarda?
In due modi:
- Ricevete un'e-mail automatica da Payplug che vi segnala l'errore.
- Nel vostro portale Payplug, menu Pagamenti, cliccate sulla riga del pagamento: il codice di risposta della notifica è indicato nei dettagli della transazione.
Se il codice mostrato è 200 ma il vostro ordine continua a non essere aggiornato, questo non è l'articolo che fa per voi: consultate Il pagamento è andato a buon fine, ma l'ordine non si aggiorna sul mio CMS.
Le 3 verifiche fondamentali
La stragrande maggioranza degli errori di notifica deriva da una di queste tre cause.
1. Il vostro URL di notifica è accessibile dall'esterno? Deve essere raggiungibile pubblicamente, accettare le richieste POST in entrata e non essere protetto da autenticazione (.htaccess, password, pagina di pre-produzione). Verificate inoltre che il vostro sito non sia in modalità manutenzione.
2. I server di notifica Payplug sono autorizzati? Oggi è questa la causa più frequente. Un firewall, un WAF (es. Cloudflare) o un modulo/plugin di sicurezza (es. SecuPress, Wordfence) potrebbe bloccare i nostri server e far fallire la notifica. È necessario autorizzare gli indirizzi IP di notifica di Payplug nel vostro firewall e negli strumenti di sicurezza:
| Regione | Indirizzi IP |
|---|---|
Irlanda (eu-west-1) |
52.17.55.154, 52.209.87.92, 54.77.126.191
|
Autorizzate tutti questi IP: le notifiche possono provenire dall'una o dall'altra regione.
3. Il vostro modulo Payplug è aggiornato e installato correttamente? Una versione obsoleta o un'installazione incompleta possono generare un errore. Verificate di utilizzare l'ultima versione del modulo e controllate i permessi dei file (0644) e delle cartelle (0755).
Prima di prendere in considerazione una disinstallazione, consultate Il pagamento è andato a buon fine, ma l'ordine non si aggiorna sul mio CMS: l'operazione comporta delle conseguenze e i suoi effetti variano a seconda del vostro CMS.
Una notifica fallita non può essere reinviata
Non è possibile reinviare una notifica una volta che questa è fallita, e non viene riemessa in automatico.
In concreto: una volta rimosso il blocco, solo le notifiche future verranno trasmesse correttamente. Gli ordini già impattati dovranno essere ripresi uno a uno, utilizzando il menu Pagamenti del vostro portale Payplug per ritrovare le transazioni interessate.
A seconda del CMS utilizzato, potrebbe esistere una procedura di recupero per aggiornare un ordine senza intervento manuale. I dettagli sono disponibili in Il pagamento è andato a buon fine, ma l'ordine non si aggiorna sul mio CMS.
Tabella di riferimento dei codici di risposta
Se volete comprendere il codice mostrato sulla vostra transazione:
| Codice | Significato | Causa frequente | Cosa verificare |
|---|---|---|---|
| 200 | OK | — | Nulla, è tutto a posto |
| 301 / 302 | Reindirizzamento (Redirect) | Passaggio HTTP→HTTPS, restyling, cambio di URL | Il nostro server non segue i reindirizzamenti: inserite l'URL finale, senza reindirizzamenti |
| 400 | Richiesta non valida (Bad request) | URL malformato | Verificate l'URL; contattate il vostro hosting in caso di soluzione SaaS/integrata |
| 401 | Autenticazione richiesta | URL o sito protetto da .htaccess
|
Rendete l'URL di notifica accessibile senza autenticazione |
| 403 | Accesso negato (Forbidden) | Firewall / WAF / modulo di sicurezza bloccante | Autorizzate gli IP Payplug (vedi verifica n°2); consentite le richieste POST in entrata |
| 404 | Risorsa non trovata (Not found) | URL rinominato o eliminato | Verificate i vostri URL di ritorno e di notifica; assicuratevi che il modulo sia installato correttamente. |
| 405 | Metodo non consentito | URL errato o verbo HTTP sbagliato (GET invece di POST) | Generalmente per integrazioni API: verificate che la notifica avvenga in POST |
| 500 | Errore interno del server | Configurazione server, permessi, file mancanti | Consultate i log degli errori del server e i file di log del modulo se utilizzate un CMS; verificate i permessi e il file .htaccess; passate in rassegna le modifiche recenti |
| 502 | Bad gateway | DNS, server di origine irraggiungibile, firewall | Verificate la risoluzione DNS e l'accessibilità del server; autorizzate gli IP Payplug |
| 503 | Servizio non disponibile | Server sovraccarico, in manutenzione o sottodimensionato | Verificate la disponibilità e il dimensionamento del vostro hosting. Assicuratevi che il sito non sia in modalità manutenzione |
Avete bisogno di aiuto?
Se il problema persiste dopo queste verifiche, contattate il supporto Payplug specificando l'ID della transazione interessata e il codice di risposta visualizzato.
👉 Contattare il supporto Payplug