Come funzionano i pagamenti

Scopri come funzionano i pagamenti all'interno del flusso di pagamento

In Voucherly, un pagamento è un'entità logica che gestisce l'esperienza di checkout dell'utente. Ogni pagamento può includere più transazioni, dove ogni transazione rappresenta un tentativo di pagamento tramite uno specifico gateway di pagamento.

In genere, l'elaborazione dei pagamenti di Voucherly segue un approccio in due fasi:

• Autorizzazione. Dopo che il cliente ha fornito i propri dati di pagamento, il sistema verifica la disponibilità dei fondi e li mette in sospeso.
• Cattura. I fondi trattenuti vengono quindi prelevati dal conto del cliente, elaborati e trasferiti sul conto del merchant.

Questo processo garantisce un flusso di pagamento sicuro e affidabile.

Separare l'autorizzazione e la cattura è utile quando sono necessarie azioni aggiuntive tra la conferma della capacità di pagare del cliente e l'incasso del pagamento. Ad esempio, se vendi articoli con disponibilità limitata, potresti dover verificare che l'articolo sia ancora disponibile prima di catturare il pagamento e completare l'ordine. Puoi seguire questo flusso di lavoro:

1. Verifica che Voucherly abbia autorizzato il metodo di pagamento del cliente.
2. Controlla il tuo sistema di gestione del magazzino per verificare che l'articolo sia ancora disponibile.
3. Aggiorna il tuo sistema di magazzino per registrare che l'articolo è stato acquistato.
4. Cattura il pagamento del cliente.
5. Comunica al cliente sulla pagina di conferma se l'acquisto è andato a buon fine.

Consulta Separare autorizzazione e conferma per informazioni più tecniche.

avvertenza

I gateway di pagamento dei buoni pasto non supportano il processo a due fasi, e nemmeno il wallet, la quota prepagata e alcuni provider — tra cui Satispay, SumUp e Adyen. Le loro transazioni vengono catturate al checkout, quindi un Payment pagato solo con questi è Confirmed appena il cliente paga, mentre un Payment pagato con carta o PayPal resta Paid finché non lo confermi. La tua integrazione dovrebbe leggere lo status del Payment invece di dedurlo dal metodo di pagamento.

suggerimento

Puoi definire il comportamento predefinito in Impostazioni > Pagamenti > Gateway di pagamento > Contabilizzazione automatica. Quando è abilitata, tutte le transazioni vengono catturate automaticamente al termine di un pagamento.

Quando un Payment si chiude

Un Payment può essere pagato con più di una Transaction — un buono pasto per una parte dell'importo, una carta per il resto. completionMode, impostato in Create a Payment, decide quando il Payment smette di chiedere altro:

• Standard (default). Il Payment si chiude quando l'intero importo è coperto. Dopo una Transaction parziale il checkout chiede l'importo residuo con un altro metodo di pagamento.
• Partial. Il Payment si chiude con la prima Transaction riuscita, qualunque importo copra, e il residuo non viene incassato. Usalo quando il resto si salda altrove — alla cassa, o con un Payment successivo.
• AnyTransaction. Come Partial.

Stati del pagamento

I pagamenti hanno un campo status che riflette gli stati delle relative transazioni.

• Requested. È stato creato un pagamento ma non esiste ancora alcuna transazione.
• Paid. Il cliente ha completato con successo il checkout. Almeno una transazione è nello stato Paid e attende il completamento.
• Confirmed. Il pagamento è andato a buon fine e tutte le transazioni sono state confermate.
• Refunded. Tutte le transazioni sono state rimborsate o annullate.
• Cancelled. Tutte le transazioni sono state annullate.
• Voided. Il Payment è stato invalidato (voided) mentre era ancora Requested, dal cliente durante il checkout o da te con Void a Payment. Tutte le transazioni sono state invalidate.
• Expired. Il pagamento è scaduto.

In breve: un Payment passa da Requested a Paid quando il cliente completa il checkout e a Confirmed quando i fondi vengono catturati. Void a Payment funziona solo su un Payment Requested; una volta Paid o Confirmed, la strada a ritroso è Refund a Payment, che annulla le autorizzazioni non ancora catturate e rimborsa quelle catturate.

Stati della transazione

Lo stato di una transazione è determinato dal campo status.

• Requested. È stato creato un nuovo oggetto transazione ma non è ancora stato pagato.
• Paid. La transazione è stata autorizzata. I fondi restano bloccati fino alla conferma (Confirm Payment API) o allo scadere dell'intervallo di tempo definito dalla configurazione del gateway di pagamento.
• Confirmed. La transazione è stata catturata (capture). I fondi precedentemente bloccati sono stati trasferiti sul conto del merchant.
• Refunded. Una transazione nello stato Confirmed è stata completamente rimborsata.
• Dropped. La transazione è stata rilasciata.
• Cancelled. Una transazione nello stato Paid è stata annullata, sbloccando i fondi.
• Failed. Il gateway di pagamento non è riuscito a elaborare la transazione.
• Voided. Una transazione Paid è stata invalidata (voided) a causa di un errore o dell'annullamento del pagamento da parte del cliente.
• Expired La transazione è scaduta.
• ImpossibleRefund. Non è stato possibile elaborare un rimborso per la transazione. È comune per i gateway di pagamento dei buoni pasto.