Flusso di pagamento con carta
Siga il flusso di acquisto, autorizzazione, 3DS, revisione, cattura, annullamento e rimborso senza mescolare l'autenticazione con il successo del pagamento.
In questa pagina
I pagamenti con carta utilizzano un acquisto a un solo passaggio o un modello di autorizzazione e cattura a due passaggi. Legga il valore corrente da payment.data.status; se il pagamento si trova all'interno di una risposta dell'ordine, consultare order.payment.data.status.
Utilizzi questa pagina per il percorso specifico per la carta. Per ogni definizione di stato e transizione diretta consentita, consulti Flusso e stati di pagamento.
Acquisto e autorizzazione#
La connessione del processore configurata determina se DEUNA esegue un acquisto o un'autorizzazione. Una sfida 3DS può precedere entrambe le operazioni.
| Stato | Significato | Azione del commerciante |
|---|---|---|
pending | Il pagamento con carta esiste, ma il routing, l'autenticazione o l'elaborazione potrebbero non essere iniziati. | Seguici next_action quando presente e mantenga la finalizzazione bloccata. |
pending_3ds | L'autenticazione dell'emittente è incompleta. | Completare la sfida e quindi valutare lo stato di pagamento nuovo. |
processing | Una richiesta di acquisto è in corso. | Aspetta. processed o un altro risultato autorizzato. |
authorizing | Una autorizzazione a due passaggi è in corso. | Aspetta. authorized o un altro risultato autorizzato. |
processed | Un acquisto completato e i fondi sono stati raccolti. | Applica la politica di finalizzazione; il pagamento può comunque essere rimborsato. |
authorized | I fondi sono stati riservati, non raccolti. | Cattura o annulla entro i limiti della connessione del processore. |
3DS e OTP
L'autenticazione di successo consente solo al flusso di carta di continuare. Non prova che un acquisto o un'autorizzazione siano andati a buon fine. Dopo la sfida, attenda processed, authorized, o un altro stato di pagamento segnalato.
Alcuni adattatori di processore utilizzano pending_otp internamente. L'elaborazione di pagamento corrente normalizza che il risultato al pubblico pending e fornisce i metadati successivi richiesti. Se un vecchio report o un filtro di ricerca contiene pending_otp, trattalo come in attesa di azione del cliente, non come successo di pagamento.
Revisione e retry#
manual_review sospende la finalizzazione fino a quando una decisione di rischio non produce un nuovo stato di pagamento. Una revisione approvata può continuare a processed o captured; una revisione respinta può produrre denied. Vedi Flusso di lavoro e stato delle frodi per i campi e le decisioni di frode separati.
denied descrive il tentativo fallito, ma la macchina a stati dei pagamenti può reindirizzare o riprovare lo stesso pagamento in pending, pending_3ds, processingo authorizing. Non finalizzare un tentativo rifiutato e non modellare denied come uno stato di pagamento terminale.
Cattura un'autorizzazione#
La cattura converte i fondi riservati in fondi raccolti. Il processore, l'importo autorizzato rimanente, i limiti di tempo e la configurazione del commerciante determinano quali operazioni di cattura sono ammissibili.
La macchina a stati può anche ricevere captured o partial_captured direttamente senza esporre lo stato corrispondente "-ing". Le notifiche sono snapshot autoritativi, non una sequenza garantita evento per evento.
Per i modelli di cattura parziale, la concorrenza supportata, i limiti di tempo e final_capture# Vedi # MPC — Catture parziali multiple.
Annullare un'autorizzazione#
Annulla i fondi riservati. È diverso da un rimborso, che restituisce i fondi che sono già stati raccolti.
Il successo API Void restituisce HTTP 204 No Content. Quando il processore completa in modo asincrono, utilizzi lo stato di pagamento successivo come risultato.
Rimborsa i fondi raccolti#
Un acquisto, una cattura completa o una cattura parziale possono essere rimborsati quando la connessione e l'importo rimasto rimborsabile lo consentono.
Un rimborso fallito può ripristinare processed, capturedo partial_captured. Conservi il pagamento riuscito e il tentativo di rimborso fallito separatamente. Consulti MPR — Rimborsi multipli parziali per i modi nativi e aggregati DEUNA, i limiti di tempo, la concorrenza e il comportamento del saldo rimanente.
Elenco di controllo dell'integrazione#
- Mantiene la finalizzazione bloccata per
pending,pending_3ds,processing,authorizingemanual_review. - Consider l'autenticazione e l'accettazione della richiesta come prove intermedie, non come conferma finanziaria.
- Memorizza gli importi confermati e gli identificatori delle operazioni con ogni aggiornamento dello stato.
- Recupera il pagamento definitivo dopo un timeout o una risposta ritardata del fornitore.
- Usa il riferimento di transizione convalidato quando si gestiscono tentativi di ripetizione o percorsi di riconciliazione non visualizzati nel flusso normale.