Method: getDisputeInquiryReport

उपयोगकर्ता के पेमेंट से जुड़े विवाद को लेकर, ग्राहक सहायता टीम की बातचीत करने की रिपोर्ट पाएं.

अगर अनुरोध प्रोसेस करते समय एंडपॉइंट को गड़बड़ी मिलती है, तो इस एंडपॉइंट से मिला रिस्पॉन्स ErrorResponse तरह का होगा.

अगर यह तरीका, एचटीटीपी 200 का इस्तेमाल नहीं करता है, तो इस क्वेरी के जवाब खाली दिख सकते हैं. रिस्पॉन्स का मुख्य हिस्सा खाली होता है. इसमें, ErrorResponse के बारे में सटीक जानकारी होती है. इससे, हमलावर को अन्य इंटिग्रेटर के पेमेंट इंटिग्रेटर खाते के आइडेंटिफ़ायर को समझने में मदद मिलती है. इन मामलों में, अगर साइनिंग कुंजी मेल नहीं खाती, तो पेमेंट इंटिग्रेटर आइडेंटिफ़ायर नहीं मिलता या एन्क्रिप्ट (सुरक्षित) करने की कुंजी के बारे में कोई जानकारी नहीं होती, लेकिन इस तरीके से एचटीटीपी 404 गड़बड़ी के साथ दिखेगा. अगर अनुरोध हस्ताक्षर की पुष्टि की जा सकती है, तो जवाब के मुख्य भाग में गड़बड़ी के बारे में अतिरिक्त जानकारी दिखाई जाएगी.

अनुरोध का उदाहरण ऐसा दिखता है:


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

उदाहरण के तौर पर दिया गया जवाब कुछ इस तरह दिखता है:


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

एचटीटीपी अनुरोध

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

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, नीचे दिए गए स्ट्रक्चर का डेटा शामिल है:

जेएसओएन के काेड में दिखाना 
{
  "requestHeader": {
    object (RequestHeader)
  },
  "paymentIntegratorAccountId": string,
  "paymentLookupCriteria": {
    object (PaymentLookupCriteria)
  },
  "existingGoogleClaimId": string,
  "requestOriginator": {
    object (RequestOriginator)
  }
}
फ़ील्ड
requestHeader

object (RequestHeader)

ज़रूरी: सभी अनुरोधों के लिए सामान्य हेडर.
paymentIntegratorAccountId

string

ज़रूरी है: पेमेंट इंटिग्रेटर खाते का आइडेंटिफ़ायर, जो इस इंटरैक्शन के लिए, कॉल करने वाले (कॉलर) और उससे जुड़े कॉन्ट्रैक्ट की सीमाओं की पहचान करता है.
paymentLookupCriteria

object (PaymentLookupCriteria)

ज़रूरी: इस पूछताछ के लिए खोजे जाने वाले भुगतान को दिखाने वाला मानदंड.
existingGoogleClaimId

string

ज़रूरी नहीं: Google की जनरेट की गई स्ट्रिंग, जो getDisputeInquiryReport पर किए गए पिछले कॉल से मिली है. इस कॉल से खास तौर पर, ग्राहक के विवाद का पता चलता है.

अगर यह मौजूद नहीं है, तो एक नया दावा आईडी जनरेट किया जाएगा. ग्राहक के ऐसे ही किसी विवाद को जारी रखने के लिए, कॉलर getDisputeInquiryReport को googleClaimId पर कॉल कर सकता है.

जो दावे का आईडी यहां अपने-आप जनरेट हुआ है या जनरेट हुआ है वह रिस्पॉन्स के googleClaimId फ़ील्ड में दिखेगा.

इस googleClaimId को देना मान्य नहीं है, क्योंकि getDisputeInquiryReport को पहले किए गए कॉल में वापस नहीं आया था. ऐसा होने पर, एचटीटीपी 400 खराब अनुरोध दिखेगा.
requestOriginator

object (RequestOriginator)

ज़रूरी है: इस अनुरोध की शुरुआत करने वाले संगठन या संगठन के ग्रुप के बारे में जानकारी.

जवाब का मुख्य भाग

getDisputeInquiryReport तरीके के लिए रिस्पॉन्स पेलोड.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

जेएसओएन के काेड में दिखाना 
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "result": enum (GetDisputeInquiryReportResultCode),
  "googleClaimId": string,
  "report": {
    object (PurchaseReport)
  }
}
फ़ील्ड
responseHeader

object (ResponseHeader)

ज़रूरी: सभी जवाबों के लिए सामान्य हेडर.
result

enum (GetDisputeInquiryReportResultCode)

ज़रूरी है: इस कॉल का नतीजा.
googleClaimId

string

ज़रूरी नहीं: Google की जनरेट की गई ऐसी स्ट्रिंग जो ग्राहक के विवाद को खास तौर पर पहचानती है. (अगर मौजूद है और सिर्फ़ result ही है, तो यह दिखाएं.)

अगर अनुरोध में existingGoogleClaimId अपने-आप भरता है, तो यह वही वैल्यू होगी. अगर ऐसा नहीं है, तो यह एक नई जनरेट की गई वैल्यू होगी. यह वैल्यू, आने वाले समय में getDisputeInquiryReport अनुरोधों के लिए उपलब्ध कराई जा सकती है. ऐसा तब होगा, जब वे एक ही ग्राहक से जुड़े विवाद का हिस्सा हों.
report

object (PurchaseReport)

ज़रूरी नहीं: अनुरोध में बताए गए पेमेंट से जुड़े विवाद से जुड़ी जानकारी. (अगर मौजूद है और सिर्फ़ result ही है, तो यह दिखाएं.)

PaymentlookupCriteria

ऐसी शर्तों का कंटेनर, जिसमें यूनीक पेमेंट को देखा जा सकता है. एक (सिर्फ़ एक) सदस्य फ़ील्ड में जानकारी भरी जानी चाहिए.

जेएसओएन के काेड में दिखाना 
{

  // 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.
}
फ़ील्ड

यूनियन फ़ील्ड criteria.

criteria इनमें से सिर्फ़ एक हो सकता है:
arnCriteria

object (ArnCriteria)

ज़रूरी नहीं: अक्वाियरर रेफ़रंस नंबर (ARN) के मुताबिक लुकअप.
googleTransactionReferenceNumberCriteria

object (GoogleTransactionReferenceNumberCriteria)

ज़रूरी नहीं: Google लेन-देन के रेफ़रंस नंबर के आधार पर लुकअप.
captureRequestCriteria

object (CaptureRequestCriteria)

ज़रूरी नहीं: कैप्चर अनुरोध आईडी पर आधारित लुकअप.

आर्न मानदंड

हासिल करने वाले के रेफ़रंस नंबर (ARN) के आधार पर पेमेंट लुकअप.

जेएसओएन के काेड में दिखाना 
{
  "acquirerReferenceNumber": string,
  "authorizationCode": string
}
फ़ील्ड
acquirerReferenceNumber

string

ज़रूरी है: हासिल करने वाले का रेफ़रंस नंबर (आरआरएन), पेमेंट की खास तौर पर पहचान करता है. इसमें 23 अंक होने चाहिए.
authorizationCode

string

ज़रूरी: लेन-देन के लिए अनुमति कोड.

Google transactionReferenceNumberCriteria

Google की जनरेट की गई लेन-देन की जानकारी देने वाले रेफ़रंस नंबर के आधार पर पेमेंट लुकअप.

जेएसओएन के काेड में दिखाना 
{
  "googleTransactionReferenceNumber": string,
  "authorizationCode": string
}
फ़ील्ड
googleTransactionReferenceNumber

string

ज़रूरी है: Google की ओर से जनरेट किया गया लेन-देन का रेफ़रंस नंबर, जो खास तौर पर पेमेंट की पहचान करता है.
authorizationCode

string

ज़रूरी: लेन-देन के लिए अनुमति कोड.

कैप्चर अनुरोध मानदंड

मूल कैप्चर अनुरोध पर आधारित भुगतान लुकअप मानदंड.

जेएसओएन के काेड में दिखाना 
{
  "captureRequestId": string
}
फ़ील्ड
captureRequestId

string

ज़रूरी है: इस लेन-देन के लिए यूनीक आइडेंटिफ़ायर. यह requestId, Google की ओर से capture कॉल के दौरान जनरेट हुआ है. इसे खोजा जा रहा है.

अनुरोध की शुरुआत करने वाला

संगठन या संगठन के उप-ग्रुप के बारे में जानकारी. साथ ही, विकल्प के तौर पर उस कर्मचारी के बारे में जानकारी जिसके लिए अनुरोध किया गया है. इससे Google, समस्याओं की पहचान कर सकता है या उनके गलत इस्तेमाल की पहचान कर सकता है. साथ ही, Google के कंट्रोल को, paymentIntegratorAccountId की तुलना में ज़्यादा बारीकी से लागू कर सकता है. यह खास तौर पर तब अहम होता है, जब कॉलर एक मध्यस्थ सेवा देने वाला होता है, जो कई बाहरी क्लाइंट से अनुरोध ले लेता है.

जेएसओएन के काेड में दिखाना 
{
  "organizationId": string,
  "organizationDescription": string,
  "agentId": string
}
फ़ील्ड
organizationId

string

ज़रूरी: उस कंपनी, संगठन या संगठन के ग्रुप का आइडेंटिफ़ायर जिससे अनुरोध किया गया है. इस paymentIntegratorAccountId में अलग होना चाहिए.
organizationDescription

string

ज़रूरी: संगठन का ऐसा नाम या ब्यौरा जिसे कोई भी व्यक्ति पढ़ सकता है. इसका इस्तेमाल, Google के कर्मचारियों और उस संगठन के बारे में पूरी कंपनी के बीच बातचीत को आसान बनाने के लिए किया जा सकता है.
agentId

string

ज़रूरी नहीं: संगठन के उस खास एजेंट (कर्मचारी) का यूनीक आइडेंटिफ़ायर जिसकी पहचान organizationId से की गई है, जिससे यह अनुरोध किया गया है. इस organizationId में अलग होना चाहिए.

पाएं जीके की शिकायत का नतीजा

getDisputeInquiryReport मेथड कॉल का नतीजा.

Enums
UNKNOWN_RESULT इस डिफ़ॉल्ट वैल्यू को कभी सेट न करें!
SUCCESS पेमेंट की जानकारी मिलने पर, रिपोर्ट उपलब्ध कराई जाती है.
PAYMENT_NOT_FOUND अनुरोध किया गया पेमेंट नहीं मिला.
PAYMENT_TOO_OLD जिस पेमेंट का अनुरोध किया गया था वह मिल गया, लेकिन उस समय की वजह से उसकी शिकायत नहीं की गई.
ORDER_CANNOT_BE_RETURNED अनुरोध किया गया पेमेंट ऐसे ऑर्डर का है जो मौजूद है, लेकिन उसे वापस नहीं किया जा सकता. वजहों में वे मामले शामिल हैं जहां मालिक के अनुरोध पर ऑर्डर को हटा दिया गया था.
NO_ADDITIONAL_DETAILS अनुरोध किया गया पेमेंट मिला, लेकिन उसकी रिपोर्ट उपलब्ध नहीं है.

खरीदारी की रिपोर्ट

एक रिपोर्ट जिसमें अनुरोध किए गए पेमेंट से जुड़ी खरीदारी की जानकारी शामिल हो.

जेएसओएन के काेड में दिखाना 
{
  "customerAccount": {
    object (CustomerAccount)
  },
  "order": {
    object (Order)
  },
  "payment": {
    object (Payment)
  }
}
फ़ील्ड
customerAccount

object (CustomerAccount)

ज़रूरी: ग्राहक और उसके खाते के बारे में जानकारी.
order

object (Order)

ज़रूरी है: पेमेंट के ऑर्डर के बारे में जानकारी.
payment

object (Payment)

ज़रूरी नहीं: पेमेंट से जुड़ी जानकारी. ध्यान दें: एक ही ऑर्डर में कई पेमेंट किए जा सकते हैं, लेकिन इसमें सिर्फ़ उस पेमेंट की जानकारी शामिल होगी जिसकी पहचान ओरिजनल ऑर्डर में की गई है. सभी तरह के ऑर्डर के लिए उपलब्ध नहीं.

ग्राहक खाता

ग्राहक के खाते की जानकारी

जेएसओएन के काेड में दिखाना 
{
  "customerEmail": string,
  "customerName": string
}
फ़ील्ड
customerEmail

string

ज़रूरी है: ग्राहक के Google खाते से जुड़ा ईमेल पता.
customerName

string

ज़रूरी है: ग्राहक का नाम.

ऑर्डर करें

ऑर्डर के बारे में जानकारी.

जेएसओएन के काेड में दिखाना 
{
  "timestamp": string,
  "orderId": string,
  "currencyCode": string,
  "subTotalAmount": string,
  "totalAmount": string,
  "shippingAddress": {
    object (Address)
  },
  "items": [
    {
      object (Item)
    }
  ],
  "taxes": [
    {
      object (Tax)
    }
  ]
}
फ़ील्ड
timestamp

string (int64 format)

ज़रूरी नहीं: ऑर्डर होने के समय का टाइमस्टैंप, जिसे epoch के बाद से मिलीसेकंड के तौर पर दिखाया जाता है. सभी तरह के ऑर्डर के लिए उपलब्ध नहीं.
orderId

string

ज़रूरी नहीं: इस ऑर्डर की खास तौर पर पहचान करने वाली स्ट्रिंग. सभी तरह के ऑर्डर के लिए उपलब्ध नहीं.
currencyCode

string

ज़रूरी नहीं: इस ऑर्डर की सभी रकम के लिए, ISO 4217 का तीन अक्षर वाला मुद्रा कोड. सभी तरह के ऑर्डर के लिए उपलब्ध नहीं.
subTotalAmount

string (Int64Value format)

ज़रूरी नहीं: टैक्स से पहले इस ऑर्डर की कुल रकम जो order.currencyCode में दी गई मुद्रा के माइक्रो के तौर पर दिखाई जाती है. यह SUM(items.totalPrice) के बराबर है. सभी तरह के ऑर्डर के लिए उपलब्ध नहीं.
totalAmount

string (Int64Value format)

ज़रूरी नहीं: टैक्स के साथ-साथ इस ऑर्डर की कुल रकम. यह order.currencyCode में दी गई मुद्रा के माइक्रो के तौर पर दिखती है. यह subTotalAmount + SUM(taxes.amount) के बराबर है. सभी तरह के ऑर्डर के लिए उपलब्ध नहीं.
shippingAddress

object (Address)

ज़रूरी नहीं: इस ऑर्डर में दिए गए सामान के लिए शिपिंग पता.
items[]

object (Item)

ज़रूरी है: उन आइटम की सूची जो इस ऑर्डर का हिस्सा थे.
taxes[]

object (Tax)

ज़रूरी है: उन आइटम की सूची जो इस ऑर्डर का हिस्सा थे. यह सूची खाली हो सकती है.

पता

पते के बारे में जानकारी देने वाले स्ट्रक्चर.

जेएसओएन के काेड में दिखाना 
{
  "name": string,
  "addressLine": [
    string
  ],
  "localityName": string,
  "administrativeAreaName": string,
  "postalCodeNumber": string,
  "countryCode": string
}
फ़ील्ड
name

string

ज़रूरी नहीं: ग्राहक का पूरा नाम.
addressLine[]

string

ज़रूरी नहीं: इसमें पता नहीं दिया गया टेक्स्ट शामिल होता है.
localityName

string

ज़रूरी नहीं: यह भ्रमित करने वाला शब्द है. आम तौर पर, यह किसी पते के शहर/शहर का हिस्सा होता है. दुनिया के उन इलाकों के लिए जहां मोहल्ले अच्छी तरह से तय नहीं किए गए हैं या इस स्ट्रक्चर में ठीक से फ़िट नहीं होते (उदाहरण के लिए, जापान और चीन), localityName को खाली छोड़ दें और addressLine का इस्तेमाल करें.

उदाहरण: यूएस सिटी, आईटी कम्यून, यूके पोस्ट टाउन.
administrativeAreaName

string

ज़रूरी नहीं: इस देश का टॉप-लेवल एडमिनिस्ट्रेटिव सबडिवीज़न" उदाहरण: अमेरिका का राज्य, आईटी क्षेत्र, सीएन प्रांत, जेपी प्रांत."
postalCodeNumber

string

ज़रूरी नहीं: नाम होने के बावजूद, पिनकोड नंबर की वैल्यू, अक्सर अक्षर और अंक होते हैं. उदाहरण के लिए: "94043", "SW1W", "SW1W 9TQ".
countryCode

string

ज़रूरी नहीं: ग्राहक के पते का देश कोड, ISO-3166-1 Alpha-2 होना चाहिए.

आइटम

ऑर्डर में मौजूद किसी आइटम की जानकारी.

जेएसओएन के काेड में दिखाना 
{
  "description": string,
  "merchant": string,
  "quantity": string,
  "totalPrice": string,
  "googleProductName": string
}
फ़ील्ड
description

string

ज़रूरी नहीं: खरीदे गए आइटम का ब्यौरा. सभी तरह के ऑर्डर के लिए उपलब्ध नहीं.
merchant

string

ज़रूरी है: आइटम का विक्रेता, कलाकार या निर्माता.
quantity

string (Int64Value format)

ज़रूरी नहीं: इस आइटम का ऑर्डर दिया गया.

अगर प्रॉडक्ट पर पूर्णांक संख्याएं लागू नहीं होती हैं, तो इस फ़ील्ड को छोड़ दिया जाएगा (उदाहरण के लिए, मीटर किए गए प्रॉडक्ट में फ़्रैक्शनल संख्याएं हो सकती हैं).
totalPrice

string (Int64Value format)

ज़रूरी नहीं: इस आइटम की कुल कीमत, order.currencyCode में दी गई मुद्रा के माइक्रो के तौर पर दिखाई जाती है. अगर quantity में अपने-आप जानकारी भर जाती है, तो यह पता चलता है कि कुल कीमत कितनी है. सभी तरह के ऑर्डर के लिए उपलब्ध नहीं.
googleProductName

string

ज़रूरी: सामान के लिए Google प्रॉडक्ट सेवा का नाम.

टैक्स

इस ऑर्डर पर लागू होने वाले किसी टैक्स की जानकारी.

जेएसओएन के काेड में दिखाना 
{
  "description": string,
  "amount": string
}
फ़ील्ड
description

string

ज़रूरी है: टैक्स की जानकारी.
amount

string (Int64Value format)

ज़रूरी है: टैक्स की वह रकम जिसे order.currencyCode में दी गई मुद्रा के माइक्रो के तौर पर दिखाया जाता है.

पेमेंट

पेमेंट के बारे में जानकारी.

जेएसओएन के काेड में दिखाना 
{
  "billingAddress": {
    object (Address)
  },
  "amount": string,
  "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.
}
फ़ील्ड
billingAddress

object (Address)

ज़रूरी है: इस पेमेंट के लिए बिलिंग पता.
amount

string (Int64Value format)

ज़रूरी है: पेमेंट की वह रकम जिसे order.currencyCode में दी गई मुद्रा के माइक्रो के तौर पर दिखाया जाता है. ध्यान दें: अगर ऑर्डर की एक से ज़्यादा बार पैसे चुकाए गए हैं, तो हो सकता है कि यह order.totalAmount से मेल न खाए.
refunds[]

object (Refund)

ज़रूरी: इस पेमेंट के लिए किए गए रिफ़ंड की सूची. यह सूची खाली हो सकती है.

यूनियन फ़ील्ड fopDetails.

fopDetails इनमें से सिर्फ़ एक हो सकता है:
cardDetails

object (PaymentCardDetails)

ज़रूरी नहीं: क्रेडिट और डेबिट कार्ड के एफ़ओपी के लिए पैसे चुकाने की जानकारी.

रिफ़ंड

पेमेंट पर किए गए रिफ़ंड के बारे में जानकारी.

जेएसओएन के काेड में दिखाना 
{
  "amount": string,
  "initiatedTimestamp": string
}
फ़ील्ड
amount

string (Int64Value format)

ज़रूरी है: रिफ़ंड की गई रकम, order.currencyCode में दी गई मुद्रा के माइक्रो की पॉज़िटिव संख्या है.
initiatedTimestamp

string (int64 format)

ज़रूरी है: रिफ़ंड शुरू होने के समय का टाइमस्टैंप. यह epoch के बाद से मिलीसेकंड में दिखता है.

पेमेंटकार्ड की जानकारी

क्रेडिट या डेबिट कार्ड के लिए पैसे चुकाने का ब्यौरा.

जेएसओएन के काेड में दिखाना 
{
  "authResult": enum (AuthResult)
}
फ़ील्ड
authResult

enum (AuthResult)

ज़रूरी: पैसे चुकाने की पुष्टि करने का नतीजा.

पुष्टि का नतीजा

पेमेंट करने के तरीके से जुड़े नतीजे.

Enums
UNKNOWN_RESULT इस डिफ़ॉल्ट वैल्यू को कभी सेट न करें!
APPROVED अनुमति मिल गई.
DENIED अनुमति नहीं मिली.
NOT_ATTEMPTED अधिकार देने की कोशिश नहीं की गई.