Method: disburseFundsResultNotification

disburseFunds तरीके का इस्तेमाल करने के बाद, पेमेंट की जानकारी Google को दें.

यह disburseFundsResult वैल्यू, disburseFundsRequestId के लिए एक जैसी है. इसलिए, इसकी वैल्यू disburseFunds कॉल के दौरान मिली वैल्यू से मेल खानी चाहिए. साथ ही, इस तरीके से आने वाले कॉल से इसे बदला नहीं जा सकता.

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

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

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


{
  "requestHeader": {
    "protocolVersion": {
      "major": 1,
      "minor": 1,
      "revision": 0
    },
    "requestId": "KcgwSKrV76eVNDUbsZ4UA3",
    "requestTimestamp": "1481852928293"
  },
  "paymentIntegratorAccountId": "InvisiCashUSA_USD",
  "disburseFundsRequestId": "awNaC510cefae3IJdNEvW2",
  "disburseFundsResult": {
    "disburseFundsResultCode": "SUCCESS"
  }
}

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


{
  "responseHeader": {
    "responseTimestamp": "1481852928324"
  },
  "result": "SUCCESS"
}

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

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

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

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

जेएसओएन के काेड में दिखाना 
{
  "requestHeader": {
    object (RequestHeader)
  },
  "paymentIntegratorAccountId": string,
  "disburseFundsRequestId": string,
  "disburseFundsResult": {
    object (DisburseFundsResult)
  }
}
फ़ील्ड
requestHeader

object (RequestHeader)

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

string

ज़रूरी: पेमेंट इंटिग्रेटर खाता आइडेंटिफ़ायर, जिस पर पेमेंट किया गया था.
disburseFundsRequestId

string

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

यह ज़्यादा से ज़्यादा 100 वर्णों की एक स्ट्रिंग होती है और इसमें सिर्फ़ "a-z", "A-Z", "0-9", ":", "-", और "_" वर्ण शामिल होते हैं.
disburseFundsResult

object (DisburseFundsResult)

ज़रूरी है: इस बकाया रकम वाले कॉल का नतीजा.

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

disburseFundsResultNotification तरीके के लिए रिस्पॉन्स ऑब्जेक्ट.

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

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

object (ResponseHeader)

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

enum (DisburseFundsResultNotificationResultCode)

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

पेमेंट के लिए नतीजे

पेमेंट के आखिरी नतीजे के बारे में जानकारी.

जेएसओएन के काेड में दिखाना 
{
  "disburseFundsResultCode": enum (DisburseFundsResultCode),
  "rawResult": {
    object (RawResult)
  },

  // Union field FailureDetail can be only one of the following:
  "transactionMaxLimit": string,
  "transactionMinLimit": string
  // End of list of possible types for union field FailureDetail.
}
फ़ील्ड
disburseFundsResultCode

enum (DisburseFundsResultCode)

ज़रूरी है: बांटे गए पैसों का नतीजों का कोड.
rawResult

object (RawResult)

ज़रूरी नहीं: इस पेमेंट का रॉ नतीजा. इस डेटा का इस्तेमाल, Google के जोखिम इंजन और आंकड़ों की जानकारी देने के लिए किया जाता है. कोड को मैप करने की स्थितियों में, डेटा कभी-कभी खो जाता है. इंटिग्रेटर, Google को एक रॉ कोड चुन सकता है. उदाहरण के लिए, क्रेडिट कार्ड गेटवे (इंटिग्रेटर) इस फ़ील्ड का इस्तेमाल, VISA नेटवर्क से मिले Google को पुष्टि करने के लिए, अस्वीकार किए जाने वाले कोड की सही जानकारी देने के लिए कर सकता है. इस मामले में, "Visa" होने पर scope और VISA नेटवर्क से मिलने वाला रिटर्न rawCode दिखेगा.

अगर result SUCCESS नहीं है, तो यह वैल्यू ज़रूरी है.

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

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

string (Int64Value format)

ज़रूरी नहीं: अगर disburseFundsResultCode DISBURSEMENT_EXCEEDS_TRANSACTION_LIMIT है, तो यह, लेन-देन की ज़्यादा से ज़्यादा सीमा की वैल्यू है. इसका इस्तेमाल स्ट्रक्चर्ड मैसेज, उपयोगकर्ता को दिखने वाले मैसेज, और अस्वीकार किए जाने की दर के विश्लेषण के लिए किया जाता है.

यह रकम उसी currencyCode के माइक्रो है, जो मूल disburseFunds तरीके के कॉल की है.
transactionMinLimit

string (Int64Value format)

ज़रूरी नहीं: अगर disburseFundsResultCode, DISBURSEMENT_UNDER_TRANSACTION_LIMIT है, तो यह ऐसे लेन-देन की वैल्यू है जिसकी अनुमति है. इसका इस्तेमाल स्ट्रक्चर्ड मैसेज, उपयोगकर्ता को दिखने वाले मैसेज, और अस्वीकार किए जाने की दर के विश्लेषण के लिए किया जाता है.

यह रकम उसी currencyCode के माइक्रो है, जो मूल disburseFunds तरीके के कॉल की है.

दिए गए फ़ंड के नतीजे का कोड

लेन-देन के लिए मिले कॉल के नतीजे के कोड.

Enums
UNKNOWN_RESULT इस डिफ़ॉल्ट वैल्यू को कभी सेट न करें!
SUCCESS पेमेंट हो गया.
DISBURSEMENT_UNDER_TRANSACTION_LIMIT अनुरोध की गई रकम, इंटिग्रेटर की हर लेन-देन की कम से कम रकम के बराबर नहीं है. अगर इस कोड का इस्तेमाल किया जाता है, तो उपयोगकर्ता फ़ील्ड के लिए कम से कम लेन-देन के साथ transactionMinLimit फ़ील्ड को भरें.
DISBURSEMENT_EXCEEDS_TRANSACTION_LIMIT अनुरोध की गई रकम को इंटिग्रेटर की ओर से तय की गई हर लेन-देन की सीमा पार हो गई है. अगर इस कोड का इस्तेमाल किया जाता है, तो उपयोगकर्ता मैसेज सेवा के लिए लेन-देन सीमा के साथ transactionMaxLimit फ़ील्ड को पॉप्युलेट करें.
ACCOUNT_CLOSED उपयोगकर्ता के इंटिग्रेटर वाला खाता बंद कर दिया गया है. रिटर्न की इस वैल्यू की वजह से, उपयोगकर्ता के इंस्ट्रूमेंट को Google के साथ बंद कर दिया जाएगा. उपयोगकर्ता को एक नया इंस्ट्रुमेंट जोड़ना होगा.
ACCOUNT_CLOSED_ACCOUNT_TAKEN_OVER उपयोगकर्ता के खाते को इंटिग्रेटर के साथ बंद कर दिया गया है. हो सकता है कि यह खाता किसी दूसरे खाते का इस्तेमाल कर रहा हो. रिटर्न की इस वैल्यू की वजह से, उपयोगकर्ता के इंस्ट्रूमेंट को Google के साथ बंद कर दिया जाएगा. उपयोगकर्ता को एक नया इंस्ट्रुमेंट जोड़ना होगा.
ACCOUNT_CLOSED_FRAUD धोखाधड़ी की वजह से, इंटिग्रेटर के पास मौजूद उपयोगकर्ता का खाता बंद कर दिया गया है. रिटर्न की इस वैल्यू की वजह से, उपयोगकर्ता के इंस्ट्रूमेंट को Google के साथ बंद कर दिया जाएगा. उपयोगकर्ता को एक नया इंस्ट्रुमेंट जोड़ना होगा.
ACCOUNT_ON_HOLD उपयोगकर्ता के खाते पर रोक लगी है.

नतीजा

रॉ नतीजा ऑब्जेक्ट.

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

string

ज़रूरी नहीं: RawCode का दायरा खाली हो सकता है.
rawCode

string

ज़रूरी है: इंटिग्रेटर या उसमें मौजूद सबसिस्टम से रॉ कोड.

डेवलपर को मिले नतीजों का ब्यौरा

disburseFundsResultNotification तरीके के लिए नतीजे के कोड.

Enums
UNKNOWN_RESULT इस डिफ़ॉल्ट वैल्यू को कभी सेट न करें!
SUCCESS सूचना को प्रोसेस किया गया.