Passa al contenuto principale

Pagamenti MIT Unscheduled

Pagamenti MIT Unscheduled​

I pagamenti Unscheduled si differenziano dai Recurrent per la modalità di sottomissione:

  • possono essere eseguiti con importo variabile
  • possono avere cadenza variabile

Allo stesso modo dei pagamenti Recurrent, anche gli Unscheduled devono mantenere un legame con il primo pagamento E‑Commerce iniziale, tramite:

  • marcatori di tipo CIT_UNSCHEDULED_COF_FIRST nella prima transazione
  • l’identificativo traceChainId, da usare in tutte le MIT UNSCHEDULED successive.
Esempio flusso pagamenti MIT Unscheduled

POST 01_Init_CIT_FIRST (primo pagamento Unscheduled)​

Url​

{{endpoint}}/pgw/payment/init

Il primo pagamento Unscheduled è un pagamento E‑Commerce con gli indicatori Unscheduled abilitati:

  • txIndicatorType = CIT_UNSCHEDULED_COF_FIRST per marcare la transazione come Prima Unscheduled
  • traceChainId = identificativo univoco del servizio/account per cui si inizializza il flusso. Questo valore dovrà essere presente in tutte le operazioni MIT UNSCHEDULED successive.

Come per i COF First, la prima transazione Unscheduled può essere:

  • di tipo VERIFICATION (importo 0, solo validazione carta)
  • oppure RESERVATION / SALE (con acquisto contestuale).

REQUEST​

{
  "txHead": {
    "merId": "{{merId}}",
    "txId": "test6"
  },
  "txReq": {
    "txOp": "VERIFICATION",
    "txIndicatorType": "CIT_UNSCHEDULED_COF_FIRST",
    "description": "Unscheduled FIRST",
    "traceChainId": "CHAINID-20221205-1527",
    "amount": {
      "value": 0,
      "currency": "EUR"
    }
  },
  "poiInfo": {
    "pitype": "CC"
  },
  "buyer": {
    "email": "paymentgateway@netsgroup.com",
    "language": "IT",
    "name": "Name",
    "lastName": "Surname"
  },
  "errorURL": "https://www.merchant.com/error",
  "callbackURL": "https://www.merchant.com/server2server",
  "notifyURL": "https://www.merchant.com/done"
}

RESPONSE​

{
  "txHead": {
    "merId": "{{merId}}",
    "txId": "test6",
    "resultCode": "IGFS_000",
    "errDescription": ""
  },
  "paymentId": "139869087108079501",
  "redirectURL": "https://testeps.netswgroup.it/IGFS_CG_WEB/app/cc/main/show?referenceData=8924B3DA3C2A0E70DE0E82D282A70ADC"
}

GET 02_Verify_CIT_FIRST​

Url​

{{endpoint}}/pgw/payment/verify

Il servizio Verify restituisce l’esito della prima transazione Unscheduled. Il merchant deve:

  • salvare il token (tokenValue) per pagamenti Unscheduled successivi
  • conservare il traceChainId da usare nelle MIT UNSCHEDULED.

Query Parameters​

NomeValoreDescrizione
merId{{merId}}ID merchant
paymentId139869087108079501ID pagamento
txIdtest6ID transazione

REQUEST​

{{endpoint}}/pgw/payment/verify?merId={{merId}}&paymentId=139869087108079501&txId=test6

RESPONSE​

{
  "txHead": {
    "merId": "{{merId}}",
    "txId": "test6",
    "resultCode": "IGFS_000",
    "errDescription": "TRANSAZIONE OK"
  },
  "txRes": {
    "paymentId": "139869087108079501",
    "tranId": 3069867800844971,
    "status": "OK"
  },
  "amount": {
    "value": 0,
    "currency": "EUR"
  },
  "nssResult": "909",
  "payer": {
    "name": "tito",
    "lastName": "lare"
  },
  "threeD": {
    "protocolVersion": "2.1.0",
    "enrStatus": "Y",
    "authStatus": "Y",
    "eci": "05"
  },
  "procRes": {
    "procId": "00",
    "procName": "SIMULATORE",
    "authCode": "000002",
    "addData": {
      "posId": "01427002",
      "merId": "7563667",
      "acquirerID": "00",
      "acquirerName": "SIMULATORE"
    }
  },
  "poiInfo": {
    "pitype": "CC",
    "poiId": "TEST_MOBI"
  },
  "pi": {
    "tokenValue": "0D9971E639F08C458511E0DD67B4166D"
  },
  "cardInfo": {
    "maskedpan": "444433******1111",
    "expDate": "2503",
    "brand": "VISA"
  }
}

POST 03_Auth_MIT_UNSCHEDULED​

Url​

{{endpoint}}/pgw/payment/auth

I pagamenti Unscheduled successivi vengono sottomessi in modalità MIT (Merchant Initiated Transaction), senza coinvolgimento diretto del buyer.

Per eseguire una transazione MIT UNSCHEDULED è necessario invocare il servizio Auth con:

  • txIndicatorType = MIT_UNSCHEDULED_COF_NEXT
  • traceChainId = identificativo usato nella prima transazione Unscheduled

Anche per questa modalità, il servizio Auth risponde in modo sincrono con l’esito della transazione.

REQUEST​

{
  "txHead": {
    "merId": "{{merIdMoto}}",
    "txId": "test7"
  },
  "txReq": {
    "txOp": "SALE",
    "txIndicatorType": "MIT_UNSCHEDULED_COF_NEXT",
    "amount": {
      "value": 1700,
      "currency": "EUR"
    },
    "description": "Unsch Next TraceChain",
    "traceChainId": "CHAINID-20221205-1527"
  },
  "poiInfo": {
    "pitype": "CC"
  },
  "buyer": {
    "email": "paymentgateway@netsgroup.com",
    "language": "IT",
    "name": "Name",
    "lastName": "Surname"
  },
  "pi": {
    "tokenValue": "0D9971E639F08C458511E0DD67B4166D"
  },
  "errorURL": "https://www.merchant.com/error",
  "callbackURL": "https://www.merchant.com/server2server",
  "notifyURL": "https://www.merchant.com/done"
}

RESPONSE​

{
  "txHead": {
    "merId": "TEST-M",
    "txId": "test7",
    "resultCode": "IGFS_000",
    "errDescription": "TRANSAZIONE OK"
  },
  "txRes": {
    "paymentId": "139782946108079510",
    "tranId": 3069867810103798,
    "status": "OK"
  },
  "procRes": {
    "procId": "00",
    "procName": "SIMULATORE",
    "authCode": "000002",
    "addData": {
      "posId": "22222222",
      "merId": "1234567",
      "acquirerID": "00",
      "acquirerName": "SIMULATORE"
    }
  },
  "pi": {
    "tokenValue": "0D9971E639F08C458511E0DD67B4166D"
  },
  "poiInfo": {
    "pitype": "CC",
    "poiId": "TEST_MOTO"
  },
  "cardInfo": {
    "maskedpan": "444433******1111",
    "brand": "VISA"
  }
}