--- title: "Transaction state" description: "Come interpretare lo stato di una transazione nei flussi di pagamento Fabrick: transactionResult, transactionState ed eventi, cattura contestuale o separata e azione automatica dopo l'autorizzazione." url: "https://docs.fabrick.com/payment-hub-and-orchestra/ecommerce/payments-management/transaction-state/" language: "it" --- # Transaction state ## Overview Per poter verificare, tramite [Fabrick Dashboard](https://www.fabrick.com/it-it/assistenza/fabrick-dashboard/), lo stato, i dettagli e gli eventi di una transazione, bisogna fare riferimento alla relativa documentazione. Nello specifico: - [Stati dei pagamenti](https://www.fabrick.com/it-it/assistenza/fabrick-dashboard/stati-dei-pagamenti/). - [Stati degli eventi nei pagamenti](https://www.fabrick.com/it-it/assistenza/fabrick-dashboard/stati-eventi-pagamenti/). 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: - `transactionResult` - `transactionState` - `transactionErrorCode` 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 | > **Importante** > > 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 ](https://docs.fabrick.com/payment-hub-and-orchestra/ecommerce/alternative-payments/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. ![Merchant_Back_Office-Configuration-Environment_MOTO](https://docs.fabrick.com/assets/images/merchant-back-office-configuration-environment-moto-fead2129423f0d56d28e63dc3582b168.png) 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: - [Configurazioni Separated and unified capture](https://docs.fabrick.com/payment-hub-and-orchestra/ecommerce/introduction/getting-started/#moto). - [Richieste di cattura](https://docs.fabrick.com/payment-hub-and-orchestra/ecommerce/payments-management/capture/). - [Richieste di cancellazione](https://docs.fabrick.com/payment-hub-and-orchestra/ecommerce/payments-management/cancel/). --- ## Assistenza **Fabrick** - **Status page**: [https://status.fabrick.com/](https://status.fabrick.com/) - **Support**: [https://landing.fabrick.com/fabrick-dashboard-support](https://landing.fabrick.com/fabrick-dashboard-support)