Un pagamento risulta regolarmente incassato sul vostro conto Payplug, ma il relativo ordine non ha cambiato stato nel vostro e-commerce, oppure appare duplicato.
Se avete ricevuto un'e-mail di errore di notifica (IPN), vi invitiamo a consultare questo articolo.
1. Verificare il pagamento nel portale
3. Verificare che il modulo Payplug sia aggiornato
5. Prima di disattivare o reinstallare il modulo
1. Verificare il pagamento nel portale
Accedete al menu Pagamenti, quindi aprite la riga del pagamento interessato.
Se il pagamento si trova in stato "pagato", la somma è stata acquisita e potete evadere l'ordine senza ulteriori attese.
Il codice di risposta della notifica vi indicherà poi dove cercare. Un codice 4xx o 5xx significa generalmente che la notifica (IPN) non è andata a buon fine: l'articolo citato in precedenza tratta proprio questo scenario.
Un codice 200 significa che il vostro sito l'ha accettata, senza tuttavia garantire che abbia aggiornato l'ordine: potrebbe averla ignorata in seguito, e in questo caso la notifica non viene inviata di nuovo. Questa è la situazione analizzata nel resto dell'articolo.
2. Aggiornare l'ordine
Vi consigliamo di evadere prima gli ordini in sospeso, per poi cercare l'origine del problema.
| Piattaforma | Come procedere |
|---|---|
| WooCommerce | Aprite l'ordine e avviate l'azione Aggiorna i dettagli della transazione Payplug (Update Payplug transaction details). Se l'opzione non è disponibile, modificate manualmente lo stato dell'ordine. |
| Magento | Gli ordini non pagati vengono ripresi automaticamente ogni 15 minuti, durante le 4 ore successive alla creazione dell'ordine. Trascorso questo termine, utilizzate il pulsante di aggiornamento nel blocco Payplug sulla pagina dell'ordine. |
| PrestaShop | Non è prevista la ripresa automatica: dovrete modificare manualmente lo stato dell'ordine. |
Nota bene: correggere la causa del problema avrà effetto solo sui pagamenti futuri. Gli ordini già bloccati dovranno essere sbloccati uno ad uno.
3. Verificare che il modulo Payplug sia aggiornato
È la verifica più importante, e molto spesso l'unica necessaria.
Confrontate la versione installata con l'ultima release rilasciata, quindi leggete le note di rilascio (release notes): se il vostro malfunzionamento figura tra le correzioni, l'aggiornamento risolverà il problema.
Questo passaggio è anche un prerequisito fondamentale per qualsiasi richiesta di assistenza. Su una versione obsoleta, capita spesso che un bug sia già stato risolto e i nostri team vi chiederanno di aggiornare il modulo prima di procedere oltre.
Potete inoltre consultare i changelog per ciascuna versione del modulo:
| Piattaforma | Note di rilascio |
|---|---|
| PrestaShop | changelog.md |
| WooCommerce | readme.txt, sezione Changelog |
| Magento 2 | CHANGELOG.md |
| Sylius | CHANGELOG.md |
4. Altre cause frequenti
Cosa potete verificare in autonomia
- Il problema è comparso dopo un aggiornamento (del modulo, del CMS o del vostro hosting). È la prima pista da esplorare.
- Un conflitto con un altro modulo. Disattivate temporaneamente i moduli che avete installato voi stessi, lasciando attivo Payplug. Disattivare Payplug comporterebbe la cancellazione della sua configurazione (vedi sezione successiva).
Cosa compete alla vostra agenzia o all'hosting
-
Su Magento, le operazioni pianificate (cron). Se il cron di Magento è fermo o se il gruppo di task
payplugè stato disattivato, gli ordini falliti non vengono mai ripresi e l'anomalia è simile a quella di una notifica non funzionante. -
Su Magento, un aggiornamento incompleto. La procedura si conclude solo dopo aver lanciato
setup:upgrade, la compilazione, la generazione dei contenuti statici e lo svuotamento della cache. Le note ACTION REQUIRED presenti nel fileCHANGELOG.mddevono essere lette per tutte le versioni saltate. - I permessi dei file. La regola standard è 0755 per le cartelle e 0644 per i file. Applicare 755 a tutto rende i file eseguibili, impostazione che alcuni provider di hosting bloccano.
-
Il file
.htaccess. Nessuna regola deve limitare l'accesso alla pagina che riceve le nostre notifiche: password, filtri per indirizzo IP o per Paese, reindirizzamenti sistematici, protezioni anti-bot.
5. Prima di disattivare o reinstallare il modulo
WooCommerce. Vi sconsigliamo vivamente di disattivare il modulo: questa operazione cancella l'intera configurazione. L'eliminazione produce lo stesso effetto. Sarebbe poi necessario riconfigurare tutto da zero.
Magento. Il modulo di pagamento non deve mai essere disinstallato: gli ordini già pagati ne dipendono. Contattate la vostra agenzia o il nostro supporto.
PrestaShop. La reinstallazione ripara un'installazione rimasta incompleta, ma comporta alcune conseguenze:
- le carte salvate dai vostri clienti vengono eliminate in modo definitivo;
- le vostre impostazioni Payplug tornano ai valori predefiniti;
- l'emissione di un rimborso dal vostro back-office PrestaShop diventa impossibile per gli ordini precedenti. Rimarrebbe comunque possibile procedere dal vostro portale Payplug.
Prendete nota delle vostre impostazioni in anticipo e scegliete un momento di scarso traffico. Il pulsante Reimposta (Reset) produce gli stessi effetti.
6. Se il problema persiste
Vi invitiamo a contattare il nostro supporto specificando il vostro CMS e la versione del modulo, uno o due ID di pagamento interessati completi di codice di risposta, nonché le modifiche recenti apportate al vostro sito.
Su WooCommerce, la modalità debug del modulo deve essere attivata prima di riprodurre il problema, altrimenti i log rimarranno vuoti.