Method: getDisputeInquiryReport

Ödemeyle ilgili olası bir anlaşmazlık hakkında kullanıcı ile müşteri desteği görüşmesini kolaylaştırmak için bilgiler içeren bir rapor alın.

Bu yöntem bir HTTP 200 döndürmezse bu sorguya verilen yanıtlar boş olabilir.

Uç nokta, isteği işlerken bir hatayla karşılaşırsa bu uç noktadan gelen yanıt ErrorResponse türünde olur.

Bu yöntem bir HTTP 200 döndürmezse bu sorguya verilen yanıtlar boş olabilir. Net bir açıklamaya sahip ErrorResponse, bir saldırganın diğer entegratörlerin ödeme entegratörü hesap tanımlayıcısını anlamasına yardımcı olmak için kullanılabileceği durumlarda yanıt gövdesi boştur. İmzalama anahtarının eşleşmediği, ödeme entegratörü tanımlayıcısının bulunamadığı veya şifreleme anahtarının bilinmediği bu durumlarda bu yöntem, gövdesi boş olan bir HTTP 404 döndürür. İstek imzası doğrulanabildiyse yanıt gövdesinde hatayla ilgili ek bilgiler döndürülür.

Örnek bir istek şu şekilde görünür:


{
  "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"
  }
}

Örnek bir yanıt şöyle görünür:


{
  "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"
          }
        }
      }
    }
  }
}

HTTP isteği

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

İstek içeriği

İstek gövdesi, aşağıdaki yapıyla birlikte veriler içerir:

JSON gösterimi 
{
  "requestHeader": {
    object (RequestHeader)
  },
  "paymentLookupCriteria": {
    object (PaymentLookupCriteria)
  },
  "existingGoogleClaimId": string,
  "requestOriginator": {
    object (RequestOriginator)
  }
}
Alanlar
requestHeader

object (RequestHeader)

ZORUNLU: Tüm istekler için ortak başlık.
paymentLookupCriteria

object (PaymentLookupCriteria)

ZORUNLU: Bu sorgu için aranacak ödemeyi belirten kriterler.
existingGoogleClaimId

string

İSTEĞE BAĞLI: Google tarafından oluşturulan ve bu müşteri itirazı hak talebini benzersiz şekilde tanımlayan, getDisputeInquiryReport öğesine önceki bir çağrı tarafından döndürülen dize.

Bu mevcut değilse yeni bir hak talebi kimliği oluşturulur. Arayan, getDisputeInquiryReport numaralı telefona yapılan önceki aramayla iade edilen googleClaimId numarasını sağlayabilir (bu, aynı müşteri anlaşmazlığının devamıysa).

Burada doldurulan veya oluşturulan hak talebi kimliği, yanıtın googleClaimId alanında döndürülür.

getDisputeInquiryReport numarasına yapılan önceki bir çağrı tarafından döndürülmeyen bir googleClaimId sağlamak geçerli değildir. Bu durumda, HTTP 400 Hatalı İsteği döndürülür.
requestOriginator

object (RequestOriginator)

ZORUNLU: Bu isteği gönderen kuruluş veya kuruluş alt grubuyla ilgili bilgiler.

Yanıt gövdesi

Bu yöntem birden fazla döndürme türünü destekler. ErrorResponse ile hangi 4XX veya 5XX HTTP durum kodunun döndürüleceği hakkında daha fazla bilgi için ErrorResponse nesnesine ve HTTP durum kodları dokümanlarına bakın.

Bu yöntem birden fazla döndürme türünü destekler. ErrorResponse ile hangi 4XX veya 5XX HTTP durum kodunun döndürüleceği hakkında daha fazla bilgi için ErrorResponse nesnesine ve HTTP durum kodları dokümanlarına bakın.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

Olası yanıt mesajları
HTTP 200 Durumu

object (GetDisputeInquiryReportResponse)
HTTP 4XX / 5XX Durumu

object (ErrorResponse)

RequestHeader

Sunucuya gönderilen tüm isteklerde tanımlanan başlık nesnesi.

JSON gösterimi 
{
  "requestId": string,
  "requestTimestamp": {
    object (Timestamp)
  },
  "protocolVersion": {
    object (Version)
  },
  "paymentIntegratorAccountId": string
}
Alanlar
requestId

string

ZORUNLU: Bu isteğin benzersiz tanımlayıcısı.

Bu dize en fazla 100 karakter uzunluğunda olup yalnızca "a-z", "A-Z", "0-9", ":", "-" ve "_" karakterlerinden oluşur.
requestTimestamp

object (Timestamp)

ZORUNLU: Bu isteğin zaman damgası. Alıcı, bu zaman damgasının "şimdi" ± 60 saniye olduğunu doğrulamalı, değilse isteği reddetmelidir. Bu istek zaman damgası yeniden denemelerden sonra eş değerde değil.
protocolVersion

object (Version)

ZORUNLU: Bu isteğin sürümü.
paymentIntegratorAccountId

string

ZORUNLU: Sözleşmeden doğan kısıtlamalara sahip benzersiz bir hesap tanımlar.

Zaman damgası

Unix döneminden bu yana ISO zaman çizelgesinde milisaniye cinsinden bir noktayı temsil eden zaman damgası nesnesi.

JSON gösterimi 
{
  "epochMillis": string
}
Alanlar
epochMillis

string (Int64Value format)

ZORUNLU: Unix sıfır zamanından bu yana geçen saniye sayısı

Sürüm

Sürüm nesnesi, API'nin ana sürümünü içeriyor. Aynı ana sürümün sürümlerinin uyumlu olması garanti edilir. Entegre edici, aynı ana sürüme yönelik tüm istekleri desteklemelidir.

JSON gösterimi 
{
  "major": integer
}
Alanlar
major

integer

ZORUNLU: Ana sürüm. Bu, farklı sürümlere sahip uyumluluk isteklerinin uyumlu olacağı garanti edilmediği için işaretlenir.

PaymentLookupCriteria

Bir ödemeyi benzersiz bir şekilde arayabilen ölçütlerin kapsayıcısıdır. Bir (yalnızca bir) üye alanı doldurulmalıdır.

JSON gösterimi 
{

  // 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.
}
Alanlar

criteria alanı.

criteria şunlardan yalnızca biri olabilir:
arnCriteria

object (ArnCriteria)

İSTEĞE BAĞLI: Acquirer Reference Number (ARN) Temelli Arama.
googleTransactionReferenceNumberCriteria

object (GoogleTransactionReferenceNumberCriteria)

İSTEĞE BAĞLI: Google İşlem Referans Numarası'na göre arama yapın.
captureRequestCriteria

object (CaptureRequestCriteria)

İSTEĞE BAĞLI: Orijinal yakalama isteğine göre arama.

ArnCriteria

Edinme Referans Numarası'na (ARN) dayalı ödeme arama kriterleri.

JSON gösterimi 
{
  "acquirerReferenceNumber": string,
  "authorizationCode": string
}
Alanlar
acquirerReferenceNumber

string

ZORUNLU: Ödemeyi benzersiz şekilde tanımlayan Edinme Referans Numarası (ARN). 23 haneli olmalıdır.
authorizationCode

string

ZORUNLU: İşlemin Yetkilendirme Kodu.

GoogleTransactionReferenceNumberCriteria

Google tarafından oluşturulan İşlem Referans Numarası'na dayalı ödeme arama ölçütleri.

JSON gösterimi 
{
  "googleTransactionReferenceNumber": string,
  "authorizationCode": string
}
Alanlar
googleTransactionReferenceNumber

string

ZORUNLU: Google tarafından oluşturulan ve ödemeyi benzersiz bir şekilde tanımlayan İşlem Referans Numarası.
authorizationCode

string

ZORUNLU: İşlemin Yetkilendirme Kodu.

CaptureRequestCriteria

Orijinal yakalama isteğine dayalı ödeme arama ölçütleri.

JSON gösterimi 
{
  "captureRequestId": string
}
Alanlar
captureRequestId

string

ZORUNLU: Bu işlem için benzersiz bir tanımlayıcı. Bu, aranan capture çağrısı sırasında Google tarafından oluşturulan requestId değeridir.

RequestOriginator

Bu isteğin kaynağı olan kuruluş veya kuruluş alt grubu ve isteğe bağlı olarak çalışan hakkında bilgiler. Bu sayede Google, sorunları veya kötüye kullanımı tanımlayabilir ve paymentIntegratorAccountId düzeyinden daha ayrıntılı denetimler uygulayabilir. Çağrı, birden fazla harici müşteriden istek alan bir aracı servis sağlayıcı olduğunda özellikle faydalıdır.

JSON gösterimi 
{
  "organizationId": string,
  "organizationDescription": string,
  "agentId": string
}
Alanlar
organizationId

string

ZORUNLU: Bu isteğin geldiği şirketin, kuruluşun veya kuruluş grubunun tanımlayıcısı. Bu paymentIntegratorAccountId içinde benzersiz olmalıdır.
organizationDescription

string

ZORUNLU: Google çalışanları ile kuruluşla ilgili entegratör arasındaki iletişimi kolaylaştırmak için kullanılabilen, kuruluşla ilgili, kullanıcıların okuyabileceği bir ad veya açıklama.
agentId

string

İSTEĞE BAĞLI: Bu isteğin kaynağı olan organizationId tarafından tanımlanan, kuruluşun temsilcisinin (çalışan) benzersiz tanımlayıcısı. Bu organizationId içinde benzersiz olmalıdır.

GetDisputeInquiryReportResponse

getDisputeInquiryReport yöntemi için yanıt yükü

JSON gösterimi 
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "result": {
    object (GetDisputeInquiryReportResult)
  }
}
Alanlar
responseHeader

object (ResponseHeader)

ZORUNLU: Tüm yanıtlar için ortak başlık.
result

object (GetDisputeInquiryReportResult)

ZORUNLU: Bu çağrının sonucu.

ResponseHeader

Sunucudan gönderilen tüm yanıtlarda tanımlanan başlık nesnesi.

JSON gösterimi 
{
  "responseTimestamp": {
    object (Timestamp)
  }
}
Alanlar
responseTimestamp

object (Timestamp)

ZORUNLU: Bu yanıtın zaman damgası. Alıcı, bu zaman damgasının "şimdi" ± 60 saniye olduğunu doğrulamalı, değilse yanıtı reddetmelidir.

GetDisputeInquiryReportResult

JSON gösterimi 
{

  // 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.
}
Alanlar

result alanı.

result şunlardan yalnızca biri olabilir:
success

object (SuccessDetails)

Ödeme bulundu ve bir rapor gönderildi.
paymentNotFound

object (Empty)

İstenen ödeme bulunamadı.
paymentTooOld

object (Empty)

İstenen ödeme bulundu, ancak ödemenin tarihi nedeniyle rapor sağlanmadı.
orderCannotBeReturned

object (Empty)

İstenen ödeme mevcut bir siparişe ait, ancak iade edilemez. Nedenler arasında, sahibinin talebi üzerine siparişin kaldırıldığı durumlar da bulunur.

noAdditionalDetails

object (Empty)

İstenen ödeme bulundu, ancak rapor mevcut değil.

SuccessDetails

JSON gösterimi 
{
  "googleClaimId": string,
  "report": {
    object (PurchaseReport)
  }
}
Alanlar
googleClaimId

string

ZORUNLU: Bu müşteri anlaşmazlığını benzersiz şekilde tanımlayan, Google tarafından oluşturulan bir dizedir.

İstekte existingGoogleClaimId doldurulmuşsa bu değer aynı olacaktır. Aksi takdirde bu, yeni oluşturulmuş bir değer olacaktır. Bu değer, aynı müşteri anlaşmazlığının bir parçası olan gelecekteki getDisputeInquiryReport isteklerinde sağlanabilir.
report

object (PurchaseReport)

ZORUNLU: İstekte belirtilen ödeme anlaşmazlığıyla ilgili ayrıntılar.

PurchaseReport

İstenen ödemeyle ilişkili satın alma işlemiyle ilgili ayrıntıları içeren bir rapor.

JSON gösterimi 
{
  "customerAccount": {
    object (CustomerAccount)
  },
  "order": {
    object (Order)
  },
  "payment": {
    object (Payment)
  }
}
Alanlar
customerAccount

object (CustomerAccount)

ZORUNLU: Müşteri ve hesabıyla ilgili bilgiler.
order

object (Order)

İSTEĞE BAĞLI: Ödemenin yapıldığı siparişle ilgili bilgiler. Tüm satın alma raporları için kullanılamaz.
payment

object (Payment)

ZORUNLU: Ödemeyle ilgili bilgiler. Not: Tek bir siparişte birden çok ödeme yapmak mümkündür, ancak bu sipariş yalnızca ilk istekte belirtilen ödeme bilgilerini içerir.

CustomerAccount

Müşterinin hesabıyla ilgili bilgiler.

JSON gösterimi 
{
  "customerEmail": string,
  "customerName": string
}
Alanlar
customerEmail

string

İSTEĞE BAĞLI: Müşterinin Google hesabıyla ilişkilendirilmiş e-posta adresi.
customerName

string

ZORUNLU: Müşterinin adı.

Sipariş

Siparişle ilgili bilgiler.

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

object (Timestamp)

ZORUNLU: Siparişin ne zaman verildiğini gösteren zaman damgası.
orderId

string

ZORUNLU: Bu siparişi benzersiz şekilde tanımlayan bir dize.
subTotalAmount

object (Amount)

ZORUNLU: Bu siparişin vergi hariç toplam tutarı.
totalAmount

object (Amount)

ZORUNLU: Vergi dahil bu siparişin toplam tutarı.
shippingAddress

object (Address)

İSTEĞE BAĞLI: Bu siparişteki fiziksel ürünlerin gönderim adresi.
items[]

object (Item)

ZORUNLU: Bu siparişin bir parçası olan öğelerin listesi.
taxes[]

object (Tax)

ZORUNLU: Bu siparişin bir parçası olan vergilerin listesi. Bu liste boş olabilir.

Tutar

Mikro cinsinden bir tutarı para birimi koduyla ilişkilendirir.

JSON gösterimi 
{
  "amountMicros": string,
  "currencyCode": string
}
Alanlar
amountMicros

string (Int64Value format)

ZORUNLU: Mikro cinsinden bir miktar.
currencyCode

string

ZORUNLU: ISO 4217 3 harfli para birimi kodu

Adres

Fiziksel adresle ilgili bilgileri içeren yapı.

JSON gösterimi 
{
  "addressLine": [
    string
  ],
  "localityName": string,
  "administrativeAreaName": string,
  "postalCodeNumber": string,
  "countryCode": string
}
Alanlar
addressLine[]

string

İSTEĞE BAĞLI: Bu, yapılandırılmamış Adres metnini içerir.
localityName

string

İSTEĞE BAĞLI: Bu, belirsiz bir terimdir, ancak genellikle adresin şehir/ilçe bölümünü ifade eder. Dünyanın konum bilgilerinin iyi tanımlanmadığı veya bu yapıya tam olarak uymadığı bölgelerde (ör. Japonya ve Çin) localityName'i boş bırakın ve addressLine'ı kullanın.

Örnekler: ABD şehri, BT topluluğu, Birleşik Krallık posta şehri.
administrativeAreaName

string

İSTEĞE BAĞLI: Bu ülkenin üst düzey idari alt bölümü" Örnekler: ABD eyaleti, BT bölgesi, CN bölgesi, Japonya vilayeti."
postalCodeNumber

string

İSTEĞE BAĞLI: Ada rağmen mailCodeNumber değerleri genellikle alfanümerik olur. Örnekler: "94043", "SW1W", "SW1W 9TQ".
countryCode

string

İSTEĞE BAĞLI: Müşteri adresi ülke kodu. ISO-3166-1 Alpha-2 olması beklenir.

Öğe

Siparişteki bir öğeyle ilgili bilgiler.

JSON gösterimi 
{
  "description": string,
  "merchant": string,
  "quantity": string,
  "totalPrice": {
    object (Amount)
  },
  "googleProductName": string
}
Alanlar
description

string

ZORUNLU: Satın alınan öğenin açıklaması.
merchant

string

ZORUNLU: Ürünün satıcısı, sanatçısı veya üreticisi.
quantity

string (Int64Value format)

İSTEĞE BAĞLI: Bu öğenin sipariş edildiği miktar.

Tam sayı miktarları ürün için geçerli değilse bu alan atlanır (ör. ölçülen ürünlerde kesirli sayılar olabilir).
totalPrice

object (Amount)

ZORUNLU: Bu öğenin toplam fiyatı.
googleProductName

string

ZORUNLU: Öğe için Google ürün hizmetinin adı.

Vergi

Bu sipariş için geçerli olan vergiyle ilgili bilgiler.

JSON gösterimi 
{
  "description": string,
  "amount": {
    object (Amount)
  }
}
Alanlar
description

string

ZORUNLU: Verginin açıklaması.
amount

object (Amount)

ZORUNLU: Vergi tutarı.

Ödeme

Ödemeyle ilgili bilgiler

JSON gösterimi 
{
  "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.
}
Alanlar
billingAddress

object (Address)

ZORUNLU: Bu ödemenin fatura adresi.
amount

object (Amount)

ZORUNLU: Bu ödemenin tutarı.
refunds[]

object (Refund)

ZORUNLU: Bu ödemeye yapılan geri ödemelerin listesi. Bu liste boş olabilir.

fopDetails alanı.

fopDetails şunlardan yalnızca biri olabilir:
cardDetails

object (PaymentCardDetails)

İSTEĞE BAĞLI: Kredi ve banka kartı ödeme yöntemlerine özel ödeme ayrıntıları.

Geri ödeme

Ödemede yapılan geri ödemeyle ilgili bilgiler.

JSON gösterimi 
{
  "amount": {
    object (Amount)
  },
  "initiatedTimestamp": {
    object (Timestamp)
  }
}
Alanlar
amount

object (Amount)

ZORUNLU: Geri ödenen tutar.
initiatedTimestamp

object (Timestamp)

ZORUNLU: Geri ödemenin başlatıldığı zaman damgası.

PaymentCardDetails

Kredi ve banka kartlarına özel ödeme ayrıntıları.

JSON gösterimi 
{
  "authResult": enum (AuthResult)
}
Alanlar
authResult

enum (AuthResult)

ZORUNLU: Ödeme yetkilendirmesinin sonucu.

AuthResult

Ödeme yetkilendirme sonuçları.

Sıralamalar
UNKNOWN_RESULT Bu varsayılan değeri hiçbir zaman ayarlamayın.
APPROVED Yetkilendirme onaylandı.
DENIED Yetkilendirme reddedildi.
NOT_ATTEMPTED Yetkilendirme işlemi denenmedi.

Boş

Bu türde alan yok.

Bu nesne, boole ve numaralandırma işlemlerinin genellikle ekstra verilerle genişletilmesi gerektiğinden genişletilebilirlik için kullanılır. Uygulayan kişi, varlığı belirlemek için bu verileri kullanır. Bunun temsil ettiği sıralama, gelecekteki sürümlerde yer alan verileri içerecek şekilde genişletilebilir.

Empty için JSON gösterimi boş {} JSON nesnesidir.

ErrorResponse

Tüm yöntemler için Hata Yanıtı nesnesi.

JSON gösterimi 
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "errorDescription": string,
  "paymentIntegratorErrorIdentifier": string,
  "errorResponseResult": {
    object (ErrorResponseResult)
  }
}
Alanlar
responseHeader

object (ResponseHeader)

ZORUNLU: Tüm yanıtlar için ortak başlık.
errorDescription

string

İSTEĞE BAĞLI: Destek temsilcilerinin hataları ayıklaması için bu durumun açıklamasını girin. Bunun kullanıcılara hiçbir zaman gösterilmediğine dikkat edin. Hata ayıklama için kullanılan, açıklayıcı ve hassas olmayan metinler içerebilir. errorResponseCode için bazı değerlere bu alanda ek ayrıntılar sağlanması gerektiğini unutmayın. Uyarı: Herkese açık olarak tanımlanmadığı sürece bu iletiye hiçbir simge eklemeyin.
paymentIntegratorErrorIdentifier

string

İSTEĞE BAĞLI: Bu tanımlayıcı, entegratöre özeldir ve entegratör tarafından oluşturulur. Bu bilgi, yalnızca bu aramayı tanımlamak amacıyla hata ayıklama amacıyla kullanılır. Bu, entegratörün bu çağrıyı bildiği tanımlayıcıdır.
errorResponseResult

object (ErrorResponseResult)

İSTEĞE BAĞLI: Oluşan hatanın türünü yakalayan bir kod.

ErrorResponseResult

Hata Kodları

JSON gösterimi 
{

  // 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.
}
Alanlar

result alanı.

result şunlardan yalnızca biri olabilir:
invalidApiVersion

object (InvalidApiVersion)

İsteğin API sürümü desteklenmiyorsa kullanılır. Önerilen HTTP Kodu: 400
invalidPayloadSignature

object (InvalidPayloadSignature)

Yükün imzası bilinmeyen veya etkin olmayan bir anahtara aitse kullanılır. Önerilen HTTP Kodu: 401
invalidPayloadEncryption

object (InvalidPayloadEncryption)

Yükün şifrelemesi, bilinmeyen veya etkin olmayan bir anahtara yapılıyorsa kullanılır. Önerilen HTTP Kodu: 400
requestTimestampOutOfRange

object (RequestTimestampOutOfRange)

requestTimestamp değeri şu an ± 60 sn. değilse kullanılır. Önerilen HTTP Kodu: 400
invalidIdentifier

object (InvalidIdentifier)

İstekte gönderilen bir tanımlayıcı geçersizse veya bilinmiyorsa kullanılır. Bu; PIAID, reCAPTCHARequestId, Google Ödeme Jetonu vb. içerebilir. Tavsiye Edilen HTTP Kodu: 404
idempotencyViolation

object (IdempotencyViolation)

İstek için acil durum gereksinimlerini ihlal ediyorsa kullanılır. Önerilen HTTP Kodu: 412
invalidFieldValue

object (InvalidFieldValue)

İstek, desteklenen değerler kümesinde yer almayan bir alan için değer içeriyorsa kullanılır. Önerilen HTTP Kodu: 400
missingRequiredField

object (MissingRequiredField)

Zorunlu bir alan istekte ayarlanmamışsa kullanılır. Önerilen HTTP Kodu: 400
preconditionViolation

object (PreconditionViolation)

İşlemle ilgili bir kısıtlama ihlal edilirse (ör. geri ödeme tutarı isteği, işlemde kalan tutarı aştığında) kullanılır. Önerilen HTTP Kodu: 400
userActionInProgress

object (UserActionInProgress)

İstek, etkin bir şekilde sistem kilidi işlevi gören, işlemdeki bir kullanıcı işlemini kesintiye uğratacağı için şu anda işlenemiyorsa kullanılır. Bu kod, uygulamaya özgü dahili eşzamanlılık hatalarından kaynaklanan hataları belirtmek için kullanılmamalıdır. Önerilen HTTP Kodu: 423
invalidDecryptedRequest

object (InvalidDecryptedRequest)

İstek yükünün şifresinin çözülebilmesi ancak sonuç mesajı ayrıştırılamadıysa kullanılır. Önerilen HTTP Kodu: 400
forbidden

object (Forbidden)

İstenen kaynağa erişim yasak. Tavsiye Edilen Http Kodu: 403

InvalidApiVersion

JSON gösterimi 
{
  "requestVersion": {
    object (Version)
  },
  "expectedVersion": {
    object (Version)
  }
}
Alanlar
requestVersion

object (Version)

ZORUNLU: İstekte belirtilen geçersiz sürüm.
expectedVersion

object (Version)

ZORUNLU: Beklenen sürüm.

InvalidPayloadSignature

Bu türde alan yok.

Bu mesaj şu anda kasıtlı olarak boş bırakılmış. Gelecekte yeni alanlar eklenebilir.

InvalidPayloadEncryption

Bu türde alan yok.

Bu mesaj şu anda kasıtlı olarak boş bırakılmış. Gelecekte yeni alanlar eklenebilir.

RequestTimestampOutOfRange

JSON gösterimi 
{
  "requestTimestamp": {
    object (Timestamp)
  },
  "serverTimestampAtReceipt": {
    object (Timestamp)
  }
}
Alanlar
requestTimestamp

object (Timestamp)

ZORUNLU: İstekte belirtilen zaman damgası
serverTimestampAtReceipt

object (Timestamp)

ZORUNLU: Alınan sunucu saati; karşılaştırma için kullanılır

InvalidIdentifier

JSON gösterimi 
{
  "invalidIdentifierType": string
}
Alanlar
invalidIdentifierType

string

ZORUNLU: Geçersiz tanımlayıcı türü (ör. PIAID, reCAPTCHARequestId vb.)

IdempotencyViolation

Bu türde alan yok.

Bu mesaj şu anda kasıtlı olarak boş bırakılmış. Gelecekte yeni alanlar eklenebilir.

InvalidFieldValue

JSON gösterimi 
{
  "invalidFieldName": string
}
Alanlar
invalidFieldName

string

ZORUNLU: Geçersiz olduğu tespit edilen alanın adı.

MissingRequiredField

JSON gösterimi 
{
  "missingFieldNames": [
    string
  ]
}
Alanlar
missingFieldNames[]

string

ZORUNLU: Eksik alanların adları.

PreconditionViolation

Bu türde alan yok.

Bu mesaj şu anda kasıtlı olarak boş bırakılmış. Gelecekte yeni alanlar eklenebilir.

UserActionInProgress

Bu türde alan yok.

Bu mesaj şu anda kasıtlı olarak boş bırakılmış. Gelecekte yeni alanlar eklenebilir.

InvalidDecryptedRequest

Bu türde alan yok.

Bu mesaj şu anda kasıtlı olarak boş bırakılmış. Gelecekte yeni alanlar eklenebilir.

Yasak

Bu türde alan yok.

Bu mesaj şu anda kasıtlı olarak boş bırakılmış. Gelecekte yeni alanlar eklenebilir.