Method: getDisputeInquiryReport

Pobierz raport z informacjami, które ułatwią Ci prowadzenie z obsługą klienta rozmowy na temat potencjalnego sporu dotyczącego płatności.

Jeśli ta metoda nie zwróci kodu HTTP 200, odpowiedzi na to zapytanie mogą być puste.

Jeśli podczas przetwarzania żądania punkt końcowy napotka błąd, odpowiedź z tego punktu końcowego będzie typu ErrorResponse.

Jeśli ta metoda nie zwróci kodu HTTP 200, odpowiedzi na to zapytanie mogą być puste. Treść odpowiedzi jest pusta w sytuacjach, gdy ErrorResponse z jasnym opisem mógłby pomóc atakującemu zrozumieć identyfikator konta integratora płatności innych integratorów. W takich sytuacjach, gdy klucz podpisywania jest niezgodny, nie znaleziono identyfikatora integratora płatności lub klucz szyfrowania był nieznany, metoda zwraca błąd HTTP 404 z pustą treścią. Jeśli uda się zweryfikować podpis żądania, w treści odpowiedzi pojawią się dodatkowe informacje o błędzie.

Przykładowe żądanie wygląda tak:


{
  "requestHeader": {
    "protocolVersion": {
      "major": 3
    },
    "requestId": "HsKv5pvtQKTtz7rdcw1YqE",
    "requestTimestamp": {
      "epochMillis": "1519996751331"
    },
    "paymentIntegratorAccountId": "InvisiCashUSA_USD"
  },
  "paymentLookupCriteria": {
    "googleTransactionReferenceNumberCriteria": {
      "googleTransactionReferenceNumber": "714545417102363157911822",
      "authorizationCode": "111111"
    }
  },
  "existingGoogleClaimId": "138431383281",
  "requestOriginator": {
    "organizationId": "ISSUER_256",
    "organizationDescription": "Community Bank of Some City",
    "agentId": "982749"
  }
}

Przykładowa odpowiedź wygląda tak:


{
  "responseHeader": {
    "responseTimestamp": {
      "epochMillis": "1519996752221"
    }
  },
  "result": {
    "success": {
      "googleClaimId": "138431383281",
      "report": {
        "customerAccount": {
          "customerEmail": "example@gmail.com",
          "customerName" : "Example Customer"
        },
        "order": {
          "timestamp": {
            "epochMillis": "1517992525972"
          },
          "orderId": "SOP.8976-1234-1234-123456..99",
          "subTotalAmount": {
            "amountMicros": "206990000",
            "currencyCode": "USD"
          },
          "totalAmount": {
            "amountMicros": "212990000",
            "currencyCode": "USD"
          },
          "shippingAddress": {
            "addressLine": ["123 Main St"],
            "localityName": "Springfield",
            "administrativeAreaName": "CO",
            "postalCodeNumber": "80309",
            "countryCode": "US"
          },
          "taxes": [
            {
              "description": "Colorado Sales Tax",
              "amount": {
                "amountMicros": "6000000",
                "currencyCode": "USD"
              }
            }
          ],
          "items": [
            {
              "description": "Super cool gizmo",
              "merchant": "HTC",
              "googleProductName": "Google Store",
              "quantity": "2",
              "totalPrice": {
                "amountMicros": "198000000",
                "currencyCode": "USD"
              }
            },
            {
              "description": "Gizmo charger",
              "merchant": "HTC",
              "googleProductName": "Google Store",
              "quantity": "1",
              "totalPrice": {
                "amountMicros": "8990000",
                "currencyCode": "USD"
              }
            }
          ]
        },
        "payment": {
          "billingAddress" : {
            "addressLine": ["123 Main St"],
            "localityName": "Springfield",
            "administrativeAreaName": "CO",
            "postalCodeNumber": "80309",
            "countryCode": "US"
          },
          "amount": {
            "amountMicros": "100000000",
            "currencyCode": "USD"
          },
          "refunds": [
            {
              "amount": {
                "amountMicros": "9250000",
                "currencyCode": "USD"
              },
              "initiatedTimestamp": {
                "epochMillis": "1518811245384"
              }
            }
          ],
          "cardDetails": {
            "authResult": "APPROVED"
          }
        }
      }
    }
  }
}

Żądanie HTTP

POST https://vgw.googleapis.com/secure-serving/gsp/v3/getDisputeInquiryReport/:PIAID

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "requestHeader": {
    object (RequestHeader)
  },
  "paymentLookupCriteria": {
    object (PaymentLookupCriteria)
  },
  "existingGoogleClaimId": string,
  "requestOriginator": {
    object (RequestOriginator)
  }
}
Pola
requestHeader

object (RequestHeader)

REQUIRED: wspólny nagłówek dla wszystkich żądań.
paymentLookupCriteria

object (PaymentLookupCriteria)

WYMAGANE: kryteria wskazujące płatność, która ma być szukana w przypadku tego zapytania.
existingGoogleClaimId

string

OPCJONALNIE: ciąg tekstowy wygenerowany przez Google zwrócony przez poprzednie wywołanie funkcji getDisputeInquiryReport, który jednoznacznie identyfikuje roszczenie w związku ze sprzeciwem klienta.

Jeśli go nie podasz, zostanie wygenerowany nowy identyfikator roszczenia. Rozmówca może podać googleClaimId, który został zwrócony przez poprzednie wywołanie getDisputeInquiryReport, jeśli jest on kontynuacją tego samego sporu klienta.

Identyfikator, który został tu wypełniony lub wygenerowany, zostanie zwrócony w polu googleClaimId w odpowiedzi.

Podanie wartości googleClaimId, która nie została zwrócona w ramach poprzedniego wywołania funkcji getDisputeInquiryReport, jest niepoprawna. W takim przypadku zwracany jest kod HTTP 400 Bad Request (Nieprawidłowe żądanie) HTTP 400 (Nieprawidłowe żądanie).
requestOriginator

object (RequestOriginator)

WYMAGANE: informacje o organizacji lub podgrupie organizacyjnej, która wysłała tę prośbę.

Treść odpowiedzi

Ta metoda obsługuje wiele typów zwrotów. Więcej informacji o tym, jakie kody stanu HTTP 4XX i 5XX należy zwracać z elementem ErrorResponse, znajdziesz w obiektach ErrorResponse i dokumentacji kodów stanu HTTP.

Ta metoda obsługuje wiele typów zwrotów. Więcej informacji o tym, jakie kody stanu HTTP 4XX i 5XX należy zwracać z elementem ErrorResponse, znajdziesz w obiektach ErrorResponse i dokumentacji kodów stanu HTTP.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Możliwe wiadomości z odpowiedzią
Stan HTTP 200

object (GetDisputeInquiryReportResponse)
Stan HTTP 4XX / 5XX

object (ErrorResponse)

RequestHeader

Obiekt nagłówka zdefiniowany we wszystkich żądaniach wysyłanych do serwera.

Zapis JSON 
{
  "requestId": string,
  "requestTimestamp": {
    object (Timestamp)
  },
  "protocolVersion": {
    object (Version)
  },
  "paymentIntegratorAccountId": string
}
Pola
requestId

string

REQUIRED: unikalny identyfikator tego żądania.

Jest to ciąg o maksymalnej długości 100 znaków, który zawiera tylko znaki „a–z”, „A–Z”, „0–9”, „:”, „-” i „_”.
requestTimestamp

object (Timestamp)

REQUIRED: sygnatura czasowa żądania. Odbiorca musi sprawdzić, czy sygnatura czasowa to ± 60 s „teraz” i odrzucić żądanie, jeśli nie jest. Ta sygnatura czasowa żądania nie jest idempotentna przy ponownych próbach.
protocolVersion

object (Version)

REQUIRED: wersja żądania.
paymentIntegratorAccountId

string

REQUIRED: identyfikuje unikalne konto z ograniczeniami umownymi.

Sygnatura czasowa

Obiekt sygnatury czasowej reprezentujący punkt na osi czasu ISO w milisekundach od początku epoki uniksowej.

Zapis JSON 
{
  "epochMillis": string
}
Pola
epochMillis

string (Int64Value format)

WYMAGANE: milisekundy od epoki uniksowej

Wersja

Obiekt wersji zawiera główną wersję interfejsu API. Gwarantujemy zgodność wersji tej samej wersji głównej. Integrator musi obsługiwać wszystkie żądania tej samej wersji głównej.

Zapis JSON 
{
  "major": integer
}
Pola
major

integer

REQUIRED: wersja główna. Ten element jest oznaczony w przypadku żądań zgodności z różnymi wersjami Google Workspace.

PaymentLookupCriteria

Kontener kryteriów, które mogą jednoznacznie wyszukiwać płatność. Musisz wypełnić jedno (i tylko jedno) pole użytkownika.

Zapis JSON 
{

  // Union field criteria can be only one of the following:
  "arnCriteria": {
    object (ArnCriteria)
  },
  "googleTransactionReferenceNumberCriteria": {
    object (GoogleTransactionReferenceNumberCriteria)
  },
  "captureRequestCriteria": {
    object (CaptureRequestCriteria)
  }
  // End of list of possible types for union field criteria.
}
Pola

Pole sumy criteria.

criteria może mieć tylko jedną z tych wartości:
arnCriteria

object (ArnCriteria)

OPCJONALNIE: wyszukiwanie na podstawie numeru referencyjnego centrum autoryzacyjnego (ARN).
googleTransactionReferenceNumberCriteria

object (GoogleTransactionReferenceNumberCriteria)

OPCJONALNIE: wyszukiwanie na podstawie numeru referencyjnego transakcji Google.
captureRequestCriteria

object (CaptureRequestCriteria)

OPCJONALNIE: wyszukiwanie na podstawie pierwotnego żądania zapisu.

ArnCriteria

Kryteria wyszukiwania płatności na podstawie numeru referencyjnego centrum autoryzacyjnego (ARN).

Zapis JSON 
{
  "acquirerReferenceNumber": string,
  "authorizationCode": string
}
Pola
acquirerReferenceNumber

string

WYMAGANE: numer referencyjny centrum autoryzacyjnego (ARN), który jednoznacznie identyfikuje płatność. Musi mieć 23 cyfry.
authorizationCode

string

REQUIRED: kod autoryzacji transakcji.

GoogleTransactionReferenceNumberCriteria

Kryteria wyszukiwania płatności na podstawie numeru referencyjnego transakcji wygenerowanego przez Google.

Zapis JSON 
{
  "googleTransactionReferenceNumber": string,
  "authorizationCode": string
}
Pola
googleTransactionReferenceNumber

string

WYMAGANE: wygenerowany przez Google numer referencyjny transakcji, który jednoznacznie identyfikuje płatność.
authorizationCode

string

REQUIRED: kod autoryzacji transakcji.

CaptureRequestCriteria

Kryteria wyszukiwania płatności na podstawie pierwotnego żądania zapisu.

Zapis JSON 
{
  "captureRequestId": string
}
Pola
captureRequestId

string

REQUIRED: unikalny identyfikator tej transakcji. To jest wartość requestId wygenerowana przez Google podczas wyszukiwanej rozmowy capture.

RequestOriginator

Informacje o organizacji lub podgrupie organizacyjnej oraz opcjonalnie pracownikach, od których pochodzi ta prośba. Dzięki temu możemy wykrywać problemy lub nadużycia i wdrażać rozwiązania kontrolne na bardziej szczegółowym poziomie niż paymentIntegratorAccountId. Jest ona szczególnie przydatna, gdy rozmówca to pośrednik, który pozyskuje żądania od wielu klientów zewnętrznych.

Zapis JSON 
{
  "organizationId": string,
  "organizationDescription": string,
  "agentId": string
}
Pola
organizationId

string

WYMAGANE: identyfikator firmy, organizacji lub grupy organizacyjnej, z której pochodzi to żądanie. Nie może się powtarzać w obrębie tej wartości (paymentIntegratorAccountId).
organizationDescription

string

WYMAGANE: czytelna dla człowieka nazwa lub opis organizacji, które mogą ułatwić komunikację między pracownikami Google a integratorem w związku z tą organizacją.
agentId

string

OPCJONALNIE: unikalny identyfikator konkretnego agenta (pracownika) organizacji zidentyfikowanej przez użytkownika organizationId, od którego pochodzi żądanie. Nie może się powtarzać w obrębie tej wartości (organizationId).

GetDisputeInquiryReportResponse

Ładunek odpowiedzi dla metody getDisputeInquiryReport.

Zapis JSON 
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "result": {
    object (GetDisputeInquiryReportResult)
  }
}
Pola
responseHeader

object (ResponseHeader)

REQUIRED: wspólny nagłówek wszystkich odpowiedzi.
result

object (GetDisputeInquiryReportResult)

REQUIRED: wynik tego wywołania.

ResponseHeader

Obiekt nagłówka zdefiniowany we wszystkich odpowiedziach wysyłanych z serwera.

Zapis JSON 
{
  "responseTimestamp": {
    object (Timestamp)
  }
}
Pola
responseTimestamp

object (Timestamp)

REQUIRED: sygnatura czasowa tej odpowiedzi. Odbiorca musi sprawdzić, czy ta sygnatura czasowa mieści się w zakresie ± 60 s „teraz” i odrzucić odpowiedź, jeśli nie jest.

GetDisputeInquiryReportResult

Zapis JSON 
{

  // Union field result can be only one of the following:
  "success": {
    object (SuccessDetails)
  },
  "paymentNotFound": {
    object (Empty)
  },
  "paymentTooOld": {
    object (Empty)
  },
  "orderCannotBeReturned": {
    object (Empty)
  },
  "noAdditionalDetails": {
    object (Empty)
  }
  // End of list of possible types for union field result.
}
Pola

Pole sumy result.

result może mieć tylko jedną z tych wartości:
success

object (SuccessDetails)

Płatność została znaleziona i przesłany jest raport.
paymentNotFound

object (Empty)

Nie znaleziono żądanej płatności.
paymentTooOld

object (Empty)

Żądana płatność została znaleziona, ale nie otrzymaliśmy raportu ze względu na datę płatności.
orderCannotBeReturned

object (Empty)

Żądana płatność należy do zamówienia, które istnieje, ale nie może zostać zwrócone. Obejmuje to przypadki, gdy orzeczenie zostało usunięte na prośbę jego właściciela.

noAdditionalDetails

object (Empty)

Żądana płatność została znaleziona, ale raport nie jest dostępny.

SuccessDetails

Zapis JSON 
{
  "googleClaimId": string,
  "report": {
    object (PurchaseReport)
  }
}
Pola
googleClaimId

string

WYMAGANE: ciąg znaków wygenerowany przez Google, który jednoznacznie identyfikuje spór klienta.

Jeśli żądanie zawierało pole existingGoogleClaimId, będzie to ta sama wartość. W przeciwnym razie będzie to nowo wygenerowana wartość. Tę wartość możesz podać w przyszłych żądaniach getDisputeInquiryReport, jeśli są one częścią tego samego sporu klienta.
report

object (PurchaseReport)

WYMAGANE: szczegółowe informacje dotyczące sporu dotyczącego płatności wskazanego w żądaniu.

PurchaseReport

raport zawierający istotne szczegóły zakupu powiązanego z żądaną płatnością.

Zapis JSON 
{
  "customerAccount": {
    object (CustomerAccount)
  },
  "order": {
    object (Order)
  },
  "payment": {
    object (Payment)
  }
}
Pola
customerAccount

object (CustomerAccount)

WYMAGANE: informacje dotyczące klienta i jego konta.
order

object (Order)

OPCJONALNE: informacje dotyczące zamówienia, za które dokonano płatności. Nie wszystkie raporty dotyczące zakupów są dostępne.
payment

object (Payment)

REQUIRED: informacje o płatności. Uwaga: w ramach jednego zamówienia można dokonać kilku płatności, ale będą one obejmować tylko informacje dotyczące płatności określonej w pierwotnym żądaniu.

CustomerAccount

Informacje o koncie klienta.

Zapis JSON 
{
  "customerEmail": string,
  "customerName": string
}
Pola
customerEmail

string

OPCJONALNIE: adres e-mail powiązany z kontem Google klienta.
customerName

string

REQUIRED: nazwa klienta.

Zamów

Informacje o zamówieniu.

Zapis JSON 
{
  "timestamp": {
    object (Timestamp)
  },
  "orderId": string,
  "subTotalAmount": {
    object (Amount)
  },
  "totalAmount": {
    object (Amount)
  },
  "shippingAddress": {
    object (Address)
  },
  "items": [
    {
      object (Item)
    }
  ],
  "taxes": [
    {
      object (Tax)
    }
  ]
}
Pola
timestamp

object (Timestamp)

REQUIRED: sygnatura czasowa złożenia zamówienia.
orderId

string

REQUIRED: ciąg znaków jednoznacznie identyfikujący zamówienie.
subTotalAmount

object (Amount)

REQUIRED: łączna kwota tego zamówienia (bez podatku).
totalAmount

object (Amount)

REQUIRED: łączna kwota tego zamówienia z podatkiem.
shippingAddress

object (Address)

OPCJONALNIE: adres dostawy fizycznych produktów w tym zamówieniu.
items[]

object (Item)

REQUIRED: lista produktów, które były częścią tego zamówienia.
taxes[]

object (Tax)

REQUIRED: lista podatków, które były objęte tym zamówieniem. Ta lista może być pusta.

Kwota

Powiązuje kwotę w mikro z kodem waluty.

Zapis JSON 
{
  "amountMicros": string,
  "currencyCode": string
}
Pola
amountMicros

string (Int64Value format)

REQUIRED: ilość w mikro.
currencyCode

string

WYMAGANE: 3-literowy kod waluty w formacie ISO 4217

Adres

Budynek zawierający informacje o adresie pocztowym.

Zapis JSON 
{
  "addressLine": [
    string
  ],
  "localityName": string,
  "administrativeAreaName": string,
  "postalCodeNumber": string,
  "countryCode": string
}
Pola
addressLine[]

string

OPCJONALNIE: przechowuje nieuporządkowany tekst adresu.
localityName

string

OPCJONALNIE: jest to przybliżone hasło, ale zwykle dotyczy ono części adresu miasta/miasteczka. W regionach świata, gdzie miejscowości nie są dobrze zdefiniowane lub nie pasują do tej struktury (np. w Japonii i Chinach), pozostaw pole localityName puste i użyj parametru addressLine.

Przykłady: miasto w USA, gmina IT, brytyjska poczta.
administrativeAreaName

string

OPCJONALNIE: najwyższy poziom podziału administracyjnego tego kraju „Przykłady: stan USA, region IT, prowincja CN, prefektura JP”.
postalCodeNumber

string

OPCJONALNIE: wbrew nazwie wartości wartościPostalCodeNumber mają często postać alfanumeryczną. Przykłady: „94043”, „SW1W”, „SW1W 9TQ”.
countryCode

string

OPCJONALNIE: kod kraju w adresie klienta. Oczekiwany kod to ISO-3166-1 Alpha-2.

Element

Informacje o elemencie zamówienia.

Zapis JSON 
{
  "description": string,
  "merchant": string,
  "quantity": string,
  "totalPrice": {
    object (Amount)
  },
  "googleProductName": string
}
Pola
description

string

REQUIRED: opis zakupionego produktu.
merchant

string

WYMAGANE: sprzedawca, wykonawca lub producent produktu.
quantity

string (Int64Value format)

OPTIONAL: zamówiona liczba sztuk produktu.

To pole zostanie pominięte, jeśli dane wyświetlane w ilościach całkowitych nie dotyczą danego produktu (produkty z pomiarem mogą być np. przedstawiane w ilościach ułamkowych).
totalPrice

object (Amount)

REQUIRED: łączna cena produktu.
googleProductName

string

WYMAGANE: nazwa usługi Google związanej z produktem.

Podatek

Informacje o podatku zastosowanym do tego zamówienia.

Zapis JSON 
{
  "description": string,
  "amount": {
    object (Amount)
  }
}
Pola
description

string

REQUIRED: opis podatku.
amount

object (Amount)

REQUIRED: kwota podatku.

płatność,

Informacje o płatności.

Zapis JSON 
{
  "billingAddress": {
    object (Address)
  },
  "amount": {
    object (Amount)
  },
  "refunds": [
    {
      object (Refund)
    }
  ],

  // Union field fopDetails can be only one of the following:
  "cardDetails": {
    object (PaymentCardDetails)
  }
  // End of list of possible types for union field fopDetails.
}
Pola
billingAddress

object (Address)

REQUIRED: adres rozliczeniowy na potrzeby tej płatności.
amount

object (Amount)

REQUIRED: kwota tej płatności.
refunds[]

object (Refund)

REQUIRED: lista zwrotów środków w przypadku tej płatności. Ta lista może być pusta.

Pole sumy fopDetails.

fopDetails może mieć tylko jedną z tych wartości:
cardDetails

object (PaymentCardDetails)

OPCJONALNIE: dane do płatności związane z kontami płatniczymi związanymi z kartami kredytowymi i debetowymi.

Zwrot środków

Informacje o zwrocie środków za płatność.

Zapis JSON 
{
  "amount": {
    object (Amount)
  },
  "initiatedTimestamp": {
    object (Timestamp)
  }
}
Pola
amount

object (Amount)

REQUIRED: zwrócona kwota.
initiatedTimestamp

object (Timestamp)

REQUIRED: sygnatura czasowa zainicjowania zwrotu środków.

PaymentCardDetails

Szczegóły płatności dotyczące kart kredytowych i debetowych.

Zapis JSON 
{
  "authResult": enum (AuthResult)
}
Pola
authResult

enum (AuthResult)

REQUIRED: wynik uwierzytelniania płatności.

AuthResult

Wyniki uwierzytelniania płatności.

Wartości w polu enum
UNKNOWN_RESULT Nigdy nie ustawiaj tej wartości domyślnej.
APPROVED Autoryzacja zatwierdzona.
DENIED Odmowa autoryzacji.
NOT_ATTEMPTED Nie podjęto próby autoryzacji.

Pusta

Ten typ nie ma pól.

Ten obiekt jest używany do rozszerzania jego zakresu, ponieważ wartości logiczne i wyliczenia często trzeba rozszerzyć o dodatkowe dane. Implementacja na jego podstawie określa obecność. Wyliczenie, które reprezentuje, może zostać rozszerzone o dane w przyszłych wersjach.

Reprezentacja JSON dla Empty to pusty obiekt JSON {}.

ErrorResponse

Obiekt błędu odpowiedzi dla wszystkich metod.

Zapis JSON 
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "errorDescription": string,
  "paymentIntegratorErrorIdentifier": string,
  "errorResponseResult": {
    object (ErrorResponseResult)
  }
}
Pola
responseHeader

object (ResponseHeader)

REQUIRED: wspólny nagłówek wszystkich odpowiedzi.
errorDescription

string

OPCJONALNY: podaj opis tego stanu, aby przedstawiciele zespołu pomocy mogli debugować błędy. Pamiętaj, że użytkownicy nigdy nie zobaczą tych informacji. Może zawierać opis bez danych poufnych, który jest używany do debugowania. Niektóre wartości parametru errorResponseCode powinny zawierać dodatkowe informacje w tym polu. Ostrzeżenie: nie umieszczaj w tej wiadomości żadnych tokenów, chyba że są one zdefiniowane jako publiczne.
paymentIntegratorErrorIdentifier

string

OPCJONALNIE: ten identyfikator jest specyficzny dla integratora i jest przez niego generowany. Służy ona wyłącznie do debugowania tylko w celu identyfikacji tego wywołania. Jest to identyfikator, na podstawie którego integrator rozpoznaje to wywołanie.
errorResponseResult

object (ErrorResponseResult)

OPCJONALNIE: kod rejestrujący typ błędu, który wystąpił.

ErrorResponseResult

Kody błędów

Zapis JSON 
{

  // Union field result can be only one of the following:
  "invalidApiVersion": {
    object (InvalidApiVersion)
  },
  "invalidPayloadSignature": {
    object (InvalidPayloadSignature)
  },
  "invalidPayloadEncryption": {
    object (InvalidPayloadEncryption)
  },
  "requestTimestampOutOfRange": {
    object (RequestTimestampOutOfRange)
  },
  "invalidIdentifier": {
    object (InvalidIdentifier)
  },
  "idempotencyViolation": {
    object (IdempotencyViolation)
  },
  "invalidFieldValue": {
    object (InvalidFieldValue)
  },
  "missingRequiredField": {
    object (MissingRequiredField)
  },
  "preconditionViolation": {
    object (PreconditionViolation)
  },
  "userActionInProgress": {
    object (UserActionInProgress)
  },
  "invalidDecryptedRequest": {
    object (InvalidDecryptedRequest)
  },
  "forbidden": {
    object (Forbidden)
  }
  // End of list of possible types for union field result.
}
Pola

Pole sumy result.

result może mieć tylko jedną z tych wartości:
invalidApiVersion

object (InvalidApiVersion)

Wartość używana, jeśli wersja interfejsu API żądania nie jest obsługiwana. Zalecany kod HTTP: 400
invalidPayloadSignature

object (InvalidPayloadSignature)

Używana, jeśli podpis ładunku jest przeznaczony dla nieznanego lub nieaktywnego klucza. Zalecany kod HTTP: 401
invalidPayloadEncryption

object (InvalidPayloadEncryption)

Używana, jeśli ładunek jest szyfrowany do nieznanego lub nieaktywnego klucza. Zalecany kod HTTP: 400
requestTimestampOutOfRange

object (RequestTimestampOutOfRange)

Używana, jeśli requestTimestamp nie mieści się w zakresie ± 60 s od teraz. Zalecany kod HTTP: 400
invalidIdentifier

object (InvalidIdentifier)

Używana, jeśli identyfikator wysłany w żądaniu był nieprawidłowy lub nieznany. Może to obejmować identyfikator PIAID, CapRequestId, token płatności Google itp. Zalecany kod HTTP: 404
idempotencyViolation

object (IdempotencyViolation)

Używana, jeśli żądanie narusza wymagania dotyczące idempotentności. Zalecany kod HTTP: 412
invalidFieldValue

object (InvalidFieldValue)

Używana, jeśli żądanie zawiera wartość pola, którego nie ma w zestawie obsługiwanych wartości. Zalecany kod HTTP: 400
missingRequiredField

object (MissingRequiredField)

Używana, jeśli wymagane pole nie jest ustawione w żądaniu. Zalecany kod HTTP: 400
preconditionViolation

object (PreconditionViolation)

Używana, jeśli ograniczenie operacji zostanie naruszone (np. gdy żądanie zwrotu środków przekracza kwotę pozostałą w transakcji). Zalecany kod HTTP: 400
userActionInProgress

object (UserActionInProgress)

Używana, jeśli żądanie nie może zostać teraz przetworzone, ponieważ spowodowałoby to przerwanie trwającego działania użytkownika, które w efekcie działa jak blokada systemu. Tego kodu nie należy używać do wskazywania błędów spowodowanych wewnętrznymi błędami równoczesności związanymi z implementacją. Zalecany kod HTTP: 423
invalidDecryptedRequest

object (InvalidDecryptedRequest)

Ta opcja jest używana, jeśli udało się odszyfrować ładunek żądania, ale nie udało się przeanalizować wynikowego komunikatu. Zalecany kod HTTP: 400
forbidden

object (Forbidden)

Dostęp do żądanego zasobu jest zabroniony. Zalecany kod HTTP: 403

InvalidApiVersion

Zapis JSON 
{
  "requestVersion": {
    object (Version)
  },
  "expectedVersion": {
    object (Version)
  }
}
Pola
requestVersion

object (Version)

REQUIRED: nieprawidłowa wersja określona w żądaniu.
expectedVersion

object (Version)

REQUIRED: oczekiwana wersja.

InvalidPayloadSignature

Ten typ nie ma pól.

Ta wiadomość jest teraz celowo pusta. W przyszłości możemy dodać nowe pola.

InvalidPayloadEncryption

Ten typ nie ma pól.

Ta wiadomość jest teraz celowo pusta. W przyszłości możemy dodać nowe pola.

RequestTimestampOutOfRange

Zapis JSON 
{
  "requestTimestamp": {
    object (Timestamp)
  },
  "serverTimestampAtReceipt": {
    object (Timestamp)
  }
}
Pola
requestTimestamp

object (Timestamp)

REQUIRED: sygnatura czasowa podana w żądaniu.
serverTimestampAtReceipt

object (Timestamp)

WYMAGANE: czas serwera w momencie odbioru, używany do porównania.

InvalidIdentifier

Zapis JSON 
{
  "invalidIdentifierType": string
}
Pola
invalidIdentifierType

string

REQUIRED: typ nieprawidłowego identyfikatora, np. PIAID, CapRequestId itp.

IdempotencyViolation

Ten typ nie ma pól.

Ta wiadomość jest teraz celowo pusta. W przyszłości możemy dodać nowe pola.

InvalidFieldValue

Zapis JSON 
{
  "invalidFieldName": string
}
Pola
invalidFieldName

string

REQUIRED: nazwa pola, które zostało uznane za nieprawidłowe.

MissingRequiredField

Zapis JSON 
{
  "missingFieldNames": [
    string
  ]
}
Pola
missingFieldNames[]

string

REQUIRED: nazwy brakujących pól.

PreconditionViolation

Ten typ nie ma pól.

Ta wiadomość jest teraz celowo pusta. W przyszłości możemy dodać nowe pola.

UserActionInProgress

Ten typ nie ma pól.

Ta wiadomość jest teraz celowo pusta. W przyszłości możemy dodać nowe pola.

InvalidDecryptedRequest

Ten typ nie ma pól.

Ta wiadomość jest teraz celowo pusta. W przyszłości możemy dodać nowe pola.

Zabroniono

Ten typ nie ma pól.

Ta wiadomość jest teraz celowo pusta. W przyszłości możemy dodać nowe pola.