Transaction state
Overview
Per poter verificare, tramite Fabrick Dashboard, lo stato, i dettagli e gli eventi di una transazione, bisogna fare riferimento alla relativa documentazione.
Nello specifico:
Per poter verificare, tramite API, lo stato, i dettagli e gli eventi di una transazione è necessario utilizzare la chiamata REST payment/detail.
La lettura corretta deriva dalla combinazione di:
transactionResulttransactionStatetransactionErrorCode
In pratica:
| Informazione | A cosa serve |
|---|---|
transactionResult | Indica l’esito della transazione. |
transactionState | Indica la fase tecnica corrente raggiunta dalla transazione. |
transactionErrorCode | Indica l’eventuale codice di errore. |
| Eventi della transazione | Catture, cancellazioni e storni rappresentano le operazioni avvenute sulla transazione |
Una transazione con transactionResult = APPROVED e transactionState = MOV implica che una cattura è stata richiesta, ma l'effettivo accredito va verificato con chi procede alla liquidazione.
Transaction state
| transactionResult | transactionState | transactionErrorCode | Significato |
|---|---|---|---|
UNSUBMITTED | - | - | Istanza creata, non è ancora stato scelto un metodo di pagamento. |
WAITING | - | - | Metodo scelto e in attesa di risposta. Previsto solo se viene usata la payment/submit |
AUTHENTICATED | - | - | Possibile solo nello scenario carta di richiesta di sola autenticazione. Non-Payment Authentication (NPA) |
PENDING | AUT | 0 | Pagamento avviato, in attesa di esito OK/KO. Tipico dei metodi asincroni. |
APPROVED | AUT | 0 | Transazione autorizzata. |
APPROVED | PRE | 0 | Transazione autorizzata e richiesta di cattura non ancora completata. Dipende dal metodo usato. |
APPROVED | MOV | 0 | Transazione catturata parzialmente o totalmente. Rimane nello stesso stato se stornata, ma non totalmente. |
APPROVED | CAN | 0 | Transazione autorizzata e successivamente cancellata. |
APPROVED | STO | 0 | Transazione completamente stornata. |
DECLINED | AUT | ≠ 0 (Es. 74) | Transazione fallita. |
Transaction events
Lo stato corrente della transazione è una fotografia del momento in cui viene eseguita la verifica. Questa informazione è necessaria, ma non sempre è sufficiente per capire tutto ciò che è accaduto sulla transazione. Gli eventi, associati alla transazione, permettono di capire se sulla transazione sono state eseguite operazioni come:
- cattura
- cancellazione
- storno
| Evento | Operazione rappresentata | Effetto tipico sulla transazione | TransactionState Post Evento |
|---|---|---|---|
AUT | Autorizzazione | La transazione raggiunge la fase autorizzativa. Può concludersi positivamente o negativamente. | AUT |
MOV | Cattura | La transazione viene catturata totalmente o parzialmente. Può essere catturata solamente una transazione autorizzata con successo. | MOV |
CAN | Cancellazione | La transazione viene cancellata. Può essere cancellata solamente una transazione autorizzata con successo. | CAN |
PRE | Prenotazione della cattura | La cattura è stata richiesta, ma non ancora completata. | PRE |
REQ | Prenotazione dello storno | Lo storno è stato richiesto, ma non ancora completato. | MOV |
STO | Storno | La transazione viene stornata totalmente o parzialmente. | Se lo storno è parziale MOV. Se lo storno è totale e non sono presenti altre catture non stornate sulla transazione STO |
Gli eventi sono particolarmente importanti nei casi in cui su una singola transazione ci sono più operazioni successive, ad esempio:
- più catture parziali.
- uno o più storni su stessa cattura o catture diverse.
Separated and unified capture
Ci sono metodi di pagamento che prevedono la scelta tra separazione tra autorizzazione e cattura o cattura contestuale, come le carte.
Altri metodi hanno solamente la cattura contestuale all'autorizzazione, tra questi ci sono metodi che prevedono stati intermedi come il PENDING prima di raggiungere uno stato di OK/KO.
Come ad esempio Pay by bank .
Sulla Dashboard Gestpay, se i metodi di pagamento lo permettono, per ogni ShopLogin è possibile configurare i metodi per avere autorizzazione e cattura unite o separate.
- Unified capture: autorizzazione e cattura avvengono nello stesso flusso.
- Separated capture: autorizzazione e cattura sono due momenti distinti.
Per gli shoplogin configurati con Separated Capture, è necessario definire un'azione automatica da eseguire dopo l'autorizzazione:
- Capture
- Cancel
Il numero massimo di giorni dipende dal metodo di pagamento ed è possibile impostare un valore tra 1 e 25 giorni. Dall'autorizzazione al momento impostato per l'azione automatica è possibile catturare o cancellare la transazione tramite API o Dashboard.
| Configurazione | transactionResult | transactionState | transactionErrorCode | Azione richiesta |
|---|---|---|---|---|
| Separated Capture | APPROVED | AUT | 0 | Capture o Cancel |
| Unified Capture | APPROVED | MOV | 0 | Nessuna |
Qui i link alle:
Assistenza
Fabrick
- Status page: https://status.fabrick.com/
- Support: https://landing.fabrick.com/fabrick-dashboard-support