Method: disburseFundsResultNotification

Comunica a Google il risultato di un pagamento una volta effettuata la chiamata al metodo disburseFunds.

Il valore disburseFundsResult è idempotente per questo disburseFundsRequestId, pertanto deve essere identico al valore restituito durante la chiamata disburseFunds e 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": "KcgwSKrV76eVNDUbsZ4UA3",
    "requestTimestamp": "1481852928293"
  },
  "paymentIntegratorAccountId": "InvisiCashUSA_USD",
  "disburseFundsRequestId": "awNaC510cefae3IJdNEvW2",
  "disburseFundsResult": {
    "disburseFundsResultCode": "SUCCESS"
  }
}

Un esempio di risposta è:


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

Richiesta HTTP

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

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "requestHeader": {
    object (RequestHeader)
  },
  "paymentIntegratorAccountId": string,
  "disburseFundsRequestId": string,
  "disburseFundsResult": {
    object (DisburseFundsResult)
  }
}
Campi
requestHeader

object (RequestHeader)

REQUIRED: intestazione comune per tutte le richieste.
paymentIntegratorAccountId

string

REQUIRED: identificatore dell'account integrato del pagamento sul quale è stato effettuato il pagamento.
disburseFundsRequestId

string

REQUIRED: un identificatore univoco per questa transazione. Questo è l'requestId generato da Google durante la chiamata disburseFunds a cui è associata questa richiesta.

Si tratta di una stringa con una lunghezza massima di 100 caratteri e contiene solo i caratteri "a-z", "A-Z", "0-9", ":", "-" e "_".
disburseFundsResult

object (DisburseFundsResult)

REQUIRED: il risultato di questa chiamata relativa ai fondi di pagamento.

Corpo della risposta

Oggetto della risposta per il metodo disburseFundsResultNotification.

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

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

object (ResponseHeader)

REQUIRED: intestazione comune per tutte le risposte.
result

enum (DisburseFundsResultNotificationResultCode)

REQUIRED: risultato della chiamata.

Risultato risultati erogazione

Informazioni sul risultato finale di un pagamento.

Rappresentazione JSON 
{
  "disburseFundsResultCode": enum (DisburseFundsResultCode),
  "rawResult": {
    object (RawResult)
  },

  // Union field FailureDetail can be only one of the following:
  "transactionMaxLimit": string,
  "transactionMinLimit": string
  // End of list of possible types for union field FailureDetail.
}
Campi
disburseFundsResultCode

enum (DisburseFundsResultCode)

REQUIRED: codice risultato di questo pagamento.
rawResult

object (RawResult)

FACOLTATIVO: risultato non elaborato di questo pagamento. Utilizzato per informare il motore di analisi e il rischio del rischio di Google. In situazioni di mappatura con codice rifiutato, a volte i dati vengono persi. L'integratore può scegliere di fornire a Google un codice non elaborato. Ad esempio, il gateway di una carta di credito (l'integratore) potrebbe utilizzare questo campo per comunicare a Google l'esatto codice di rifiuto ricevuto dalla rete VISA. In questo caso, scope sarà "visto" e rawCode sarà qualsiasi cosa restituisce la rete VISA.

Questo valore è obbligatorio se result non è SUCCESS.

Campo unione FailureDetail.

FailureDetail può essere solo uno dei seguenti:
transactionMaxLimit

string (Int64Value format)

FACOLTATIVO: se disburseFundsResultCode è DISBURSEMENT_EXCEEDS_TRANSACTION_LIMIT, questo è il valore della transazione massima consentita. Viene utilizzato per l'analisi strutturata e rivolta agli utenti e per l'analisi della percentuale di rifiuto.

Questo importo è pari ai micro la stessa currencyCode della chiamata al metodo disburseFunds originale.
transactionMinLimit

string (Int64Value format)

FACOLTATIVO: se disburseFundsResultCode è DISBURSEMENT_UNDER_TRANSACTION_LIMIT, questo è il valore della transazione minima consentita. Viene utilizzato per l'analisi strutturata e rivolta agli utenti e per l'analisi della percentuale di rifiuto.

Questo importo è pari ai micro la stessa currencyCode della chiamata al metodo disburseFunds originale.

Codice risultatoFundeFunds

Codici risultato per una chiamata ai fondi di pagamento.

Enum
UNKNOWN_RESULT Non impostare questo valore predefinito.
SUCCESS Pagamento riuscito.
DISBURSEMENT_UNDER_TRANSACTION_LIMIT L'importo della erogazione richiesta non soddisfa l'importo minimo per integratore dell'integratore. Se questo codice viene utilizzato, compila il campo transactionMinLimit con l'importo minimo della transazione per scopi di messaggistica dell'utente.
DISBURSEMENT_EXCEEDS_TRANSACTION_LIMIT L'importo della erogazione richiesta supera il limite massimo per transazione dell'integratore. Se questo codice viene utilizzato, compila il campo transactionMaxLimit con il limite di transazioni per i messaggi dell'utente.
ACCOUNT_CLOSED L'account dell'utente in possesso dell'integratore è stato chiuso. Questo valore restituito comporterà la chiusura dello strumento dell'utente con Google. L'utente sarà costretto ad aggiungere un nuovo strumento.
ACCOUNT_CLOSED_ACCOUNT_TAKEN_OVER L'account dell'utente con l'integratore è stato chiuso, il sospetto sospetto è avvenuto sull'account. Questo valore restituito comporterà la chiusura dello strumento dell'utente con Google. L'utente sarà costretto ad aggiungere un nuovo strumento.
ACCOUNT_CLOSED_FRAUD L'account dell'utente in possesso dell'integratore è stato chiuso a causa di attività fraudolente. Questo valore restituito comporterà la chiusura dello strumento dell'utente con Google. L'utente sarà costretto ad aggiungere un nuovo strumento.
ACCOUNT_ON_HOLD L'account dell'utente è sospeso.

Risultato non elaborato

Oggetto risultato non elaborato.

Rappresentazione JSON 
{
  "scope": string,
  "rawCode": string
}
Campi
scope

string

OPTIONAL: l'ambito di rawCode può essere vuoto.
rawCode

string

REQUIRED: codice non elaborato dell'integratore o dei sottosistemi al suo interno.

Codice dei risultati_della_notifica_dei_fondi

Codici dei risultati per il metodo disburseFundsResultNotification.

Enum
UNKNOWN_RESULT Non impostare questo valore predefinito.
SUCCESS La notifica è stata elaborata correttamente.