Objekt: ErrorResponse

Antworttext

HTTP-Text für alle Nicht-200-HTTP-Antworten.

Eine Beispielantwort sieht so aus:


  {
    "responseHeader": {
      "requestTimestamp": "1481899949611"
    },
    "errorResponseCode": "INVALID_IDENTIFIER",
    "errorDescription": "Unknown paymentIntegratorAccountId: PIAID1",
  }
JSON-Darstellung 
{
  "responseHeader": {
    object(ResponseHeader)
  },
  "errorResponseCode": string,
  "errorDescription": string,
}
Felder
responseHeader

object(ResponseHeader)

REQUIRED: Allgemeiner Header für alle Antworten.

errorResponseCode

string

OPTIONAL: Geben Sie einen der Codes aus der folgenden Tabelle an.

Fehlerantwortcodes und Empfohlene HTTP-Codes
INVALID_API_VERSION 400

Wird verwendet, wenn der Integrator die API-Version der Anfrage nicht unterstützt.

INVALID_PAYLOAD_SIGNATURE 401

Wird verwendet, wenn die Signatur der Nutzlast für einen unbekannten oder inaktiven Schlüssel ist.

INVALID_PAYLOAD_ENCRYPTION 400

Wird verwendet, wenn die Verschlüsselung der Nutzlast für einen unbekannten oder inaktiven Schlüssel ist.

REQUEST_TIMESTAMP_OUT_OF_RANGE 400

Wird verwendet, wenn request_timestamp nicht mehr als ± 60 Sek. beträgt.

INVALID_IDENTIFIER 404

Wird verwendet, wenn eine in der Anfrage gesendete Kennung ungültig oder unbekannt war. Dazu können paymentIntegratorAccountId, googlePaymentToken, captureRequestId usw. gehören. Der Typ der ungültigen Kennung muss in errorDescription angegeben werden.

IDEMPOTENCY_VIOLATION 412

Wird verwendet, wenn die Anfrage die Idempotenzanforderungen für die Anfrage verletzt.

INVALID_FIELD_VALUE 400

Wird verwendet, wenn die Anfrage einen Wert für ein Feld enthält, das sich nicht im Satz unterstützter Werte befindet.

MISSING_REQUIRED_FIELD 400

Wird verwendet, wenn ein erforderliches Feld in der Anfrage nicht festgelegt ist.

PRECONDITION_VIOLATION 400

Wird verwendet, wenn eine Einschränkung für den Vorgang verletzt wird, z.B. wenn eine Anfrage für einen Erstattungsbetrag den bei der Transaktion verbleibenden Betrag überschreitet.

USER_ACTION_IN_PROGRESS 400

Wird verwendet, wenn die Anfrage zu diesem Zeitpunkt nicht verarbeitet werden kann, weil dadurch eine laufende Nutzeraktion unterbrochen würde, die faktisch als Systemsperre fungiert. Dieser Code darf nicht verwendet werden, um Fehler aufgrund von implementierungsspezifischen internen Gleichzeitigkeitsfehlern anzuzeigen.

INVALID_DECRYPTED_REQUEST 400

Wird verwendet, wenn die Nutzlast der Anfrage entschlüsselt, die Nachricht aber nicht geparst werden konnte.

errorDescription

string

OPTIONAL: Beschreiben Sie diesen Status, damit Mitarbeiter des Supportteams Fehler beheben können. Dieser wird Nutzern nie angezeigt. Er kann beschreibenden, nicht vertraulichen Text zur Fehlerbehebung enthalten. Beachten Sie, dass einige Werte für errorResponseCode zusätzliche Details in diesem Feld enthalten sollten (z.B. sollte für INVALID_IDENTIFIER in diesem Feld angegeben werden, welcher Kennungstyp ungültig war).