Method: refundResultNotification

Google nach dem Verwenden eines refund-Methodenaufrufs über das Ergebnis informieren.

Erstattungen sollten während des Aufrufs der refund-Methode synchron erfolgen. Über diese Methode erhält Google jedoch ein schnelles Sicherungssignal für den Fall, dass der synchrone Aufruf nach Ausführung der Aktion fehlschlägt, aber bevor ein Ergebnis zurückgegeben werden kann. So wird vermieden, dass Google einen Wiederholungsversuch für einen zukünftigen Zeitraum plant.

Der Wert refundResult ist für diese refundRequestId idempotent, d. h., er kann nicht durch einen nachfolgenden Aufruf dieser Methode 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": "HsKv5pvtQKTtz7rdcw1YqE",
    "requestTimestamp": "1481855928301"
  },
  "paymentIntegratorAccountId": "InvisiCashUSA_USD",
  "refundRequestId": "hH1T32PI86CpKwjuf6oD2r",
  "paymentIntegratorRefundId": "invisi/Id::xx__1243",
  "refundResult": "SUCCESS"
}

Eine Beispielantwort sieht so aus:


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

HTTP-Anfrage

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

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "requestHeader": {
    object (RequestHeader)
  },
  "paymentIntegratorAccountId": string,
  "refundRequestId": string,
  "refundResult": enum (RefundResultCode),
  "paymentIntegratorRefundId": string
}
Felder
requestHeader

object (RequestHeader)

REQUIRED: Allgemeiner Header für alle Anfragen.
paymentIntegratorAccountId

string

ERFORDERLICH: Die ID des Zahlungsintegrationskontos, für das die Erstattung erfolgt ist.
refundRequestId

string

REQUIRED: Eindeutige Kennung für diese Erstattung, die durch das Feld requestId beim Aufrufen der Methode refund festgelegt wurde.
refundResult

enum (RefundResultCode)

ERFORDERLICH: Ergebnis dieser Erstattung.
paymentIntegratorRefundId

string

ERFORDERLICH: Diese Kennung wird für den Integrator verwendet und generiert. Das ist die Kennung, mit der der Integrator diese Rückerstattung kennt.

Der Einfachheit halber ist diese ID in den Überweisungsdetails enthalten.

Antworttext

Antwortobjekt für die Methode refundResultNotification.

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

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

object (ResponseHeader)

REQUIRED: Allgemeiner Header für alle Antworten.
result

enum (RefundResultNotificationResultCode)

ERFORDERLICH: Ergebnis des Anrufs.

Erstattungscode

Der eindeutige Ergebniscode erstattet Erstattungen.

Enums
UNKNOWN_RESULT Legen Sie diesen Standardwert nie fest.
SUCCESS Erfolgreiche Erstattung.
NO_MONEY_LEFT_ON_TRANSACTION Erstattung fehlgeschlagen. Für die Transaktion wurde kein Geld mehr ausgegeben. In der Regel ist dies ein Fehler zwischen dem Integrationspartner und Google. Google sollte nicht um eine Erstattung eines Betrags bitten, der über dem ursprünglichen Betrag liegt.
ACCOUNT_CLOSED

Das Konto des Integrationspartners wurde geschlossen.

Die Rückgabe dieses Werts führt dazu, dass das Zahlungsmittel des Nutzers bei Google geschlossen wird. Der Nutzer wird gezwungen, ein neues Zahlungsmittel hinzuzufügen, indem er den Verknüpfungsvorgang noch einmal durchläuft.
ACCOUNT_CLOSED_ACCOUNT_TAKEN_OVER

Das Konto des Nutzers beim Integrationspartner wurde geschlossen. Verdacht auf eine Kontoübernahme.

Die Rückgabe dieses Werts führt dazu, dass das Zahlungsmittel des Nutzers bei Google geschlossen wird. Der Nutzer wird gezwungen, ein neues Zahlungsmittel hinzuzufügen, indem er den Verknüpfungsvorgang noch einmal durchläuft.
ACCOUNT_CLOSED_FRAUD

Das Konto des Integrationspartners wurde aufgrund von Betrug geschlossen.

Die Rückgabe dieses Werts führt dazu, dass das Zahlungsmittel des Nutzers bei Google geschlossen wird. Der Nutzer wird gezwungen, ein neues Zahlungsmittel hinzuzufügen, indem er den Verknüpfungsvorgang noch einmal durchläuft.
ACCOUNT_ON_HOLD Das Konto des Nutzers ist derzeit zurückgehalten und kann nicht erstattet werden. Das kann jedoch später sein. Google kann in Zukunft eine weitere Erstattung beantragen. Dies wird jedoch mit einer neuen requestId beantragt. Die Anfrage sollte also als abgeschlossen betrachtet werden.
REFUND_EXCEEDS_MAXIMUM_BALANCE Die Erstattung kann momentan nicht verarbeitet werden, da das Guthaben des Nutzers sonst den maximal zulässigen Betrag überschreiten würde. Google kann in Zukunft eine weitere Erstattung beantragen. Dies wird jedoch mit einer neuen requestId beantragt. Die Anfrage sollte also als abgeschlossen betrachtet werden.
REFUND_WINDOW_EXCEEDED Die Erstattung kann nicht verarbeitet werden, weil sie außerhalb des zulässigen Erstattungszeitraums liegt.

Erstattungsergebnis für Ergebnisbenachrichtigung

Ergebniscodes für die Methode refundResultNotification.

Enums
UNKNOWN_RESULT Legen Sie diesen Standardwert nie fest.
SUCCESS Die Benachrichtigung zum Erstattungsergebnis wurde erfolgreich gesendet.