Passa al contenuto principale

Cattura e Refund

Cattura e Refund​

Di seguito sono riportate le principali operazioni dispositive che il merchant può eseguire su transazioni precedentemente autorizzate:

  • Capture – per movimentare l’importo pre‑autorizzato (totale o parziale)
  • Refund – per rimborsare un importo precedentemente movimentato (totale o parziale)

Entrambi i servizi rispondono in modalità sincrona con l’esito dell’operazione.

Esempio flusso Capture e Refund

POST 01_Capture (Cattura)​

Url​

{{endpoint}}/pgw/payment/capture

Tramite il servizio Capture, il merchant può movimentare un importo precedentemente autorizzato. È possibile:

  • catturare l’importo totale
  • oppure effettuare catture parziali (anche multiple), fino a raggiungere l’importo pre‑autorizzato.

Per referenziare la transazione da catturare, valorizzare il parametro:

  • origTranId con il tranId ricevuto in risposta alla chiamata Verify della transazione autorizzata.

Il servizio Capture risponde in modo sincrono con l’esito dell’operazione e l’eventuale importo ancora pending.

REQUEST​

{
  "txHead": {
    "merId": "{{merId}}",
    "txId": "test8"
  },
  "txReq": {
    "origTranId": 3069867750865394,
    "amount": {
      "value": 50,
      "currency": "EUR"
    }
  }
}

RESPONSE​

{
  "txHead": {
    "merId": "{{merId}}",
    "txId": "test8",
    "resultCode": "IGFS_000",
    "errDescription": "TRANSAZIONE OK"
  },
  "txRes": {
    "tranId": 3069867850699655,
    "paymentId": "139781624108079453"
  },
  "pendingAmount": {
    "value": 50,
    "currency": "EUR"
  }
}

POST 02_Refund (Rimborso)​

Url​

{{endpoint}}/pgw/payment/refund

Tramite il servizio Refund, il merchant può riaccreditare l’importo precedentemente movimentato. È possibile:

  • rimborsare l’importo totale
  • oppure effettuare rimborsi parziali (anche multipli), fino a raggiungere l’importo addebitato.

Per referenziare la transazione da rimborsare, valorizzare il parametro:

  • origTranId con il tranId ricevuto in risposta alla chiamata Capture relativa.

Il servizio Refund risponde in modo sincrono con l’esito dell’operazione e l’importo ancora disponibile per ulteriori rimborsi.

REQUEST​

{
  "txHead": {
    "merId": "{{merId}}",
    "txId": "test10"
  },
  "txReq": {
    "origTranId": 3069867810103798,
    "amount": {
      "value": 50,
      "currency": "EUR"
    }
  }
}

RESPONSE​

{
  "txHead": {
    "merId": "{{merId}}",
    "txId": "test10",
    "resultCode": "IGFS_000",
    "errDescription": "TRANSAZIONE OK"
  },
  "txRes": {
    "tranId": 3069867820863232,
    "paymentId": "139782946108079510"
  },
  "pendingAmount": {
    "value": 1650,
    "currency": "EUR"
  }
}