Autorizzazione e Cattura è un metodo di pagamento che consente di autorizzare il prelievo dei fondi al momento della creazione di un ordine per catturare tali fondi una volta che l'ordine è stato elaborato.
Il principio è semplice: quando il cliente effettua un ordine, viene creata un'autorizzazione di prelievo che convalida il trasferimento dei suoi fondi per 29 giorni. Durante questi 29 giorni, è garantito un “periodo di validità” dei fondi per i primi 3 giorni. Alla scadenza dei 3 giorni, è possibile rinnovare la validità dei fondi ogni 3 giorni per tutta la durata dei 29 giorni.
Una volta trascorso il periodo di 29 giorni, l'autorizzazione scade e l'ordine viene annullato.
| Alla fine del capitolo troverete un glossario dei termini più utilizzati per questo metodo di pagamento. |
Perché attivare questo flusso di pagamento?
Autorizzazione e cattura ti permette di:
- mettere in sicurezza la transazione (l’autorizzazione garantisce la disponibilità dei fondi).
- evitare commissioni su vendite che non avvengono (nessuna commissione di annullamento).
- eliminare i rimborsi in caso di ordine non spedito.
- controllare il tuo inventario vendendo solo gli articoli disponibili.
Compatibilità dei pagamenti
Autorizzazione e Cattura è compatibile solo con questi metodi di pagamento:
- PayPal
- Carta di credito
- Apple Pay
- Google Pay.
Da notare : L’attivazione di Autorizzazione e Cattura disabilita automaticamente gli altri metodi di pagamento.
Come configurare Autorizzazione e Cattura?
Attiva questa modalità dal menu del tuo back office: Pagamento > Metodi di pagamento quindi nella sezione Moduli di pagamento attivi, clicca sul “CTA configura” del modulo PrestaShop Checkout. Completa la configurazione nella scheda Impostazioni avanzate.
Da notare : l’attivazione disabilita automaticamente gli altri metodi di pagamento locali.
Nella scheda Impostazioni avanzate, attiva “Autorizzazione e Cattura” quindi seleziona il tuo metodo di cattura:
- Cattura istantanea (predefinita) : catturi automaticamente i fondi al momento del pagamento. I fondi saranno raccolti automaticamente quando l’ordine viene registrato.
- Cattura automatica per stato : puoi scegliere lo/degli stato/i dell’ordine che attiverà/anno la cattura automatica dei fondi.
- Esempio: se scelgo lo stato “Spedito” i fondi saranno catturati quando lo stato dell’ordine è “Spedito”.
Importante : Se nessuno stato è selezionato, l’ordine sarà catturato per tutti gli stati predefiniti.
Come gestire le autorizzazioni sugli ordini?
Dal tuo back-office nella sezione “ordini”, individua l’ordine che desideri catturare. Scorri fino al riquadro dedicato al pagamento (vedi sotto) per trovare l’elenco delle transazioni.
Quando espandi ogni transazione, troverai i dettagli di ciascuna con il relativo importo:
- Autorizzazione in attesa
- Troverai il periodo di autorizzazione che ti permette di vedere le date di creazione dell’autorizzazione, la validità della cattura e quindi la scadenza.
- Pagamento
- Rimborsato parzialmente
- Rimborsato
Hai 3 azioni; puoi:
- autorizzare nuovamente il periodo di validità di 3 giorni,
- catturare i fondi immediatamente nell’ordine
- oppure annullare la cattura.
Per fare ciò, puoi andare sull’ordine su cui desideri fare un’azione, quindi scorrere l’elenco delle transazioni e aprire i dettagli della transazione.
Cliccare su Ri-autorizza ti permette di estendere il periodo di validità di 3 giorni durante il quale PayPal garantisce la disponibilità dei fondi. Si aprirà una finestra PayPal per confermare la richiesta di ri-autorizzazione.
Cliccare su Cattura ti permette di catturare i fondi immediatamente. Il pagamento sarà prelevato/eseguito immediatamente. Si aprirà una finestra PayPal per confermare la richiesta di cattura.
Cliccare su Annulla ti permette di annullare l’autorizzazione alla cattura e quindi di rimettere i fondi sul conto del cliente. Si aprirà una finestra PayPal per confermare l’annullamento.
Da notare : una volta confermato l’annullamento, non potrai più catturare l’importo. L’ordine è definitivamente annullato.
Prossimamente : Potrai presto catturare solo una parte dell’importo di un ordine. Per essere informato al rilascio di questa funzionalità, contattaci all’indirizzo: pscheckout@prestashop.com
Cosa fare se la cattura fallisce?
Un messaggio di errore sarà mostrato nel tuo back-office. Se il messaggio riguarda:
- Un errore tecnico : riprova la cattura più tardi. Se l’errore persiste, puoi contattare il nostro help center tramite questo modulo.
- Un fallimento del pagamento (dovuto a un metodo di pagamento rifiutato) : la cattura è impossibile e l’ordine viene annullato. Per richiedere il pagamento al cliente, crea un link di pagamento dal dashboard PayPal tramite Request Money.
Come effettuare un rimborso?
Dall’ordine interessato, vai in fondo alla pagina nella lista delle transazioni, quindi clicca su “Rimborso”. Si aprirà una finestra PayPal. Inserisci l’importo da rimborsare e conferma. Un messaggio di conferma apparirà sul tuo schermo.
Da notare : il rimborso è possibile solo se la transazione è nello stato “completato” o “rimborso parziale”.
Alcune buone pratiche
Gestione del periodo di garanzia
- Per beneficiare del periodo di garanzia, ricordati di catturare i tuoi fondi nei primi 3 giorni.
- Non hai catturato i tuoi fondi nei primi 3 giorni? Rinnova l’autorizzazione per ulteriori 3 giorni.
- Controlla le date di scadenza (massimo 29 giorni) per evitare la perdita dell’autorizzazione.
Gestione degli stati “in attesa” (pending)?
- Un’autorizzazione PENDING/IN ATTESA si risolve generalmente entro 24 a 72 ore.
- Dopo 72 ore, considera l’autorizzazione come rifiutata e contatta il cliente.
- Non aspettare 29 giorni per risolvere uno stato PENDING/IN ATTESA.
Comunicazione con il cliente
- Informa i tuoi clienti che il pagamento sarà addebitato solo alla spedizione, non al momento dell’ordine. (link alla configurazione delle email o almeno segnalarlo).
- Spiega che vedranno una “trattenuta” sul loro conto ma non un addebito immediato.
- Avvisali in caso di modifica dell’importo prima della cattura finale.
Dettagli dei diversi stati
Le diverse tabelle ti forniscono le informazioni necessarie sugli stati per comprendere e seguire l’avanzamento di un pagamento passo dopo passo.
Dettagli degli stati relativi a un ordine
| Valore (Enum) | Descrizione |
|---|---|
| CREATED | L’ordine è stato creato con il contesto specificato. |
| APPROVED | Il cliente ha approvato il pagamento tramite il suo portafoglio PayPal o un’altra forma di pagamento (carta, conto bancario, ecc.). |
| VOIDED | Tutte le unità di acquisto dell’ordine sono state annullate. |
| COMPLETED | L’intenzione dell’ordine è stata finalizzata ed è stata creata una risorsa di pagamento. Importante : Verifica lo stato del pagamento in purchase_units[].payments.captures[].status prima di evadere l’ordine. |
Dettagli degli stati relativi a un’autorizzazione
| Valore (Enum) | Descrizione |
|---|---|
| CREATED | L’autorizzazione è in attesa di revisione manuale. |
| CAPTURED | Il pagamento è stato catturato con successo. |
| DENIED | PayPal non può autorizzare i fondi per questo pagamento. |
| PARTIALLY_CAPTURED | È stato effettuato un pagamento parziale per un importo inferiore all’autorizzazione iniziale. |
| VOIDED | L’autorizzazione è stata annullata. Non è più possibile effettuare catture su questa autorizzazione. |
| PENDING | L’autorizzazione è in attesa. Vedi status.details per maggiori informazioni. |
Dettagli degli stati relativi a una cattura
| Valore (Enum) | Descrizione |
|---|---|
| COMPLETED | I fondi sono stati accreditati sul conto PayPal del beneficiario. |
| DECLINED | I fondi non sono stati catturati. |
| PARTIALLY_REFUNDED | Un importo inferiore all’importo totale della cattura è stato rimborsato al pagatore. |
| PENDING | I fondi non sono ancora stati accreditati. Consulta status.details per maggiori dettagli. |
| REFUNDED | Un importo uguale o superiore all’importo catturato è stato rimborsato al pagatore. |
| FAILED | Si è verificato un errore durante la cattura del pagamento. |
Dettagli degli stati relativi ai rimborsi
| Valore (Enum) | Descrizione |
|---|---|
| CANCELLED | Il rimborso è stato annullato. |
| FAILED | Il rimborso non è stato elaborato. |
| PENDING | Il rimborso è in attesa. Vedi status_details.reason. |
| COMPLETED | I fondi sono stati addebitati e restituiti al cliente. |
Gestione degli errori durante le operazioni automatiche
In caso di problema su una transazione, un messaggio di errore viene visualizzato in cima allo schermo e lo stato dell’ordine viene aggiornato automaticamente:
- Errore di pagamento : questo stato viene applicato se l’autorizzazione o la cattura non è possibile. Se il rifiuto avviene durante la cattura, ti consigliamo di contattare il cliente (verifica dei fondi o della validità della carta).
- Autorizzazione scaduta : questo stato indica che il termine di validità dell’autorizzazione è superato e i fondi non sono più riservati.
Gestione degli errori durante le operazioni manuali
Se un’azione manuale fallisce, viene visualizzato un messaggio di errore dettagliato sullo schermo per guidarti direttamente. Questo può accadere durante le seguenti operazioni:
- Cattura : impossibile convalidare l’incasso.
- Ri-autorizzazione : fallimento del rinnovo della validità del pagamento.
- Annullamento : impossibile annullare l’autorizzazione in corso.
- Rimborso : fallimento della restituzione dei fondi al cliente.
Questa funzionalità ti offre una gestione di pagamento flessibile e adatta alle esigenze logistiche e commerciali della tua attività, garantendo la sicurezza delle transazioni per te e i tuoi clienti.
La gestione dei webhook
Per gestire efficacemente i diversi webhook legati a PayPal, ecco una tabella riepilogativa dei diversi eventi:
| Eventi Webhook | Descrizione |
|---|---|
PAYMENT.AUTHORIZATION.CREATED |
L’autorizzazione è stata creata. I fondi sono bloccati sul conto del cliente. |
PAYMENT.CAPTURE.COMPLETED |
La cattura è riuscita. Il denaro è stato trasferito sul tuo conto PayPal. |
PAYMENT.CAPTURE.DENIED |
La cattura è stata rifiutata (es: fondi insufficienti al momento finale). |
PAYMENT.AUTHORIZATION.VOIDED |
L’autorizzazione è stata annullata o è scaduta (termine superato). |
PAYMENT.CAPTURE.REFUNDED |
Un rimborso è stato effettuato su questa transazione. |
PAYMENT.CAPTURE.REVERSED |
PayPal ha annullato la cattura (spesso a causa di una controversia o frode). |
Per maggiori dettagli riguardo ai webhook, consulta la documentazione PayPal qui sotto:
- https://developer.paypal.com/docs/checkout/standard/customize/authorization/#how-it-works
- https://developer.paypal.com/api/rest/webhooks/event-names/#link-paymentsv
Glossario
- Autorizzazione : L’autorizzazione permette di “bloccare” i fondi sul conto del tuo cliente per 3 giorni.
- Cattura : La cattura permette di recuperare i fondi sul tuo conto.
- Scaduto : Il termine di 29 giorni è scaduto, l’ordine è annullato.
- Annullato : L’ordine è annullato.
- Ri-autorizzazione : La ri-autorizzazione permette di “bloccare” nuovamente i fondi sul conto del tuo cliente per 3 giorni.