Method: disburseFundsResultNotification

Google nach dem Aufruf der Methode disburseFunds über das Ergebnis einer Auszahlung benachrichtigen.

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

Wenn beim Verarbeiten der Anfrage ein Fehler auftritt, hat die Antwort vom Endpunkt ErrorResponse.

Die Antworten auf diese Abfrage können leer sein, wenn die Methode kein HTTP 200 zurückgibt. Der Antworttext ist leer, wenn ein ErrorResponse mit einer klaren Beschreibung verwendet werden könnte, um einem Angreifer die Identifizierung des Zahlungsintegrators mit anderen Integratoren zu erleichtern. Wenn der Signaturschlüssel nicht übereinstimmt, die Zahlungsintegrations-ID nicht gefunden wurde oder der Verschlüsselungsschlüssel unbekannt ist, gibt diese Methode einen HTTP 404-Code mit leerem Text zurück. Wenn die Anfragesignatur verifiziert werden kann, werden zusätzliche Informationen zum Fehler im Antworttext 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)

REQUIRED: Allgemeiner Header für alle Anfragen.
paymentIntegratorAccountId

string

ERFORDERLICH: Die ID des Zahlungsintegrationskontos, auf dem die Auszahlung erfolgt ist.
disburseFundsRequestId

string

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

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

object (DisburseFundsResult)

ERFORDERLICH: Ergebnis dieser Zahlung.

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)

REQUIRED: Allgemeiner Header für alle Antworten.
result

enum (DisburseFundsResultNotificationResultCode)

ERFORDERLICH: Ergebnis des Anrufs.

Ergebnis auszahlen

Informationen zum 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)

ERFORDERLICH: Ergebniscode dieser Auszahlung.
rawResult

object (RawResult)

OPTIONAL: Unbearbeitetes Ergebnis dieser Auszahlung. Wird verwendet, um die Risiko-Engine und Analysen von Google zu unterstützen. Bei der Ablehnung von Codezuordnungen gehen Daten manchmal verloren. Dieser kann Google einen Rohcode geben. Über ein Kreditkarten-Gateway (Integrator) kann beispielsweise dieses Feld verwendet werden, um Google über den genauen Ablehnungscode zu informieren, der vom VISA-Netzwerk empfangen wurde. In diesem Fall wäre das scope „visa“ und das rawCode das vom VISA-Netzwerk zurückgegebene Element.

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 den Wert DISBURSEMENT_EXCEEDS_TRANSACTION_LIMIT hat, ist dies der Wert der maximal zulässigen Transaktion. Er wird für strukturierte, nutzerbezogene Werbebotschaften und die Analyse der Ablehnungsrate verwendet.

Dieser Betrag ist micros des gleichen currencyCode wie der ursprüngliche disburseFunds-Methodenaufruf.
transactionMinLimit

string (Int64Value format)

OPTIONAL: Wenn disburseFundsResultCode den Wert DISBURSEMENT_UNDER_TRANSACTION_LIMIT hat, ist dies der Wert der zulässigen Mindesttransaktion. Er wird für strukturierte, nutzerbezogene Werbebotschaften und die Analyse der Ablehnungsrate verwendet.

Dieser Betrag ist micros des gleichen currencyCode wie der ursprüngliche disburseFunds-Methodenaufruf.

DisburseFundsResultCode

Ergebniscodes für einen Anruf zur Auszahlung.

Enums
UNKNOWN_RESULT Legen Sie diesen Standardwert nie fest.
SUCCESS Die Auszahlung war erfolgreich.
DISBURSEMENT_UNDER_TRANSACTION_LIMIT Der angeforderte Auszahlungsbetrag entspricht nicht dem Mindestbetrag des Integrationspartners pro Transaktion. Wenn dieser Code verwendet wird, füllen Sie das Feld transactionMinLimit mit dem Mindesttransaktionsbetrag für Nutzermitteilungen aus.
DISBURSEMENT_EXCEEDS_TRANSACTION_LIMIT Der angeforderte Auszahlungsbetrag überschreitet den Maximalbetrag pro Transaktion. Wenn dieser Code verwendet wird, füllen Sie das Feld transactionMaxLimit mit dem Transaktionslimit für Nutzermitteilungen aus.
ACCOUNT_CLOSED Das mit dem Integrationsinhaber verknüpfte Konto wurde geschlossen. Dieser Wert führt dazu, dass das Zahlungsmittel des Nutzers bei Google geschlossen wird. Der Nutzer wird gezwungen, ein neues Zahlungsmittel hinzuzufügen.
ACCOUNT_CLOSED_ACCOUNT_TAKEN_OVER Das Nutzerkonto des Integrationspartners wurde geschlossen. Verdacht auf eine Kontoübernahme. Dieser Wert führt dazu, dass das Zahlungsmittel des Nutzers bei Google geschlossen wird. Der Nutzer wird gezwungen, ein neues Zahlungsmittel hinzuzufügen.
ACCOUNT_CLOSED_FRAUD Das Nutzerkonto des Integrationspartners wurde wegen Betrugs geschlossen. Dieser Wert führt dazu, dass das Zahlungsmittel des Nutzers bei Google geschlossen wird. Der Nutzer wird gezwungen, ein neues Zahlungsmittel hinzuzufügen.
ACCOUNT_ON_HOLD Das Konto des Nutzers ist vorübergehend deaktiviert.

Rohergebnis

Ergebnisobjekt.

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

string

OPTIONAL: Der Bereich des RawCode-Bereichs kann leer sein.
rawCode

string

ERFORDERLICH: Der Rohcode des Integrations- oder untergeordneten Systems.

DisburseFundsResultNotificationResultCode

Ergebniscodes für die Methode disburseFundsResultNotification.

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