Documentazione
Documentazione
Contabilizzazioni

1Introduzione

Le transazioni, dopo essere state autorizzate, si trovano nello stato Authorized. Per maggiori informazioni consultate il processo di transazione. La funzione che chiamiamo complete è nota anche come capture o activate. Questa terminologia può variare a seconda del contesto, tuttavia la funzione si riferisce all’azione che avvia effettivamente il trasferimento di denaro dal conto del cliente al conto dell’esercente.

Alcuni tipi di pagamento possono essere configurati in modo da completare il pagamento in modo differito e limitarsi ad autorizzare il pagamento sul lato del gestore. In questo caso l’importo dell’ordine può essere ridotto e gli articoli nel carrello possono essere modificati finché non completate la transazione.

Note
 Non tutti i tipi di pagamento supportano i completamenti. Se volete ottenere un processo unificato per tutti i tipi di pagamento, vi consigliamo di completare il pagamento immediatamente. Le informazioni sui tipi di pagamento e sul supporto del completamento differito sono disponibili nella lista dei connettori di pagamento.

2Dettagli di integrazione

Prima di poter completare una transazione dovreste aver preso in considerazione le seguenti guide

Se volete annullare una transazione non completata, dovete eseguirne il void. Consultate la documentazione sull’annullamento delle transazioni per sapere come annullare le transazioni.

2.1Modificare le voci all’interno del back office

Potete modificare le voci all’interno del back office. Per farlo dovete aprire la transazione in Space > Pagamento > Transazioni. Fate clic sulla scheda Voci e poi su Modifica voci. Potete salvare le modifiche facendo clic su Aggiorna voci.

Quando si modificano le voci tramite il servizio web o all’interno del back office viene creata una nuova versione. Potete vedere le versioni nella scheda Versione all’interno della transazione.

Note
 Se modificate le voci solo nel back office e non anche nella vostra applicazione, possono crearsi dati incoerenti.

2.2Completare una transazione nel back office

Le transazioni possono essere completate anche all’interno del back office. Una transazione rimane nello stato Authorized finché non è stata completata. Le transazioni possono essere completate in due modi:

  1. Completamento online: se completate una transazione online, inviamo la richiesta di completamento al gestore.

  2. Completamento offline: il completamento offline simula il completamento, ma la richiesta non verrà inoltrata al gestore. Questa funzione può essere utilizzata se avete già completato il pagamento presso il gestore e non potete più inviarlo in modalità online.

I completamenti riusciti possono essere visualizzati nella scheda Completamento della transazione.

2.3Modificare le voci tramite il servizio web

Finché la transazione non è Completed, potete cambiare e modificare le voci a piacere. Utilizzate l’operazione create line item version per aggiornare le voci esistenti tramite l’API.

Richiesta

Nell’esempio di richiesta qui sotto aggiorniamo una voce esistente e impostiamo il nuovo prezzo a 70 CHF invece dei 75 CHF iniziali impostati nella transazione originale.

{
    "externalId": "my-external-id",
    "lineItems": [
        {
            "amountIncludingTax": "70",
            "name": "Chelsea Tee",
            "quantity": "1",
            "shippingRequired": true,
            "sku": "mtk004",
            "type": "PRODUCT",
            "uniqueId": "2622"
        }
    ],
    "transaction": 109575
}

2.4Inviare la richiesta di completamento

Quando sapete di non voler più modificare la transazione e volete elaborarla, potete completare la transazione inviando la richiesta di completamento tramite il servizio web utilizzando il Transaction Completion Service. Avete la possibilità di completare la transazione online o offline a seconda che vogliate inviarla o meno al gestore.

2.5Cosa succede dopo?

Dopo che una transazione è stata completata, passa allo stato Completed e, a seconda del tipo di pagamento, direttamente allo stato Fulfill (consultate il processo di transazione per maggiori informazioni sui cambiamenti di stato). La documentazione sui rimborsi spiega come le transazioni completate possono essere rimborsate al cliente.

Staging 2.218.3