Documentazione
Documentazione
Transazione
Chiudi Documentazione API
Transazione

A transaction can go through the following states:

Pending

The transaction is initialized. Most of the information on the transaction can be changed. The transaction’s next state is Confirmed.

Confirmed

The transaction is confirmed by the web shop or by the merchant. Once a transaction is Confirmed no changes can be made on it. The transaction’s next state is Processing.

Processing

The transaction switches to Processing when we start with the collecting of the payment information and start with the processing. A transaction can remain a long time in the Processing state (e.g. when used with charge flows). In case the processing of the transaction is successful the transaction switches into Authorized. If the processing is not successful the transaction switches into Failed.

Failed

The transaction could not be Authorized. Typically either the customer cancelled the transaction or the customer was unable or not willing to authorize the payment. Details why the transaction Failed can be found in the failure reason on the transaction. This is a final state.

Authorized

The customer has Authorized the payment. Authorized means the customer has accepted the payment and the amount could be reserved. However the transfer of the amount to the merchant account is not be initiated. In this state the merchant can change the line items of the transaction. The transaction’s next state is Completed.

Completed

The payment has been initiated. The transfer of the money to the merchant account has been done or is initiated. As such the amount cannot be changed anymore. It is not recommend to initiate the delivery when this state is reached. The decision if the delivery of the goods should occur depends on the payment method on the settings done by the merchant. The transaction’s next states are Fulfill or Decline.

Fulfill

The transaction is ready to be delivered by the merchant. All the risk checks are executed and indicate that the transaction is safe to be delivered. This is a final state.

Decline

The transaction should not be delivered. It is recommended to decline the delivery because either the money will never arrive on the merchant account or the chances are high that the customer is not willing to pay the payment. This is a final state.

Stati
  • Crea
    Lo stato di creazione viene impostato in fase di creazione della transazione.
  • In sospeso
    La transazione è stata creata, ma non ancora confermata dal sistema del commerciante.
  • Confermato
    La transazione è stata creata e confermata, ma non ancora elaborata.
  • In elaborazione
    La transazione è in elaborazione.
  • Non riuscito
    L’autorizzazione della transazione non è andata a buon fine.
  • Autorizzato
    La transazione è stata autorizzata.
  • Completato
    La transazione è stata completata.
  • Consegna
    La transazione è pronta per la consegna.
  • Rifiuta
    I prodotti o servizi non vanno consegnati.
  • Annullato
    L'autorizzazione viene annullata e quindi non viene trasferito alcun denaro.
Caratteristiche
  • Accept Header
    L'intestazione 'Accept' del browser web del cliente.
  • Accept Language Header
    L'intestazione 'Accept Language' del browser web del cliente.
  • Allowed Payment Method Brands
    I marchi dei metodi di pagamento che possono essere utilizzati per autorizzare la transazione.
  • Altezza dello schermo
    L'altezza dello schermo del browser web del cliente.
  • Ambiente
  • Ambiente di autorizzazione
    L'ambiente in cui è stata autorizzata la transazione.
  • Articoli di linea
    Gli articoli acquistati dal cliente.
  • Autorizzato il
    La data e l'ora in cui la transazione è stata autorizzata.
  • Canale di vendita
    Il canale di vendita attraverso il quale è stata effettuata la transazione.
  • Causa dell’errore
    Il motivo del fallimento della transazione.
  • Charge Retry Enabled
    Se il cliente può effettuare ulteriori tentativi di pagamento se il primo non è andato a buon fine. L'impostazione predefinita è true.
  • Completato il
    La data e l'ora in cui è stata completata la transazione.
  • Completion Timeout On
    La data e l'ora in cui la transazione viene completata automaticamente.
  • Comportamento di completamento
    Il comportamento che controlla il completamento della transazione.
  • Conferma automatica attiva
    Se la transazione può essere confermata automaticamente o se deve essere fatta esplicitamente tramite l'API. L'impostazione predefinita è true.
  • Configurazione del connettore di pagamento
    La configurazione del connettore di pagamento utilizzata per autorizzare la transazione.
  • Configurazioni della modalità di pagamento ammesse
    Le configurazioni del metodo di pagamento che possono essere utilizzate per autorizzare la transazione.
  • Confirmed By
    L'ID dell'utente che ha confermato la transazione.
  • Confirmed On
    La data e l'ora di creazione della transazione.
  • Creato da
    L'ID dell'utente che ha creato la transazione.
  • Creato il
    La data e l'ora di creazione dell'oggetto.
  • Customers Presence
    La presenza del cliente indica se e in che modo il cliente della transazione è presente. L'impostazione predefinita è VIRTUAL_PRESENT.
  • Data della decisione di consegna
    La data e l'ora in cui è stata presa la decisione di spedire l'ordine.
  • Data di eliminazione prevista
    La data e l'ora in cui è prevista la rimozione definitiva dell'oggetto. Se il valore è vuoto, l'oggetto non verrà rimosso.
  • Email disabilitate
    Se l'invio di e-mail è disattivato per la transazione. L'impostazione predefinita è false.
  • End Of Life
    La data e l'ora in cui la transazione raggiunge la fine dell'attività. In questo momento non è possibile eseguire ulteriori azioni.
  • Failed Url
    L'URL a cui reindirizzare il cliente dopo l'annullamento o la mancata autenticazione del pagamento.
  • Fallito su
    La data e l'ora in cui la transazione è fallita.
  • Fuso orario
    Il fuso orario del cliente, che influisce sulla formattazione di date e orari nelle comunicazioni con il cliente.
  • Genitore
    La transazione padre che è stata (parzialmente) sostituita da questa transazione.
  • Gruppo
    Il gruppo a cui appartiene la transazione.
  • ID
    A unique identifier for the object.
  • ID cliente
    L'identificativo univoco del cliente nel sistema esterno.
  • ID sessione del dispositivo
    Permette di collegare la transazione ai dati raccolti dal dispositivo del cliente.
  • ID spazio collegato
    L'ID dello spazio a cui appartiene questo oggetto.
  • ID vista spazio
    L'ID della vista dello spazio a cui questo oggetto è collegato.
  • Importo accreditato
    L'importo totale che è stato rimborsato, nella valuta della transazione.
  • Importo completato
    L'importo totale che è stato completato, nella valuta della transazione.
  • Importo dell’autorizzazione
    La somma di tutti i prezzi delle voci, comprese le imposte, nella valuta della transazione.
  • Importo totale liquidato
    L'importo totale che è stato regolato, nella valuta della transazione.
  • Indirizzo Di Fatturazione
    L'indirizzo associato al metodo di pagamento ai fini della fatturazione e dell'elaborazione delle transazioni.
  • Indirizzo Internet Protocol (IP)
    L'indirizzo IP del dispositivo del cliente.
  • Indirizzo e-mail del cliente
    L'indirizzo e-mail del cliente.
  • Internet Protocol Address Country
    Il paese determinato dall'indirizzo IP del dispositivo del cliente.
  • Invoice Merchant Reference
    Il riferimento dell'esercente utilizzato per identificare la fattura.
  • Java Enabled
    Se Java è abilitato sul browser web del cliente.
  • Larghezza dello schermo
    La larghezza dello schermo del browser web del cliente.
  • Lingua
    The language that is linked to the object.
  • Messaggio d’errore utente
    Il messaggio che può essere visualizzato al cliente per spiegare il motivo del fallimento della transazione, nella lingua del cliente.
  • Meta dati
    Consente di memorizzare informazioni aggiuntive sull'oggetto.
  • Metodo di consegna
    Il nome del metodo di spedizione utilizzato per spedire i prodotti.
  • Modalità tokenizzazione
    La modalità di tokenizzazione specifica se e come la tokenizzazione delle informazioni di pagamento viene applicata alla transazione.
  • Processing On
    La data e l'ora in cui è stata avviata l'elaborazione della transazione.
  • Profondità di colore dello schermo
    La profondità di colore dello schermo del browser web del cliente.
  • Riferimento commerciante
    Il riferimento dell'esercente utilizzato per identificare la transazione.
  • Status
    Lo stato attuale dell'oggetto.
  • Strategia di selezione ambiente
    La strategia per determinare se la transazione deve essere elaborata nell'ambiente di test o di produzione.
  • Success Url
    L'URL a cui reindirizzare il cliente dopo l'autenticazione del pagamento.
  • Time out autorizzazione
    La data e l'ora in cui la transazione deve essere autorizzata, altrimenti verrà annullata.
  • Tipo di interfaccia utente
    Il tipo di interfaccia utente utilizzata dal cliente per fornire le informazioni di pagamento.
  • Token
    Il token di pagamento da utilizzare per addebitare il cliente.
  • Totale delle tasse applicate
    Il totale di tutte le commissioni addebitate, nella valuta della transazione.
  • User Agent Header
    L'intestazione 'User Agent' del browser web del cliente.
  • Valuta
    Codice di tre lettere (formato ISO 4217) della valuta della transazione.
  • Versione
    The version is used for optimistic locking and incremented whenever the object is updated.
  • Window Height
    L'altezza della finestra del browser web del cliente.
  • Window Width
    La larghezza della finestra del browser web del cliente.
  • Years To Keep
    Il numero di anni in cui la transazione viene conservata dopo la sua autorizzazione.
  • indirizzo di spedizione
    L'indirizzo a cui verrà spedito l'ordine.
  • terminale
    Il terminale di pagamento attraverso il quale è stato elaborato il pagamento.