Passa al contenuto principale
In questa pagina

Le catture parziali multiple (MPC) consentono di autorizzare un importo una volta e di catturarlo in più richieste. Utilizzarle quando la consegna avviene in fasi, ad esempio quando i biglietti vengono confermati, i prodotti vengono spediti o vengono completate le tappe del servizio.

L'MPC è configurato per ogni connessione al processore. La connessione deve supportare l'autorizzazione e la cattura, e DEUNA deve attivare la modalità operativa appropriata per tale connessione.

Per utilizzare l'MPC, integrare con Crea pagamenti V2 e creare il pagamento utilizzando l'autorizzazione anziché la cattura automatica.

Scegliere una modalità operativa#

ModalitàQuando si contatta il processoreLimite gestito da DEUNAfinal_capture comportamento
Online OnlineOgni richiesta di autorizzazione viene inviata immediatamente al processore.No.Ignorata dal flusso online MPC. La sequenza termina quando l'importo totale autorizzato raggiunto o secondo le regole del processore.
OfflineLe richieste non finali vengono memorizzate in buffer. DEUNA invia l'importo accumulato quando la sequenza termina.Sì.Termina la sequenza e invia l'importo accumulato.

La modalità online è appropriata solo quando la connessione al processore supporta nativamente più autorizzazioni. La modalità offline è la modalità di compatibilità gestita da DEUNA e può essere selezionata anche per un processore con MPC nativo quando l'attività richiede il raggruppamento.

Ciclo di vita offline MPC#

  1. Il pagamento raggiunge authorized.
  2. Ogni richiesta non finale viene validata rispetto all'importo autorizzato rimanente e memorizzata senza chiamare il processore.
  3. Mentre uno o più importi sono in buffer, il pagamento è partial_capturing.
  4. DEUNA chiude la sequenza quando si verifica una delle seguenti condizioni:
    • L'importo totale richiesto raggiunge l'importo autorizzato.
    • Una richiesta include "final_capture": true.
    • Il limite di autorizzazione salvato è raggiunto.
  5. DEUNA invia l'importo netto accumulato al processore come una singola operazione di autorizzazione.
  6. Se l'importo totale confermato è uguale all'importo autorizzato, il pagamento diventa captured. Se l'importo totale confermato è inferiore, diventa partial_captured.

Chiudere una sequenza al di sotto dell'importo autorizzato indica che la sequenza di autorizzazione di DEUNA è completa. Le richieste successive vengono rifiutate. Consultare il proprio Technical Account Manager (TAM) di DEUNA per conoscere il metodo con cui viene rilasciata la restante autorizzazione dal processore selezionato.

Chiudere la sequenza tramite l'API

Invia final_capture come un valore booleano JSON, non come stringa:

JSON
{
  "amount": 100,
  "final_capture": true
}

Il amount è l'importo della richiesta di addebito. In modalità offline, DEUNA lo aggiunge agli importi di addebito precedentemente memorizzati prima di inviare la richiesta consolidata al processore.

Limite di tempo e cutoff per la cattura#

Le regole per il cutoff di cattura offline sono le seguenti:

  • Configura un numero intero da 1 a 45 giorni di calendario.
  • DEUNA salva la scadenza assoluta in capture_cutoff_at . Per il pagamento, utilizzare questo timestamp, quando viene restituito, come fonte attendibile anziché calcolare localmente la scadenza.
  • Nei flussi di autorizzazione che definiscono il momento in cui l'autorizzazione viene completata, l'orologio inizia al momento dell'autorizzazione. Se non esiste ancora un limite di tempo, il flusso di cattura lo stabilisce quando viene elaborata la prima transazione non finale.
  • La scadenza è la fine del giorno di riferimento nel calendario, non un numero esatto di periodi di 24 ore dopo la richiesta.
  • Le successive transazioni parziali non estendono né resettano la data di scadenza salvata.
  • La modifica della configurazione di connessione non sovrascrive una scadenza già salvata per un pagamento esistente.
  • Quando viene raggiunta la scadenza salvata, il pagamento diventa disponibile per l'elaborazione da parte del processo di chiusura della sequenza. L'elaborazione non è garantita nell'ultimo secondo del giorno, quindi non fare affidamento su un periodo di grazia per altri commercianti.

Il pagamento MPC online non ha una scadenza di elaborazione da parte di DEUNA. I limiti di validità dell'autorizzazione e di elaborazione del processore continuano ad applicarsi.

Importo e regole della sequenza#

  • L'importo totale di elaborazione non può superare l'importo autorizzato, dopo eventuali operazioni di annullamento che influiscono sul saldo disponibile.
  • Il raggiungimento dell'importo autorizzato determina automaticamente la finalizzazione della richiesta; final_capture in questo caso, non è necessario.
  • Una finalizzazione offline di elaborazione inferiore all'importo autorizzato richiede che il processore supporti l'elaborazione parziale.
  • Dopo che un'operazione di finalizzazione è stata eseguita, DEUNA non accetta ulteriori elaborazioni per quella sequenza.
  • DEUNA non impone un limite al numero di richieste per le transazioni in modalità offline. I limiti effettivi sono l'importo, il cutoff, le regole di connessione e del processore.

Calcola sempre il pagamento in base all'importo confermato. Una transazione in modalità offline non rappresenta il denaro raccolto dal processore.

Gestione dello stato e degli errori#

StatoSignificato in un flusso MPCAzione del commerciante
authorizedI fondi sono riservati e non ci sono transazioni parziali in attesa.Invia le transazioni idonee prima che l'autorizzazione scada.
partial_capturingUna o più transazioni con importi sono in attesa o in buffer.Mantieni separati gli importi in attesa e confermati; non considerare l'importo in buffer come denaro raccolto.
capturingL'importo totale accumulato viene addebitato.Attendi il risultato definitivo.
partial_capturedUn importo inferiore all'autorizzazione è stato confermato dal processore.Registra l'importo confermato. Non creare una nuova transazione se la sequenza è stata completata.
capturedL'importo totale autorizzato è stato addebitato.Registra il completamento della transazione.

Un timeout o una richiesta asincrona accettata non dimostrano che la transazione è andata a buon fine o meno. Recupera la transazione e elabora i webhook di DEUNA fino a quando non è disponibile uno stato confermato. Una transazione online fallita mantiene lo stato della transazione precedentemente confermato, mentre l'operazione fallita rimane visibile nella cronologia delle transazioni.

Per la tabella completa di transizione, vedere Flusso di lavoro di pagamento & Stati. Per richieste sovrapposte, vedere Acquisizione e rimborso contemporaneamente.

Configura MPC#

Collabora con il tuo rappresentante tecnico DEUNA per configurare la connessione:

ImpostazioneOnline OnlineOffline
Stato della funzionalitàObbligatorioObbligatorio
Modalità operativaonlineoffline
Cutoff per le transazioniNon utilizzato da DEUNAObbligatorio: 1–45 giorni calendari
Capacità del processorePrelievo parziale e multiplo nativoSupporto per il prelievo: è richiesto anche il prelievo parziale quando l'importo totale finale può essere inferiore all'autorizzazione

Nell'Admin, utilizzare i dettagli dell'ordine per monitorare le richieste di prelievo, l'importo accumulato, l'importo autorizzato rimanente e il limite di taglio, se disponibile. Attivazione, credenziali e limiti del processore possono variare per paese e connessione.