API refundCheckout

[API OPZIONALE]

Rimborso di un pagamento (Server dell’esercente > Tinaba). Questa API può essere utilizzata per effettuare un rimborso totale o parziale.

Spiegazione degli attributi

Nome campo	Tipo	Mandatorio	Descrizione
merchantId	String	Yes	Identificativo dell’esercente assegnato da TINABA.
externalId	String	Yes	Identificativo del pagamento pendente sul server dell’esercente. Deve essere univoco per ogni chiamata.
amount	String	Yes	Importo in centesimi.
signature	String	Yes	Firma di autenticazione e integrità dei dati.

La firma d’integrità dei dati, scambiata nel campo “signature”, è basata su un segreto condiviso, scambiato offline, ed è generata utilizzando il protocollo SHA256.

signature = base64(SHA256(<merchantId><externalId><secret>))

Per maggiori informazioni su come generare la firma d’integrità consultare:

Integrità dei dati >

Spiegazione degli attributi – Risposta

Nome campo	Tipo	Mandatorio	Descrizione
status	String	Yes	000 = OK 001 = KO.
errorCode	String	No	Valorizzato solo se status = 001. Codice di errore.

JSON

Richiesta

{
   "data":{
      "request":{
         "refundCheckoutRequest":{
            "merchantId":"12",
            "externalId":"TR_1",
            "amount":"100",
            "signature":"AAIR12345"
         }
      }
   }
}

Risposte

200 Success

{
   " response":{
      "refundCheckoutResponse":{
         "status":"000"
      }
   }
}

400 Errore Validazione

{
   " response":{
      "refundCheckoutResponse":{
         "status":"001",
         "errorCode":"XXX",
      }
   }
}