Method: disburseFundsResultNotification

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

इस disburseFundsRequestId के लिए disburseFundsResult वैल्यू अलग-अलग है. इसलिए, इसकी वैल्यू, 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

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

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

JSON के काेड में दिखाना 
{
  "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 तरीके के लिए रिस्पॉन्स ऑब्जेक्ट.

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

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

object (ResponseHeader)

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

enum (DisburseFundsResultNotificationResultCode)

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

DisburseFundsResult

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

JSON के काेड में दिखाना 
{
  "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 को रॉ कोड देने का विकल्प होता है. उदाहरण के लिए, क्रेडिट कार्ड गेटवे (इंटीग्रेटर) इस फ़ील्ड का इस्तेमाल करके, Google को अस्वीकार करने के लिए उसी कोड का इस्तेमाल कर सकता है जो VISA नेटवर्क से मिला है. इस मामले में, scope "वीज़ा" होगा और VISA नेटवर्क से मिलने वाली रकम rawCode होगी.

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

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

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

string (Int64Value format)

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

यह रकम और disburseFunds तरीके, दोनों के लिए इस्तेमाल किए गए currencyCode के माइक्रो हैं.
transactionMinLimit

string (Int64Value format)

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

यह रकम और disburseFunds तरीके, दोनों के लिए इस्तेमाल किए गए currencyCode के माइक्रो हैं.

DisburseFundsResultCode

आपको भेजे गए फ़ंड के लिए कॉल के नतीजों के कोड.

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 उपयोगकर्ता के खाते पर रोक लगाई गई है.

RawResult

नतीजे से जुड़ा रॉ ऑब्जेक्ट.

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

string

ज़रूरी नहीं: rawCode का स्कोप खाली हो सकता है.
rawCode

string

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

DisburseFundsResultNotificationResultCode

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

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