Home 
Una transazione ha diversi stati. La figura 1 mostra gli stati possibili, incluse le transizioni consentite tra questi stati.
Figure 1. Gli stati della transazione, incluse le transizioni di stato
Le sezioni seguenti spiegano il significato di questi stati e quando vengono impostati. Si consiglia di integrare questi stati nell’applicazione dell’esercente per supportare tutti i tipi di pagamento. Si consiglia inoltre di considerare correttamente la tempistica di questi stati nell’applicazione dell’esercente.
Garantiamo che tutte le transazioni utilizzino questi stati indipendentemente dal tipo di pagamento e dal gestore. Tuttavia, alcuni stati possono essere saltati e la tempistica può variare a seconda del tipo di pagamento.
Quando la transazione viene creata dall’esercente, viene impostato lo stato Pending. La maggior parte delle proprietà può
essere modificata finché la transazione non passa allo stato Confirmed. Finché la transazione si trova nello
stato Pending, l’importo può essere aumentato o ridotto.
È possibile recuperare già durante questo stato i tipi di pagamento possibili per questa specifica transazione.
Quando la transazione è Confirmed, non può più essere modificata. Questo
stato indica che l’elaborazione della transazione può iniziare. Il motivo per cui le transazioni possono rimanere nello
stato Confirmed senza passare a Processing è tipicamente che il cliente non è stato inoltrato al
nostro servizio e quindi l’elaborazione non è ancora iniziata.
|
Note
|
Il tempo durante il quale la transazione rimane in questo stato è controllato dall’applicazione dell’esercente. Non appena il cliente
viene reindirizzato alla nostra piattaforma, viene impostato lo stato Processing.
|
Potete accettare i pagamenti utilizzando la nostra integrazione iframe. Informazioni più dettagliate sono disponibili nella guida all’integrazione iframe.
Lo stato Processing viene impostato quando l’elaborazione della transazione è iniziata ma non è ancora terminata. Una transazione può
rimanere nello stato Processing per secondi o addirittura settimane. Questa tempistica dipende dai tipi di pagamento, dal processo, dal
charge flow utilizzato ecc. e da come viene elaborata la transazione. I charge flow possono ad esempio ritardare di settimane il passaggio allo stato successivo, perché
la transazione può rimanere in Processing finché tutti i livelli del charge flow non sono stati elaborati.
|
Note
|
La tempistica dei diversi livelli può essere impostata nella configurazione dei livelli del charge flow. Per maggiori informazioni, consultate la sezione sui charge flow. |
La transazione viene contrassegnata come Failed quando il pagamento non ha potuto essere autorizzato. Tipicamente il cliente annulla
il processo di autorizzazione oppure l’autorizzazione è stata rifiutata dal gestore. I dettagli sul motivo del fallimento della transazione
si trovano nei tentativi di addebito associati alla transazione. Il cliente potrebbe provare più volte,
ogni volta con un motivo di errore diverso.
|
Important
|
Questo stato è uno stato finale. La transazione non cambierà più stato. |
|
Note
|
Per maggiori informazioni sul motivo per cui la transazione è passata allo stato Failed, aprite la transazione e controllate la scheda del processo Space > Pagamento > Transazione. |
La transazione è Authorized quando il cliente ha accettato la transazione e il processo ha verificato che
il cliente è in grado di pagare l’importo. Authorized significa che esiste una prenotazione, ma i fondi non vengono
trasferiti dal conto del cliente al conto dell’esercente. In questo stato l’esercente può modificare
l’importo della transazione modificando le voci della transazione. Queste modifiche possono essere effettuate
tramite l’API del servizio web oppure tramite l’interfaccia utente della nostra applicazione. Quando non devono più essere applicate modifiche alla
transazione, questa deve essere completata (vedere Completamenti).
|
Important
|
Non tutti i tipi di pagamento supportano una prenotazione sul conto del cliente. Alcuni tipi di pagamento saltano quindi questo stato e
passano direttamente a Completed.
|
Il tempo durante il quale la transazione rimane in questo stato è controllabile dall’esercente. L’esercente può eseguire il completamento della transazione tramite l’interfaccia del servizio web.
Le transazioni possono essere completate tramite il back office o tramite l’API del servizio web. Per esempi di richieste e informazioni più dettagliate, consultate la guida al completamento.
La transazione viene contrassegnata come voided quando una transazione autorizzata ma non completata non deve più essere elaborata
e viene quindi annullata.
|
Important
|
Questo stato è uno stato finale. La transazione non cambierà più stato. |
Le transazioni possono essere annullate tramite il back office o tramite l’API del servizio web. Per esempi di richieste e informazioni più dettagliate, consultate la guida all’annullamento.
Quando la transazione si trova nello stato Completed, il trasferimento del denaro dal conto del cliente al conto dell’esercente
è stato avviato. L’importo non può più essere modificato. Completed non significa che i beni o i servizi possano essere
consegnati al cliente. A seconda del tipo di pagamento, i fondi devono essere trasferiti prima che la consegna
possa essere effettuata (ad esempio in caso di pagamento anticipato).
Per ogni transazione indichiamo se i beni possono essere consegnati subito o se il download deve essere consentito per il vostro esercente.
Questo viene indicato dagli stati Fulfill e Decline. L’esercente dovrebbe attendere il raggiungimento di uno degli stati finali.
Il tempo durante il quale la transazione rimane in questo stato dipende dal tipo di pagamento e dal gestore. Possono essere solo pochi secondi oppure settimane.
Alcuni tipi di pagamento possono richiedere una decisione manuale. Questo processo decisionale manuale è gestito dal concetto di indicazione di consegna
spiegato in Indicazioni di consegna.
Esempio
Supponiamo che offriate l’online banking come tipo di pagamento nel vostro negozio. La transazione passerà allo stato Completed
una volta completata la transazione. Tuttavia, a seconda del tipo di pagamento, può passare fino a un giorno prima che il fornitore sia in grado
di indicarci se il denaro è arrivato sul vostro conto. La transazione rimarrà nello stato Completed finché non riceveremo
questa conferma.
Nel caso in cui non esista un processo automatico che ci consenta di essere informati che il denaro è arrivato o che è garantito da terzi,
dovrete verificare manualmente se il pagamento è arrivato e spostare manualmente le transazioni nello
stato Fulfill o Decline.
Quando la transazione passa a Fulfill, l’esercente può iniziare a evadere la transazione. Nel caso di beni fisici, il
processo di consegna dovrebbe essere avviato.
|
Important
|
Questo è uno stato finale. |
Quando la transazione passa allo stato Decline, l’esercente dovrebbe rifiutare la transazione e non evaderla.
Questo stato viene tipicamente impostato quando il cliente non è disposto a pagare o quando è alta la probabilità che il cliente generi uno
storno di addebito (transazioni sospette in base alle vostre impostazioni antifrode). Maggiori informazioni sul motivo per cui la transazione è passata a Decline si trovano
sull’oggetto Indicazioni di consegna.
|
Important
|
Questo è uno stato finale. |
|
Note
|
All’interno dello spazio esiste un’impostazione per avviare automaticamente un rimborso quando viene raggiunto questo stato. Ciò consente di correggere automaticamente la contabilità e di rimborsare automaticamente le transazioni. Utilizzate questa funzione con cautela. |
Quando la transazione si trova nello stato Authorized, l’esercente può modificare la transazione. Queste modifiche vengono salvate solo nella nostra
applicazione e non vengono comunicate al gestore. Quando non devono più essere applicate modifiche alla transazione,
l’esercente deve completare la transazione. Le modifiche e il completamento possono essere eseguiti tramite
il servizio web e tramite l’interfaccia
utente della nostra applicazione. Il completamento di una transazione è noto anche come capture o activate.
Le transazioni possono essere completate tramite il back office o tramite l’API del servizio web. Per esempi di richieste e informazioni più dettagliate, consultate la guida al completamento.
Consentiamo di inviare un solo completamento per transazione, al fine di semplificare e snellire il processo di transazione.
Potete tuttavia fornirci più modifiche della transazione. Le memorizziamo tutte e le inviamo al gestore non appena confermate la transazione.
|
Note
|
Se non confermate la transazione, questa verrà confermata dal sistema in base alla vostra impostazione di timeout. Questa può essere impostata in → describe. |
Non tutti i tipi di pagamento supportano il concetto di completamento. Di conseguenza, le modifiche non possono essere applicate in tutti i casi. Per questo motivo, il processo lato esercente potrebbe dover essere adattato per ogni tipo di pagamento.
Per evitare questo tipo di specializzazione del processo lato esercente, consigliamo di non utilizzare i completamenti. Tutti i tipi di pagamento possono
essere configurati per passare direttamente a Completed. L’esercente può effettuare modifiche successive creando rimborsi. Questo snellisce
il processo per l’esercente, perché deve essere implementato un solo processo.
|
Note
|
Il comportamento relativo al completamento diretto può essere impostato nella configurazione del connettore Space > Pagamento > Configurazione > Connettori. Come descritto sopra, può darsi che questo non possa essere impostato perché il tipo di pagamento non prevede il concetto di completamento e verrà catturato direttamente. |
Le indicazioni di consegna sono un passaggio molto importante del processo di transazione, poiché vi indicano chiaramente se vi raccomandiamo di spedire i beni in base alle caratteristiche del tipo di pagamento. Abbiamo analizzato il processo e le garanzie di ogni tipo di pagamento che offriamo e possiamo quindi indicarvi chiaramente se il pagamento sarà molto probabilmente onorato o, in alcuni casi, addirittura garantito dal fornitore.
La vostra applicazione dovrebbe avviare la spedizione di un bene fisico o attivare il download non appena l’indicazione di consegna passa a Fulfill.
Potete recuperare l’indicazione di consegna come segue. Se avete configurato correttamente i webhook, vi notificheremo non appena ci sarà un aggiornamento della transazione e dovrete recuperare le indicazioni di consegna dal nostro servizio.