Method: refundResultNotification

Benachrichtigen Sie Google nach einem refund-Methodenaufruf über das Ergebnis einer Erstattung.

Erstattungen sollten synchron während des refund-Methodenaufrufs erfolgen. Mit dieser Methode erhält Google jedoch ein schnelles Back-up-Signal für den Fall, dass der synchrone Aufruf fehlschlägt, nachdem die Aktion ausgeführt wurde, aber bevor ein Ergebnis zurückgegeben werden kann. Dadurch wird die Verzögerung vermieden, die durch die Planung eines erneuten Versuchs durch Google entsteht.

Der Wert refundResult ist für diese refundRequestId idempotent. Sein Wert kann daher 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": "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)

ERFORDERLICH: Gemeinsamer Header für alle Anfragen.
paymentIntegratorAccountId

string

ERFORDERLICH: Die Konto-ID des Zahlungsintegrators, für die die Erstattung erfolgt ist.
refundRequestId

string

ERFORDERLICH: Eindeutige Kennung für diese Erstattung, die durch das Feld requestId beim Aufruf der Methode refund ermittelt wurde.
refundResult

enum (RefundResultCode)

ERFORDERLICH: Ergebnis dieser Erstattung.
paymentIntegratorRefundId

string

ERFORDERLICH: Diese Kennung ist für den Integrator spezifisch und wird vom Integrator generiert. Dies ist die Kennung, anhand derer der Integrator die Erstattung 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)

ERFORDERLICH: Gemeinsamer Header für alle Antworten.
result

enum (RefundResultNotificationResultCode)

REQUIRED: Ergebnis dieses Aufrufs.

RefundResultCode

Die eindeutigen Ergebniscodes werden erstattet.

Enums
UNKNOWN_RESULT Legen Sie diesen Standardwert niemals fest.
SUCCESS Erstattung erfolgreich.
NO_MONEY_LEFT_ON_TRANSACTION Erstattung fehlgeschlagen: Die Transaktion weist kein Geld mehr auf. In der Regel handelt es sich dabei um einen Fehler zwischen dem Integrator und Google. Google sollte keine Erstattung eines Betrags verlangen, der über der ursprünglichen Aufnahme liegt.
ACCOUNT_CLOSED

Das Konto des Integrators wurde geschlossen.

Wird dieser Wert zurückgegeben, wird das Zahlungsmittel des Nutzers mit Google geschlossen. Der Nutzer wird gezwungen, ein neues Zahlungsmittel hinzuzufügen, indem er den Verknüpfungsvorgang noch einmal durchläuft.
ACCOUNT_CLOSED_ACCOUNT_TAKEN_OVER

Das Nutzerkonto beim Integrator wurde geschlossen, da eine Kontoübernahme vermutet wird.

Wird dieser Wert zurückgegeben, wird das Zahlungsmittel des Nutzers mit Google geschlossen. Der Nutzer wird gezwungen, ein neues Zahlungsmittel hinzuzufügen, indem er den Verknüpfungsvorgang noch einmal durchläuft.
ACCOUNT_CLOSED_FRAUD

Das Konto des Integrators wurde wegen Betrugs geschlossen.

Wird dieser Wert zurückgegeben, wird das Zahlungsmittel des Nutzers mit Google geschlossen. 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 ausgesetzt und kann die Erstattung nicht akzeptieren. Möglicherweise kann sie aber zu einem späteren Zeitpunkt über das Konto des Nutzers angenommen werden. Google kann in Zukunft eine weitere Erstattung beantragen, wird dies jedoch mit einer neuen requestId tun. Der Antrag gilt daher als abgeschlossen.
REFUND_EXCEEDS_MAXIMUM_BALANCE Die Erstattung kann derzeit nicht verarbeitet werden, da das Guthaben des Nutzers dadurch den maximal zulässigen Betrag überschreiten würde. Google kann in Zukunft eine weitere Erstattung beantragen, wird dies jedoch mit einer neuen requestId tun. Der Antrag gilt daher als abgeschlossen.
REFUND_WINDOW_EXCEEDED Die Erstattung kann nicht bearbeitet werden, da der Antrag außerhalb des zulässigen Erstattungszeitraums liegt.

RefundResultNotificationResultCode

Ergebniscodes für die Methode refundResultNotification.

Enums
UNKNOWN_RESULT Legen Sie diesen Standardwert niemals fest.
SUCCESS Benachrichtigung über Erstattungsergebnis wurde erfolgreich gesendet.