Method: acceptRemittanceStatementWithModifications

Google को बताता है कि अनुरोध में बताए गए स्टेटमेंट का भुगतान स्टेटमेंट में बदलाव किए जाने के बाद किया जाएगा, जैसे कि वैट फिर से अलग-अलग करने की फ़ीस.

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

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

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


{
  "requestHeader": {
    "protocolVersion": {
      "major": 1,
      "minor": 0,
      "revision": 0
    },
    "requestId": "0123434-abc",
    "requestTimestamp": "1502545413098"
  },
  "paymentIntegratorAccountId": "InvisiCashUSA_USD",
  "statementId": "0123434-statement-abc",
  "feeToVatModification": {
    "vatToFeeRatioInMicros": "150000"
  }
}

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


{
  "responseHeader": {
    "responseTimestamp": "1519996752221"
  },
  "acceptRemittanceStatementWithModificationsResultCode": "SUCCESS"
}

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

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

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

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

जेएसओएन के काेड में दिखाना 
{
  "requestHeader": {
    object (RequestHeader)
  },
  "paymentIntegratorAccountId": string,
  "statementId": string,

  // Union field modification_type can be only one of the following:
  "feeToVatModification": {
    object (FeeToVATModification)
  }
  // End of list of possible types for union field modification_type.
}
फ़ील्ड
requestHeader

object (RequestHeader)

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

string

ज़रूरी है: यह 'पेमेंट इंटिग्रेटर खाता आइडेंटिफ़ायर' है, जो इस स्टेटमेंट के लिए, समझौते की शर्तों की पहचान करता है.
statementId

string

ज़रूरी है: स्टेटमेंट की सूचना का अनुरोध आईडी, जो इस अनुरोध में बदलाव करता है.

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

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

object (FeeToVATModification)

ज़रूरी है: वैल्यू ऐडेड टैक्स (वैट) के हिस्से को फिर से एट्रिब्यूट करने के लिए, बदलाव का अनुरोध किया गया.

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

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

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

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

object (ResponseHeader)

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

enum (AcceptRemittanceStatementWithModificationsResultCode)

ज़रूरी: v1.allowRemittanceStatement कॉल का नतीजा.

फ़ी (वैट) में बदलाव

यह ऑब्जेक्ट, भेजे गए पैसों पर टैक्स में बदलाव करने की सुविधा देता है.

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

string (Int64Value format)

ज़रूरी है: माइक्रो में वैट की रकम का अनुपात. यह प्रतिशत, वैट को फिर से एट्रिब्यूट करने के लिए प्रतिशत है. यह शून्य से ज़्यादा या उसके बराबर होना चाहिए. यह दशमलव वाली संख्या को "आधे सम" या "बैंकर" की तरह होना चाहिए.अगर पूर्णांक दोनों बराबर हों, तो इन्हें पूर्णांक में बदल दें. उदाहरण के लिए, 2.5 -> 2, 5.5 -> 6.

टैक्स का हिसाब लगाने का तरीका यहां बताया गया है:

  • पेमेंट इंटिग्रेटर से लिया जाने वाला टैक्स (टैक्स के साथ) शुल्क: 1,000 डॉलर
  • टैक्स की दर: 10%
  • इसलिए, 1000 USD = (प्रोसेसिंग शुल्क) + (10% * प्रोसेसिंग शुल्क)
  • प्रोसेसिंग फ़ीस (सेंस टैक्स) = 1000 / 1.1 = 909.090909 डॉलर
  • पेमेंट इंटिग्रेटर = 1000 - 909.090909 = 90.909091 डॉलर का टैक्स
  • vatToFeeRatioInMicros = (90.909091 / 1000) * 1000000 = 90909.091
  • 90909.091 = 90909 पर हाफ़-ईवन राउंडिंग

स्वीकार करेंRemittanceStatementWithmodizationsResultCode

Enums
UNKNOWN_RESULT इस डिफ़ॉल्ट वैल्यू को कभी सेट न करें!
SUCCESS भेजे गए पैसे की जानकारी, बदलावों के साथ स्वीकार कर ली गई है.
INVALID_VAT_MODIFICATION अमान्य अनुरोध की वजह से वैट में बदलाव को स्वीकार नहीं किया गया.