Method: disburseFundsResultNotification

Benachrichtigen Sie Google über das Ergebnis einer Auszahlung, nachdem der disburseFunds-Methodenaufruf erfolgt ist.

Der Wert disburseFundsResult ist für diese disburseFundsRequestId idempotent. Sein Wert muss also mit dem Wert identisch sein, der während des disburseFunds-Aufrufs zurückgegeben wurde. Er kann nicht durch einen nachfolgenden Aufruf dieser Methode geändert werden.

Wenn am Endpunkt bei der Verarbeitung der Anfrage ein Fehler auftritt, ist die Antwort dieses Endpunkts vom Typ ErrorResponse.

Die Antworten auf diese Abfrage sind möglicherweise leer, wenn diese Methode keinen HTTP 200-Fehler zurückgibt. Der Antworttext ist leer, wenn ein ErrorResponse mit einer eindeutigen Beschreibung verwendet werden könnte, um einem Angreifer zu helfen, die Kennung des Zahlungsintegrators anderer Integratoren zu verstehen. In Situationen, in denen der Signaturschlüssel nicht übereinstimmt, die Zahlungsintegrator-ID nicht gefunden wurde oder der Verschlüsselungsschlüssel unbekannt war, gibt diese Methode einen HTTP 404-Fehler mit einem leeren Text zurück. Wenn die Anfragesignatur verifiziert werden konnte, werden im Antworttext zusätzliche Informationen zum Fehler zurückgegeben.

Eine Beispielanfrage sieht so aus:


{
  "requestHeader": {
    "protocolVersion": {
      "major": 1,
      "minor": 1,
      "revision": 0
    },
    "requestId": "KcgwSKrV76eVNDUbsZ4UA3",
    "requestTimestamp": "1481852928293"
  },
  "paymentIntegratorAccountId": "InvisiCashUSA_USD",
  "disburseFundsRequestId": "awNaC510cefae3IJdNEvW2",
  "disburseFundsResult": {
    "disburseFundsResultCode": "SUCCESS"
  }
}

Eine Beispielantwort sieht so aus:


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

HTTP-Anfrage

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

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "requestHeader": {
    object (RequestHeader)
  },
  "paymentIntegratorAccountId": string,
  "disburseFundsRequestId": string,
  "disburseFundsResult": {
    object (DisburseFundsResult)
  }
}
Felder
requestHeader

object (RequestHeader)

ERFORDERLICH: Gemeinsamer Header für alle Anfragen.
paymentIntegratorAccountId

string

ERFORDERLICH: Die Konto-ID des Zahlungsintegrators, über die die Auszahlung erfolgt ist.
disburseFundsRequestId

string

ERFORDERLICH: Eine eindeutige Kennung für diese Transaktion. Das ist die requestId, die von Google während des disburseFunds-Aufrufs generiert wurde, mit dem diese Anfrage verknüpft ist.

Dieser String hat eine maximale Länge von 100 Zeichen und enthält nur die Zeichen „a–z“, „A–Z“, „0–9“, ":", „-“ und „_“.
disburseFundsResult

object (DisburseFundsResult)

REQUIRED: Ergebnis dieses Auszahlungsaufrufs.

Antworttext

Antwortobjekt für die Methode disburseFundsResultNotification.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "result": enum (DisburseFundsResultNotificationResultCode)
}
Felder
responseHeader

object (ResponseHeader)

ERFORDERLICH: Gemeinsamer Header für alle Antworten.
result

enum (DisburseFundsResultNotificationResultCode)

REQUIRED: Ergebnis dieses Aufrufs.

DisburseFundsResult

Informationen über das Endergebnis einer Auszahlung.

JSON-Darstellung 
{
  "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.
}
Felder
disburseFundsResultCode

enum (DisburseFundsResultCode)

REQUIRED: Ergebniscode dieser Auszahlung
rawResult

object (RawResult)

OPTIONAL: Das Rohergebnis dieser Auszahlung. Wird zur Verbesserung der Risikoanalyse und der Risikoanalyse von Google verwendet. Bei abgelehnten Codezuordnungen gehen Daten manchmal verloren. Der Integrator kann Google einen Rohcode zur Verfügung stellen. Beispielsweise kann ein Kreditkarten-Gateway (der Integrationspartner) dieses Feld verwenden, um Google den genauen Ablehnungscode mitzuteilen, der vom VISA-Netzwerk erhalten wurde. In diesem Fall wäre die scope „Visum“. und rawCode entspricht dem Betrag, der vom VISA-Netzwerk zurückgegeben wurde.

Dieser Wert ist erforderlich, wenn result nicht SUCCESS ist.

Union-Feld FailureDetail.

Für FailureDetail ist nur einer der folgenden Werte zulässig:
transactionMaxLimit

string (Int64Value format)

OPTIONAL: Wenn disburseFundsResultCode gleich DISBURSEMENT_EXCEEDS_TRANSACTION_LIMIT ist, ist dies der Wert der maximal zulässigen Transaktion. Sie wird für strukturierte, an den Nutzer gerichtete Mitteilungen und für die Analyse der Ablehnungsrate verwendet.

Dieser Wert entspricht micros von currencyCode des ursprünglichen Aufrufs der disburseFunds-Methode.
transactionMinLimit

string (Int64Value format)

OPTIONAL: Wenn disburseFundsResultCode gleich DISBURSEMENT_UNDER_TRANSACTION_LIMIT ist, ist dies der Wert der minimal zulässigen Transaktion. Sie wird für strukturierte, an den Nutzer gerichtete Mitteilungen und für die Analyse der Ablehnungsrate verwendet.

Dieser Wert entspricht micros von currencyCode des ursprünglichen Aufrufs der disburseFunds-Methode.

DisburseFundsResultCode

Ergebniscodes für einen Auszahlungsaufruf.

Enums
UNKNOWN_RESULT Legen Sie diesen Standardwert niemals fest.
SUCCESS Auszahlung erfolgreich.
DISBURSEMENT_UNDER_TRANSACTION_LIMIT Der angeforderte Auszahlungsbetrag entspricht nicht dem Mindestwert pro Transaktion des Integrators. Wenn dieser Code verwendet wird, geben Sie in das Feld transactionMinLimit den Mindesttransaktionsbetrag für Mitteilungen an Nutzer ein.
DISBURSEMENT_EXCEEDS_TRANSACTION_LIMIT Der angeforderte Auszahlungsbetrag überschreitet das maximale Limit des Integrators pro Transaktion. Wenn dieser Code verwendet wird, geben Sie in das Feld transactionMaxLimit das Transaktionslimit für Mitteilungen an Nutzer ein.
ACCOUNT_CLOSED Das beim Integrator geführte Nutzerkonto wurde geschlossen. Dieser Rückgabewert führt dazu, dass das Zahlungsmittel des Nutzers mit Google geschlossen wird. Der Nutzer wird gezwungen, ein neues Zahlungsmittel hinzuzufügen.
ACCOUNT_CLOSED_ACCOUNT_TAKEN_OVER Das Nutzerkonto beim Integrator wurde geschlossen, da eine Kontoübernahme vermutet wird. Dieser Rückgabewert führt dazu, dass das Zahlungsmittel des Nutzers mit Google geschlossen wird. Der Nutzer wird gezwungen, ein neues Zahlungsmittel hinzuzufügen.
ACCOUNT_CLOSED_FRAUD Das Nutzerkonto beim Integrator wurde wegen Betrugs geschlossen. Dieser Rückgabewert führt dazu, dass das Zahlungsmittel des Nutzers mit Google geschlossen wird. Der Nutzer wird gezwungen, ein neues Zahlungsmittel hinzuzufügen.
ACCOUNT_ON_HOLD Das Konto des Nutzers wurde auf „Hold“ gesetzt.

RawResult

Rohergebnisobjekt.

JSON-Darstellung 
{
  "scope": string,
  "rawCode": string
}
Felder
scope

string

OPTIONAL: Gültigkeitsbereich von rawCode, kann leer sein.
rawCode

string

ERFORDERLICH: Rohcode vom Integrator oder den enthaltenen Subsystemen.

DisburseFundsResultNotificationResultCode

Ergebniscodes für die Methode disburseFundsResultNotification.

Enums
UNKNOWN_RESULT Legen Sie diesen Standardwert niemals fest.
SUCCESS Die Benachrichtigung wurde verarbeitet.