Method: refundResultNotification

Comunica a Google il risultato del rimborso dopo che è stata effettuata una chiamata al metodo refund.

I rimborsi dovrebbero essere gestiti in modo sincrono durante la chiamata al metodo refund, ma questo metodo fornisce a Google un indicatore di backup rapido nel caso in cui la chiamata sincrona non vada a buon fine dopo aver eseguito l'azione, ma prima che possa restituire un risultato. In questo modo è possibile evitare il ritardo introdotto da Google per la pianificazione di un nuovo tentativo in futuro.

Il valore refundResult è idempotente per questo refundRequestId, pertanto non può essere modificato da una chiamata successiva a questo metodo.

Se si verifica un errore durante l'elaborazione della richiesta, la risposta di questo endpoint sarà di tipo ErrorResponse.

Le risposte a questa query potrebbero essere vuote se questo metodo non restituisce un codice HTTP 200. Il corpo della risposta è vuoto nel caso in cui un ErrorResponse con una descrizione chiara possa essere utilizzato per aiutare un utente malintenzionato a comprendere l'identificatore di account integratore di pagamento di altri integratori. In questi casi, in cui la chiave di firma non corrisponde, non è stato trovato l'identificatore dell'integratore dei pagamenti o la chiave di crittografia era sconosciuta, questo metodo restituirà un errore HTTP 404 con un corpo vuoto. Se è stato possibile verificare la firma della richiesta, nel corpo della risposta verranno restituite ulteriori informazioni sull'errore.

Una richiesta di esempio ha il seguente aspetto:


{
  "requestHeader": {
    "protocolVersion": {
      "major": 1,
      "minor": 1,
      "revision": 0
    },
    "requestId": "HsKv5pvtQKTtz7rdcw1YqE",
    "requestTimestamp": "1481855928301"
  },
  "paymentIntegratorAccountId": "InvisiCashUSA_USD",
  "refundRequestId": "hH1T32PI86CpKwjuf6oD2r",
  "paymentIntegratorRefundId": "invisi/Id::xx__1243",
  "refundResult": "SUCCESS"
}

Un esempio di risposta è:


{
  "responseHeader": {
    "responseTimestamp": "1481855928376"
  },
  "result": "SUCCESS"
}

Richiesta HTTP

POST https://vgw.googleapis.com/secure-serving/gsp/v1/refundResultNotification/:PIAID

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "requestHeader": {
    object (RequestHeader)
  },
  "paymentIntegratorAccountId": string,
  "refundRequestId": string,
  "refundResult": enum (RefundResultCode),
  "paymentIntegratorRefundId": string
}
Campi
requestHeader

object (RequestHeader)

REQUIRED: intestazione comune per tutte le richieste.
paymentIntegratorAccountId

string

REQUIRED: identificatore dell'account integrato del pagamento per il quale si è verificato il rimborso.
refundRequestId

string

REQUIRED: identificatore univoco del rimborso stabilito dal campo requestId al momento della chiamata del metodo refund.
refundResult

enum (RefundResultCode)

REQUIRED: risultato del rimborso.
paymentIntegratorRefundId

string

REQUIRED: questo identificatore è specifico dell'integratore e viene generato dall'integratore. Si tratta dell'identificatore utilizzato dall'integratore per conoscere il rimborso.

Per praticità, questo identificatore è incluso nei dettagli di versamento

Corpo della risposta

Oggetto della risposta per il metodo refundResultNotification.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "result": enum (RefundResultNotificationResultCode)
}
Campi
responseHeader

object (ResponseHeader)

REQUIRED: intestazione comune per tutte le risposte.
result

enum (RefundResultNotificationResultCode)

REQUIRED: risultato della chiamata.

CodiceRisultatoRimborso

I rimborsi per i codici univoci.

Enum
UNKNOWN_RESULT Non impostare questo valore predefinito.
SUCCESS Rimborso inviato.
NO_MONEY_LEFT_ON_TRANSACTION Rimborso non riuscito, non è rimasto alcun importo della transazione. In genere si tratta di un bug tra l'integratore e Google. Google non deve chiedere il rimborso di un importo superiore a quello originale.
ACCOUNT_CLOSED

L'account in possesso dell'integratore è stato chiuso.

Se restituisci questo valore, lo strumento dell'utente verrà chiuso con Google. L'utente sarà costretto ad aggiungere un nuovo strumento attraversando nuovamente la procedura di associazione.
ACCOUNT_CLOSED_ACCOUNT_TAKEN_OVER

L'account dell'utente con l'integratore è stato chiuso, il sospetto sospetto di violazione dell'account.

Se restituisci questo valore, lo strumento dell'utente verrà chiuso con Google. L'utente sarà costretto ad aggiungere un nuovo strumento attraversando nuovamente la procedura di associazione.
ACCOUNT_CLOSED_FRAUD

L'account dell'utente in possesso dell'integratore è stato chiuso a causa di attività fraudolente.

Se restituisci questo valore, lo strumento dell'utente verrà chiuso con Google. L'utente sarà costretto ad aggiungere un nuovo strumento attraversando nuovamente la procedura di associazione.
ACCOUNT_ON_HOLD L'account dell'utente è attualmente sospeso e non può accettare il rimborso, ma l'account dell'utente potrebbe essere in grado di accettare il rimborso in un secondo momento. Google potrebbe richiedere un altro rimborso in futuro, ma lo farà con un nuovo requestId, pertanto questa richiesta deve essere considerata completata.
REFUND_EXCEEDS_MAXIMUM_BALANCE Non è possibile elaborare il rimborso al momento perché, così facendo, il saldo dell'utente supera l'importo massimo consentito. Google potrebbe richiedere un altro rimborso in futuro, ma lo farà con un nuovo requestId, pertanto questa richiesta deve essere considerata completata.
REFUND_WINDOW_EXCEEDED Non è possibile elaborare il rimborso perché la richiesta non rientra nel periodo di rimborso consentito.

Codice di rimborsorisultatodirisultato

Codici dei risultati per il metodo refundResultNotification.

Enum
UNKNOWN_RESULT Non impostare questo valore predefinito.
SUCCESS Notifica del risultato del rimborso riuscita.