VibeFox PagSeguro for OpenCart — Guida

Requisiti

OpenCart: 3.0.x (testato su 3.0.5.0) o 4.0.2 e successivi (testato su 4.1.0.3).

PHP: 8.0 o successivo.

Currency: Real brasiliano (BRL). Il negozio deve avere la valuta BRL (System > Localisation > Currencies), e il metodo di pagamento viene mostrato solo quando il cliente effettua il checkout in BRL.

Reachable site: il tuo negozio deve essere raggiungibile da Internet affinché PagBank possa inviare le notifiche di pagamento.

PagBank account: un token di produzione per i pagamenti reali e un token sandbox per i test. Produzione: accedi al tuo account PagBank, apri Venda online > Integrações e fai clic su Gerar token; PagBank invia il token via e-mail. Sandbox: copia il token del tuo account sandbox nel portale per sviluppatori di PagBank. I token sandbox e di produzione funzionano solo nel proprio ambiente.

VibeFox license key: acquistata su vibefox.net. Una chiave funziona su un solo dominio.

Installazione

Il download è un unico file zip con i pacchetti per entrambe le versioni di OpenCart. Decomprimilo sul tuo computer. Contiene README.txt, il pacchetto per OpenCart 3 wcp_pagseguro_gateway-oc3-(version).ocmod.zip e il pacchetto per OpenCart 4 wcp_pagseguro_gateway.ocmod.zip. Installa solo il pacchetto per la tua versione di OpenCart. La chiave di licenza è la stessa per entrambe le versioni.

OpenCart 3

1. Nel pannello di amministrazione vai su Extensions > Installer, fai clic su Upload e scegli il file wcp_pagseguro_gateway-oc3-(version).ocmod.zip. L'estensione non contiene modifiche OCMOD, quindi Extensions > Modifications non richiede un aggiornamento. In alternativa all'installer, puoi copiare il contenuto della cartella upload di questo pacchetto nella cartella principale del tuo negozio.

2. Vai su Extensions > Extensions e scegli il tipo Payments. Trova VibeFox PagSeguro Gateway e fai clic su Install (il pulsante verde +). Il tuo utente amministratore deve avere il permesso di modificare l'elenco delle estensioni di pagamento.

3. Fai clic su Edit (il pulsante con la matita) per aprire la pagina delle impostazioni. Incolla la tua chiave di licenza VibeFox in License key, nel blocco della licenza in cima alla pagina, e fai clic su Activate (vedi Chiave di licenza).

4. Inserisci il token sandbox e, per accettare pagamenti reali, il token di produzione. Non serve configurare nulla in PagBank: l'URL di notifica viene inviato con ogni pagamento.

5. Attiva Enable / Disable e fai clic su Save. Effettua pagamenti di prova con Sandbox Mode attivo, poi disattivalo per accettare pagamenti reali.

OpenCart 4

1. Nel pannello di amministrazione vai su Extensions > Installer, fai clic su Upload e scegli il file wcp_pagseguro_gateway.ocmod.zip. Non rinominare il file: OpenCart 4 ricava il codice dell'estensione dal nome del file, e un pacchetto rinominato non funziona.

2. Il pacchetto compare nell'elenco delle estensioni installate nella stessa pagina. Fai clic su Install (il pulsante verde +) accanto ad esso.

3. Vai su Extensions > Extensions e scegli il tipo Payments. Trova VibeFox PagSeguro Gateway, fai clic su Install (il pulsante verde +), poi su Edit (il pulsante con la matita).

4. Inserisci la chiave di licenza e i token e verifica i pagamenti come nei passaggi da 3 a 5 per OpenCart 3. La pagina delle impostazioni e i suoi campi sono uguali in entrambe le versioni. Cambia soltanto l'URL di notifica (vedi Notification URL); anch'esso viene inviato a PagBank con ogni pagamento.

Una nuova installazione parte con il metodo di pagamento disattivato e la modalità sandbox attiva.

Configurazione

Tutte le impostazioni si trovano nella pagina dell'estensione: Extensions > Extensions > Payments > VibeFox PagSeguro Gateway > Edit. Le sezioni sono elencate a sinistra; il pulsante Save sotto l'elenco salva l'intera pagina. Sopra le impostazioni la pagina mostra la modalità corrente: SANDBOX MODE (i pagamenti vengono creati nella sandbox di PagBank, senza addebiti reali) oppure LIVE (i pagamenti vengono creati con il token di produzione). Ti avvisa quando manca il token della modalità corrente (in tal caso il metodo di pagamento viene nascosto al checkout) e quando la valuta predefinita del negozio non è BRL. Senza il permesso di modificare l'estensione, la pagina mostra le impostazioni ma non può salvarle.

Al salvataggio, Title non può essere vuoto (fino a 128 caratteri), Sort Order deve essere un numero intero (sono ammessi numeri negativi), Total deve essere un numero pari o superiore a 0, e la zona geografica e gli stati dell'ordine devono esistere. Se un valore non è corretto, un errore lo indica e non viene salvato nulla.

PagSeguro / PagBank

Enable / Disable: Enable PagSeguro/PagBank payments attiva o disattiva il metodo di pagamento. Predefinito: disattivato.

Title: il nome del metodo di pagamento che il cliente vede al checkout. È anche il nome del metodo di pagamento salvato nell'ordine. Predefinito: PagSeguro / PagBank. Obbligatorio, fino a 128 caratteri.

Description: il testo mostrato al cliente nel passaggio Confirm Order, sopra il pulsante di conferma. Predefinito: Pay securely via PagSeguro/PagBank. You will be redirected to complete your payment.

Sort Order: la posizione di PagBank tra i metodi di pagamento al checkout. Lascia il campo vuoto oppure inserisci un numero intero.

Geo Zone: offre PagBank solo per gli indirizzi di pagamento nella zona geografica selezionata. Predefinito: All zones. Le zone geografiche si configurano in System > Localisation > Geo Zones. Su OpenCart 4, quando il negozio non richiede un indirizzo di pagamento, viene usato l'indirizzo di spedizione.

Total: il totale del checkout, nella valuta predefinita del negozio, che un ordine deve raggiungere perché venga offerto PagBank. Lascia il campo vuoto per offrire PagBank con qualsiasi importo totale.

Account PagBank

La sezione spiega dove ottenere i token e contiene i collegamenti al tuo account PagBank e alla pagina PagBank sui token.

Sandbox Mode: Enable sandbox/test mode (no real charges). I nuovi pagamenti vengono inviati alla sandbox di PagBank con il token sandbox, e i clienti vedono SANDBOX MODE — Using test environment. No real charges. nel passaggio Confirm Order. Le verifiche dello stato e i rimborsi di un ordine usano sempre l'ambiente e il token con cui è stato creato il suo pagamento. Predefinito: attivo.

Sandbox token: il token sandbox di PagBank. Viene usato finché la modalità sandbox è attiva.

Production token: il token di produzione di PagBank (Bearer). Viene usato quando la modalità sandbox è disattiva. Tienilo segreto.

I token salvati non vengono mai più mostrati. Il campo resta vuoto e mostra Saved — leave empty to keep it. Inserisci un nuovo valore solo se vuoi cambiarlo. Per rimuovere un token salvato, spunta Clear the saved token on save sotto il campo e fai clic su Save.

Notifiche di pagamento

Notification URL: ogni pagamento indica a PagBank di inviare le sue notifiche di checkout e di pagamento a questo URL, quindi non c'è nulla da configurare in PagBank. Su OpenCart 3 ha un formato come https://your-store/index.php?route=extension/payment/wcp_pagseguro_gateway/webhook, su OpenCart 4 come https://your-store/index.php?route=extension/wcp_pagseguro_gateway/payment/wcp_pagseguro_gateway.webhook. È costruito a partire dall'indirizzo del negozio della tua installazione di OpenCart. L'URL deve essere raggiungibile da Internet.

Le notifiche che contengono un header x-authenticity-token vengono verificate con il token dell'ambiente in cui è stato creato il pagamento; una firma non valida viene rifiutata. Il corpo della notifica non è mai considerato attendibile: l'estensione legge sempre il checkout e l'ordine PagBank (stato, importo, valuta) dalle API di PagBank prima che l'ordine cambi. Senza notifiche, l'ordine riceve il suo stato quando il cliente torna nel negozio dopo aver pagato.

Ordini

OpenCart crea l'ordine nel passaggio Confirm Order senza stato (ordine mancante). L'ordine riceve uno stato solo dopo che PagBank ha segnalato il pagamento tramite una notifica o al ritorno del cliente; il pagamento viene sempre riletto da PagBank. Ciascun campo qui sotto elenca i tuoi stati ordine di OpenCart.

Order Status After Payment: lo stato impostato dopo un pagamento PagBank verificato. Predefinito: In lavorazione.

Awaiting PagBank Payment Status: è stato emesso un boleto o un PIX, oppure il pagamento è in analisi (WAITING / IN_ANALYSIS); PagBank conferma il denaro in seguito. Predefinito: In sospeso.

PagBank Payment On Hold Status: il pagamento richiede la tua verifica (vedi Stati dell'ordine). Predefinito: In sospeso, perché OpenCart non ha lo stato On hold. Puoi creare un tuo stato in System > Localisation > Order Statuses e selezionarlo qui.

Payment Declined Status: il pagamento di un ordine in attesa è stato rifiutato. Se PagBank lo segnala pagato più tardi, l'ordine riceve lo stato successivo al pagamento. Predefinito: Fallito.

Payment Cancelled Status: il pagamento di un ordine in attesa è stato annullato in PagBank. Un pagamento che arriva per un ordine in questo stato lo porta nello stato di verifica. Predefinito: Annullato.

Refunded Status: impostato quando il pagamento viene rimborsato per intero dalla pagina dell'ordine o dalla dashboard di PagBank. Predefinito: Rimborsato.

Avanzate

Debug log: scrive le richieste API e le notifiche nel file wc_psg_debug.log.php, nella cartella dei log di OpenCart (storage/logs). Il file non può essere aperto dal web. I log non contengono token né dati dei clienti. Errori e avvisi vengono sempre registrati. Predefinito: disattivato.

Log: mostra la dimensione e le ultime voci del log. Fai clic su Clear log per svuotarlo.

Delete Data on Uninstall: se attivo, la disinstallazione dell'estensione rimuove le impostazioni del gateway e il log. Gli ordini e i loro riferimenti PagBank (necessari per i rimborsi) vengono sempre conservati. Predefinito: disattivato.

Importazione / esportazione

Export: Download JSON salva le impostazioni in un file JSON. I token non vengono esportati.

Import: incolla il JSON esportato in precedenza e fai clic su Import per ripristinare le impostazioni. I token salvati vengono mantenuti.

Checkout

Nel passaggio Payment Method il cliente sceglie il metodo di pagamento (per impostazione predefinita PagSeguro / PagBank). Nel passaggio Confirm Order il cliente vede la tua descrizione e la nota You will be redirected to the PagBank payment page (credit card, PIX, boleto) and returned to the store. OpenCart crea l'ordine in questo passaggio, ancora senza stato. Su OpenCart 4 il cliente sceglie il metodo di pagamento con il pulsante Choose del blocco del metodo di pagamento, nella finestra Payment method options, e fa clic su Confirm Order in fondo alla pagina di checkout. Quando il cliente fa clic su Confirm Order, l'estensione crea un checkout PagBank per il totale dell'ordine in BRL come un unico articolo, Order # con il numero dell'ordine e il nome del tuo negozio (coupon, spedizione e imposte sono inclusi nel totale), e invia il cliente alla pagina di pagamento PagBank. Vengono trasmessi il nome e l'e-mail del cliente, insieme al CPF o al CNPJ (11 o 14 cifre) da un campo personalizzato del cliente o dall'indirizzo di pagamento il cui nome contiene CPF o CNPJ, e un numero di telefono brasiliano. OpenCart non ha un campo CPF per impostazione predefinita; puoi aggiungerne uno in Customers > Custom Fields. Su OpenCart 4, quando il negozio non richiede un indirizzo di pagamento, vengono usati l'indirizzo di spedizione e i suoi campi personalizzati. Il cliente può completare o correggere questi dati nella pagina PagBank e paga con i metodi attivati nel tuo account PagBank. La pagina di pagamento scade dopo 120 minuti.

Dopo il pagamento, il cliente torna al tuo negozio. L'ordine viene segnato come pagato solo dopo la conferma di PagBank: l'estensione legge il pagamento dalle API di PagBank quando arriva la notifica o quando il cliente torna, e l'importo addebitato (senza gli interessi delle rate di PagBank) e la valuta devono corrispondere all'ordine. L'ordine riceve quindi il suo stato nel modo standard di OpenCart, con le consuete e-mail d'ordine e l'aggiornamento del magazzino, e il cliente vede la pagina di successo dell'ordine di OpenCart. Per un boleto o un PIX generato, oppure per un pagamento in analisi, la pagina mostra anche Your PagBank payment is awaiting confirmation (boleto / PIX / analysis). The order will be confirmed as soon as PagBank reports the payment. Per un ordine nello stato di verifica mostra We are confirming your payment with PagBank. The order will be updated automatically — please do not pay again. Se PagBank non ha ancora confermato il pagamento quando il cliente torna, una pagina Payment confirmation mostra lo stesso testo con i pulsanti Check again e Back to checkout.

Se il pagamento non è stato completato, il cliente torna al checkout con The PagBank payment was not completed. You can try again or choose another payment method., The PagBank payment page has expired. You can try again or choose another payment method. oppure The payment was declined by PagBank. Please try again with another card or payment method. Il carrello viene conservato. Su OpenCart 4 questi messaggi vengono mostrati sopra la pagina di checkout. Se un ordine in attesa di un boleto o di un PIX è stato annullato, il cliente vede The PagBank payment was cancelled, so the order was cancelled. Se il carrello è già vuoto (per esempio perché l'ordine aveva raggiunto la pagina di successo prima che il boleto o il PIX scadessero), al checkout non c'è nulla da pagare: al suo posto una pagina Payment confirmation mostra il messaggio; per un ordine non pagato compare The PagBank payment of order #N was not completed (declined, canceled or expired), so the order will not be shipped. To buy these items, please place a new order., con un pulsante Continue.

OpenCart 3 crea un nuovo ordine ogni volta che viene mostrato il passaggio Confirm Order. OpenCart 4 mantiene un solo ordine per il checkout e lo aggiorna, quindi dopo una carta rifiutata, un pagamento non completato o una pagina scaduta il cliente paga lo stesso ordine con un nuovo checkout PagBank. Prima di un nuovo pagamento, l'estensione controlla i precedenti checkout PagBank dello stesso ordine e carrello: un pagamento effettuato su una pagina precedente viene applicato invece di crearne uno nuovo, e se un altro ordine del carrello è pagato o in attesa, il cliente passa alla pagina di successo. Il checkout aperto dell'ordine viene riutilizzato se importo e ambiente sono uguali e non scade entro 10 minuti; altrimenti viene disattivato, quindi non può più essere pagato. Se arriva comunque un secondo pagamento, una nota ti chiede di rimborsarlo.

Se l'ordine è stato pagato e poi chiuso da te (per esempio annullato o rimborsato), il cliente che torna da PagBank non vede la pagina di successo: il cliente torna al checkout con il messaggio Your previous order #(number) was closed by the store. Please confirm the order again to pay with a new order., oppure vede questo messaggio su una pagina Payment confirmation quando il carrello è già vuoto.

Su OpenCart 4 l'ordine resta nel checkout finché non viene mostrata la pagina di successo. Se nel frattempo quell'ordine è stato chiuso, Confirm Order riporta il cliente al checkout con il messaggio corrispondente: i messaggi sul boleto o PIX annullato e sul pagamento rifiutato descritti sopra, Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. oppure, per un ordine pagato e poi chiuso da te, il messaggio sull'ordine chiuso dal negozio. Il successivo Confirm Order paga un nuovo ordine. Se quell'ordine è già pagato o in attesa e il carrello ora contiene altri prodotti o quantità, il messaggio è Your previous order #(number) has already been placed. Your cart has changed: please confirm the new order to pay for it.

Se PagBank non può avviare il pagamento, il cliente resta nel passaggio Confirm Order con un breve messaggio, per esempio PagBank did not accept your billing details (CPF/CNPJ). Please check them and try again. oppure Could not connect to PagBank. Please try again in a moment. Il motivo tecnico viene scritto nel log.

Le notifiche funzionano anche mentre il negozio è in modalità manutenzione: OpenCart 3 lascia passare le richieste delle estensioni di pagamento, e su OpenCart 4 l'estensione aggiunge una startup action che lascia passare le notifiche e il ritorno del cliente da PagBank.

L'estensione non ha un modulo carta sul sito, carte salvate, abbonamenti o pagamenti ricorrenti, né pagamenti divisi o marketplace. I metodi di pagamento e le rate sono quelli configurati nel tuo account PagBank.

Ordini e rimborsi

Stati dell'ordine

No status (missing order): il cliente è stato inviato a PagBank e non ha pagato, la carta è stata rifiutata o la pagina di pagamento è scaduta; il cliente può pagare di nuovo. In Sales > Orders questi ordini vengono mostrati solo con il filtro Order Status impostato su Missing Orders.

Su OpenCart 4 un ordine non pagato del checkout può ricevere lo stato Voided, che OpenCart 4 imposta quando il cliente torna al passaggio Confirm Order. L'estensione tratta questo ordine come un ordine senza stato, e un pagamento successivo lo conferma comunque.

Order Status After Payment (default Processing): il pagamento è stato confermato con l'importo e la valuta previsti. Una nota mostra l'importo, il metodo di pagamento e l'ID dell'addebito PagBank.

Awaiting PagBank Payment Status (default Pending): è stato generato un boleto o un PIX in attesa di pagamento, oppure il pagamento è in analisi. L'ordine passa a Order Status After Payment quando PagBank segnala il pagamento come effettuato.

PagBank Payment On Hold Status (default Pending): PagBank ha segnalato un importo o una valuta diversi da quelli dell'ordine, un pagamento è arrivato dopo che l'ordine era stato annullato (controlla il magazzino, poi completa l'ordine o rimborsa il pagamento in PagBank), oppure un pagamento con carta è stato autorizzato ma non acquisito (acquisiscilo in PagBank). La nota lo spiega. Il denaro effettivamente ricevuto viene registrato per i rimborsi.

Payment Declined Status (default Failed): un pagamento in attesa o in analisi è stato rifiutato.

Payment Cancelled Status (default Canceled): un pagamento in attesa, per esempio un boleto o un PIX scaduto, è stato annullato.

Refunded Status (default Refunded): il pagamento è stato rimborsato per intero, tramite l'estensione o nella dashboard di PagBank.

Ogni stato PagBank viene applicato una sola volta, quindi notifiche o ritorni ripetuti non aggiungono note né cambiano lo stato. Un ordine pagato non torna mai indietro. Se arriva un secondo pagamento per un ordine già pagato, l'ordine non viene modificato e una nota ti chiede di rimborsare il duplicato in PagBank. Le note sono voci della History dell'ordine che il cliente non vede.

Scheda VibeFox PagSeguro Gateway

In Sales > Orders apri un ordine pagato con PagBank. In fondo alla pagina dell'ordine, accanto a History e Additional, la scheda VibeFox PagSeguro Gateway mostra il PagBank checkout con l'etichetta Sandbox per i pagamenti sandbox, gli ID PagBank order e Charge, il Payment method, lo Status, gli importi Paid / refunded, il modulo di rimborso, la cronologia dei rimborsi e le PagBank notes dell'ordine. La scheda viene mostrata agli utenti che hanno accesso all'estensione.

Rimborsi

Nella scheda VibeFox PagSeguro Gateway inserisci l'Amount (l'importo non ancora rimborsato viene compilato automaticamente), facoltativamente un Reason (optional), e fai clic su Refund via PagBank. Conferma la domanda Refund this amount through PagBank? This cannot be undone. Sono supportati rimborsi totali e parziali. Ti serve il permesso di modificare l'estensione (impostato in System > Users > User Groups). Il limite è l'importo addebitato da PagBank, quindi dopo una differenza di importo puoi rimborsare fino a quanto il cliente ha effettivamente pagato, non fino al totale dell'ordine. Il rimborso viene inviato nell'ambiente e con il token con cui è stato effettuato il pagamento. Un rimborso viene registrato solo quando PagBank lo conferma; altrimenti la scheda mostra l'errore, per esempio PagBank refund failed: ... o PagBank did not confirm the refund, e non viene registrato nulla. I rimborsi dei pagamenti con boleto e i rimborsi parziali del PIX seguono le regole di PagBank. Un rimborso riuscito viene aggiunto alla cronologia dei rimborsi e alle note con l'ID dell'addebito. Un rimborso totale imposta l'ordine su Refunded Status senza avvisare il cliente e senza rimettere i prodotti a magazzino, come una modifica manuale dello stato. Un rimborso parziale non cambia lo stato. I rimborsi sono disponibili appena PagBank ha segnalato il pagamento come effettuato.

I resi di prodotti in Sales > Returns non restituiscono denaro tramite PagBank.

I rimborsi effettuati nella dashboard di PagBank vengono rilevati con la notifica o la verifica successiva: un rimborso totale imposta l'ordine su Refunded Status, un rimborso parziale aggiunge una nota con l'importo rimborsato.

Chiave di licenza

L'estensione funziona con una chiave di licenza VibeFox ottenuta su vibefox.net. Il blocco della licenza License — VibeFox PagSeguro Gateway è il primo blocco di Extensions > Extensions > Payments > VibeFox PagSeguro Gateway > Edit, sopra le impostazioni. Incolla la chiave in License key e fai clic su Activate. Dopodiché il blocco mostra la chiave mascherata, lo stato (per esempio la data fino alla quale la licenza è attiva e il tuo dominio) e i pulsanti Check now per verificare di nuovo lo stato, Change key per inserire un'altra chiave e Remove key per rimuovere la chiave da questo negozio. Sotto compaiono la riga Product: opencart-payment-pagseguro e il link Manage licenses and domains in your account, che apre il tuo account vibefox.net. Solo gli utenti amministratori con il permesso Modify per l'estensione possono cambiare la chiave. I testi del blocco seguono la lingua dell'amministrazione (sono inclusi inglese e russo).

Se la chiave non viene accettata, il blocco spiega il motivo, per esempio Key not found, This key belongs to another product, Domain limit reached oppure License expired on seguito da una data. Dopo aver cambiato l'indirizzo del negozio, o dopo aver liberato uno slot di dominio nel tuo account, fai clic su Check now. Se il server delle licenze non è raggiungibile, l'estensione continua a funzionare con l'ultimo stato noto.

Una chiave funziona su un dominio: l'indirizzo del negozio dalla configurazione di OpenCart. Rimuovere la chiave dal negozio non libera il suo slot di dominio. Libera lo slot nel tuo account vibefox.net.

Senza una chiave attiva, PagBank non viene mostrato ai clienti al checkout. Se un pagamento viene avviato comunque, il cliente vede This payment method is not available. Please choose another one. Un utente amministratore che ha effettuato l'accesso all'amministrazione nello stesso browser vede ancora il metodo di pagamento nel negozio, contrassegnato con (unlicensed — visible to admins only), così puoi configurare e provare l'estensione prima di acquistare una chiave. Su OpenCart 4 questa anteprima non è disponibile: il negozio non vede l'accesso dell'amministratore, quindi senza una chiave attiva il metodo di pagamento è nascosto a tutti. Dopo aver aperto una volta la pagina Edit, nella Dashboard dell'amministrazione compare un promemoria. Chiudilo con × per nasconderlo per 7 giorni. Gli ordini esistenti non sono interessati: i pagamenti già avviati vengono comunque confermati e i rimborsi funzionano.

Quando una licenza scade, l'estensione continua a funzionare, ma aggiornamenti e supporto richiedono il rinnovo. Lo stato viene verificato di nuovo automaticamente quando apri la Dashboard dell'amministrazione o la pagina Edit: una volta al giorno per i primi 14 giorni dopo l'inserimento della chiave, poi una volta alla settimana. Non serve alcun cron job. La disinstallazione dell'estensione rimuove sempre la chiave di licenza e lo stato della licenza.

Risoluzione dei problemi

PagBank does not appear at checkout: verifica che la licenza sia attiva, che Enable / Disable sia attivo, che il token della modalità corrente sia impostato (Sandbox token in modalità sandbox e Production token in modalità live) e che il cliente effettui il checkout in BRL. La pagina delle impostazioni mostra un avviso quando il token manca o la valuta del negozio non è BRL. Controlla anche che l'indirizzo di pagamento rientri nella Geo Zone selezionata e che l'ordine raggiunga il Total impostato nelle impostazioni.

The payment went through, but the order stays without a status: PagBank non ha ancora segnalato il pagamento e il cliente non è tornato nel negozio. L'ordine riceverà il suo stato appena arriverà la notifica. Verifica che il tuo negozio sia raggiungibile da Internet all'indirizzo della Notification URL, e attiva il Debug log per vedere le notifiche.

The notification answers Invalid signature: l'x-authenticity-token non corrisponde al token dell'ambiente in cui è stato effettuato il pagamento, oppure quel token non è salvato. Verifica che nelle impostazioni ci sia il token giusto.

The notification answers Verification failed, retry later: non è stato possibile raggiungere le API di PagBank, manca il token dell'ambiente del pagamento, oppure il carrello era in elaborazione da un'altra richiesta nello stesso momento. PagBank ritenterà la notifica.

The notification answers Order not found: la notifica riguarda un ordine che non è stato pagato con questa estensione in questo negozio. Non viene modificato nulla.

The customer sees PagBank payments are temporarily unavailable. Please choose another payment method.: il token della modalità corrente manca o PagBank lo ha rifiutato.

The customer sees PagSeguro/PagBank only accepts payments in Brazilian Real (BRL).: il checkout è in un'altra valuta.

The customer sees This order has no amount to pay.: il totale dell'ordine è zero.

Order is in the review status after payment: leggi le note nella scheda VibeFox PagSeguro Gateway (vedi Stati dell'ordine), confronta gli importi in PagBank, poi evadi l'ordine oppure rimborsa il pagamento.

No refund form in the tab: la scheda indica il motivo: il pagamento non è ancora segnalato come effettuato, è rimborsato per intero, il tuo gruppo utenti non ha il permesso di modificare l'estensione, oppure il token dell'ambiente del pagamento non è impostato.

Refund fails with a message about the token: il pagamento è stato effettuato in sandbox o in produzione, e il token di quell'ambiente manca o è stato rifiutato. Inserisci il token corretto e riprova.

Per gli sviluppatori: prima che il checkout PagBank venga creato, l'estensione attiva l'evento OpenCart wc_psg_checkout_data con il corpo della richiesta, l'ordine e l'ambiente. L'articolo deve restare uguale al totale dell'ordine.

Disinstallazione

Vai su Extensions > Extensions, scegli il tipo Payments e fai clic su Uninstall (il pulsante rosso −) accanto a VibeFox PagSeguro Gateway. La chiave di licenza e lo stato della licenza di questa estensione vengono sempre rimossi. OpenCart rimuove sempre le proprie impostazioni dell'estensione: Enable / Disable, Sort Order, Geo Zone, Total e gli stati degli ordini della sezione Orders, che tornano ai valori predefiniti alla reinstallazione. Viene rimosso anche l'evento OpenCart dell'estensione (su OpenCart 4 anche i suoi eventi e la sua startup action, che lasciano passare le notifiche e il ritorno del cliente in modalità manutenzione). Se Delete Data on Uninstall è attivo, vengono rimosse le altre impostazioni del gateway (titolo, descrizione, modalità sandbox, token, registrazione) e il log. Se è disattivo, vengono conservate per una successiva reinstallazione. I record di pagamenti e rimborsi PagBank vengono sempre conservati, quindi gli ordini pagati in precedenza possono essere rimborsati anche dopo una reinstallazione. Gli ordini esistenti conservano le loro note di pagamento.

Su OpenCart 4, per rimuovere anche i file dell'estensione, vai su Extensions > Installer dopo la disinstallazione e fai clic su Uninstall (il pulsante arancione −) accanto a VibeFox PagSeguro Gateway nell'elenco delle estensioni installate, poi su Delete (il pulsante rosso con il cestino) per rimuovere il pacchetto caricato.

PagSeguro e PagBank sono marchi dei rispettivi proprietari. Questa estensione non è affiliata né approvata da PagSeguro o PagBank.