MPR - Rimborsi multipli parziali
Configurare e gestire i rimborsi parziali multipli gestiti da DEUNA, inclusi l'aggregazione, le regole di scadenza, i rimborsi finali, gli stati e i limiti di importo.
In questa pagina
I rimborsi parziali multipli (MPR) consentono a un esercente di inviare più richieste di rimborso parziale mentre DEUNA invia al processore un unico rimborso accumulato. È la modalità di compatibilità gestita da DEUNA per le connessioni che non possono ricevere più operazioni di rimborso o per le quali l'elaborazione dei rimborsi richiede l'aggregazione.
MPR è configurato per ogni connessione al processore. È diverso dai rimborsi multipli nativi: con il supporto nativo, ogni rimborso idoneo può essere inviato al processore in modo indipendente; con MPR, le richieste non finali rimangono in attesa in DEUNA fino alla chiusura della sequenza.
Ciclo di vita di MPR#
- Inizia da un pagamento con un importo rimborsabile confermato, ad esempio
processed,capturedopartial_captured. - Invia una richiesta di rimborso parziale.
- DEUNA convalida la richiesta rispetto al saldo rimborsabile cumulativo e la memorizza senza chiamare il processore.
- Mentre uno o più importi di rimborso sono in attesa, il pagamento è
partial_refunding. - DEUNA chiude la sequenza quando si verifica una delle seguenti condizioni:
- L'importo richiesto cumulativo raggiunge l'importo rimborsabile totale.
- Una richiesta include
"final_refund": true. - Viene raggiunta la scadenza di rimborso salvata.
- DEUNA invia l'importo accumulato in attesa al processore come una singola operazione di rimborso.
- Se l'importo confermato corrisponde all'intero importo rimborsabile, il pagamento diventa
refunded. Se restituisce solo una parte di tale importo, il pagamento diventapartial_refunded.
Una richiesta in attesa registra l'intento di rimborso; non prova che i fondi sono stati restituiti al cliente.
Scadenza e limiti di tempo per il rimborso#
La scadenza del rimborso MPR ha le seguenti regole:
- Configura un numero intero da 1 a 45 giorni di calendario.
- L'orologio inizia quando la prima richiesta di rimborso non finale viene registrata.
- DEUNA salva la scadenza assoluta in
refund_cutoff_at. I rimborsi parziali successivi non la estendono né la reimpostano. - La scadenza è la fine del giorno calendario di destinazione, non lo stesso orario dopo un numero fisso di giorni.
- 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 idoneo per l'esecuzione del worker di scadenza per inviare l'importo accumulato di rimborso. L'elaborazione non è garantita esattamente al secondo finale del giorno, quindi non fare affidamento su un periodo di grazia per altri rimborsi di terze parti.
Ad esempio, con una scadenza di un giorno, una prima richiesta di rimborso non finale registrata di lunedì è idonea per l'elaborazione della scadenza dopo la fine di martedì. Non è programmata per lo stesso orario di martedì.
Chiudere la sequenza tramite l'API#
Usa final_refund per inviare la richiesta corrente e tutti gli importi precedentemente accumulati senza attendere la scadenza. Inviare come JSON booleano:
{
"amount": 100,
"reason": "Item returned",
"final_refund": true
}Il raggiungimento dell'importo rimborsabile completo chiude automaticamente la sequenza; final_refund in questo caso, non è necessario.
Importo e regole della sequenza#
- L'importo totale richiesto di rimborso non può superare l'importo rimborsabile confermato.
- DEUNA include i precedenti rimborsi in attesa durante la convalida di ogni nuova richiesta.
- Un'operazione di rimborso finale chiude la sequenza MPR. Le richieste successive di rimborso per quella sequenza vengono rifiutate.
- DEUNA non impone un limite al numero di richieste di MPR in attesa. L'importo rimborsabile e la scadenza sono i limiti effettivi della piattaforma.
- Non calcolare il saldo rimanente solo in base all'ultima risposta. Utilizzare l'ultimo pagamento, la cronologia delle operazioni e gli importi confermati, soprattutto quando le richieste possono sovrapporsi.
- Se l'operazione di cattura è ancora in sospeso, l'idoneità al rimborso è specifica per la connessione. Non effettuare un rimborso per un importo non confermato a meno che DEUNA non abbia approvato il comportamento di cattura e rimborso simultaneo per la connessione.
Gestione dello stato e degli errori#
| Stato | Significato in un flusso MPR | Azione del commerciante |
|---|---|---|
processed, capturedo partial_captured | Un importo confermato può essere idoneo al rimborso. | Calcolare il rimborso rispetto al saldo rimborso confermato. |
partial_refunding | Uno o più importi di rimborso sono in attesa o in elaborazione. | Mantenere il rimborso non risolto e attendere la conferma. |
refunding | Il saldo completo o rimanente rimborsabile è in elaborazione. | Attendi il risultato definitivo. |
partial_refunded | Un importo parziale è stato confermato dal processore. | Registrare l'importo restituito confermato e riconciliare il saldo rimanente. |
refunded | L'intero saldo rimborsabile è stato restituito. | Registrare il completamento definitivo del rimborso. |
Se l'elaborazione o la chiamata al processore falliscono, non contrassegnare il pagamento come rimborsato localmente. DEUNA può tentare di rieseguire il lavoro di cutoff idoneo, mentre ripetuti fallimenti non risolti richiedono una revisione operativa. Recuperare il pagamento e consumare i webhook fino a quando l'operazione non raggiunge uno stato confermato. Un timeout da solo non rappresenta un risultato finale di rimborso.
Per la tabella completa di transizione, vedere Flusso di lavoro di pagamento & Stati. Per richieste sovrapposte, vedere Acquisizione e rimborso contemporaneamente.
Configurare MPR#
Collabora con il tuo rappresentante tecnico DEUNA per configurare la connessione:
| Impostazione | Requisito |
|---|---|
| Stato della funzionalità | MPR abilitato per la connessione del processore selezionata |
| Cutoff per il rimborso | Obbligatorio: 1–45 giorni calendari |
| Capacità del processore | Supporto per il rimborso dell'importo accumulato finale |
Nell'Admin, utilizzare i dettagli dell'ordine e la cronologia delle operazioni di rimborso per monitorare le richieste in attesa, l'importo accumulato del rimborso, il saldo rimborso rimanente e il cutoff programmato, se disponibile.
MPC e MPR possono essere abilitati sulla stessa connessione. I loro cutoff di cattura e rimborso sono indipendenti; l'aggiornamento di uno non influisce sull'altro.