Documentazione
Documentazione
Rimborsi

1Introduzione

Le transazioni che si trovano nello stato Completed o Fulfill possono essere rimborsate e il denaro può essere restituito al cliente. Per maggiori informazioni consultate il processo di transazione.

Note
 Non tutti i tipi di pagamento consentono di autorizzare le transazioni in modo differito. Per avere un processo più semplice, vi consigliamo di lavorare con i rimborsi anziché con i completamenti.

2Dettagli di integrazione

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

Di seguito trovate maggiori informazioni su come emettere un rimborso nel back office dell’applicazione o su come utilizzare il web service per integrare il processo di rimborso da remoto nella vostra applicazione.

2.1Rimborsi online vs offline

Un rimborso può essere emesso in due modi:

  • Online: se rimborsate una transazione online, inviamo la richiesta di rimborso direttamente al gestore.

  • Offline: il rimborso offline simula il rimborso nella nostra piattaforma ma non invia il rimborso al gestore. Questa funzionalità può essere utilizzata se avete già rimborsato il pagamento presso il gestore e non potete più inviarlo in modalità online.

2.2Creare un rimborso nel back office

I rimborsi si trovano nel back office in Space > Pagamento > Transazioni. Aprite la transazione. Se la transazione è stata completata, dovreste trovare la scheda della transazione Rimborsi. Il back office offre un modo semplice e comodo per emettere rimborsi online oppure offline.

Note
 Possono verificarsi dati incoerenti se modificate le voci solo nel back office e non anche nella vostra applicazione.

2.3Creare un rimborso tramite il web service

Potete rimborsare una transazione completata tramite il web service utilizzando il servizio di rimborso.

Avete la possibilità di emettere un rimborso basato su una riduzione della quantità o sul prezzo unitario. Non dovreste combinarli, poiché ciò potrebbe portare a risultati inattesi. Per ottenere la voce che potete rimborsare, dovrete prima leggere (read) la transazione. Questo fornirà le informazioni necessarie per emettere il rimborso.

Distinguiamo tra diversi tipi di rimborso:

  • CUSTOMER_INITIATED_AUTOMATIC / MANUAL: un rimborso è avviato dal cliente se il rimborso non è stato attivato con il consenso dell’esercente. Ciò può accadere a causa di uno storno di addebito sulla transazione con carta di credito o con addebito diretto.

  • MERCHANT_INITIATED_ONLINE / OFFLINE: un rimborso avviato dall’esercente viene attivato con il consenso dell’esercente.

Risposta della transazione

Di seguito trovate un estratto della risposta alla lettura (read) della transazione che vogliamo rimborsare.

"lineItems": [{
    "aggregatedTaxRate": 0,
    "amountExcludingTax": 70,
    "amountIncludingTax": 70,
    "attributes": {
        "color": {
            "label": "Color",
            "value": "Black"
        },
        "size": {
            "label": "Size",
            "value": "S"
        }
    },
    "name": "Chelsea Tee",
    "quantity": 1,
    "shippingRequired": true,
    "sku": "mtk004",
    "taxAmount": 0,
    "taxAmountPerUnit": 0,
    "taxes": [],
    "type": "PRODUCT",
    "uniqueId": "2622",
    "unitPriceExcludingTax": 70,
    "unitPriceIncludingTax": 70
}

Richiesta

Sulla base di queste informazioni possiamo emettere la richiesta di rimborso utilizzando il metodo Refund Create dell’API.

{
    "externalId": "1",
    "reductions": [
        {
            "lineItemUniqueId": "2622",
            "quantityReduction": "1",
            "unitPriceReduction": "70"
        }
    ],
    "transaction": 109575,
    "type": "MERCHANT_INITIATED_ONLINE"
}
Staging 2.218.3