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 campoTipoMandatorioDescrizione
merchantIdStringYesIdentificativo dell'esercente assegnato da TINABA.
externalIdStringYesIdentificativo del pagamento pendente sul server dell'esercente. Deve essere univoco per ogni chiamata.
amountStringYesImporto in centesimi.
signatureStringYesFirma di autenticazione e integrità dei dati.

La firma d’integrità dei dati, scambiata nel campo “signature”, è basata su un segreto condiviso, scambiato offline, e 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 campoTipoMandatorioDescrizione
statusStringYes000 = OK




001 = KO.
errorCodeStringNoValorizzato solo se status = 001.







Codice di errore.

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",
      }
   }
}

$request = new VerifyCheckoutRequest();

$request->setExternalId('TR_01');

$response = $client->verifyCheckout($request);

echo "The checkout status is " . $response->checkoutStatus;

Per l'SDK PHP completo visitare questo link


from sdk.objects import RefundCheckoutRequest
action = factory.make('refund.checkout')
action.body_params = RefundCheckoutRequest(externalId='TR_01',
                                           amount='100')  # expressed in cents
response = action.run()

Per l'SDK PHP completo visitare questo link