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

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

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

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

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

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

object (ResponseHeader)

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

enum (AcceptRemittanceStatementWithModificationsResultCode)

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

FeeToVATModification

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

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

string (Int64Value format)

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

टैक्स का हिसाब लगाने के लिए सैंपल देखें:

  • पेमेंट इंटिग्रेटर की ओर से लिया गया, टैक्स के साथ प्रोसेसिंग फ़ीस: 1,000 डॉलर
  • टैक्स की दर: 10%
  • इस तरह, 1,00,000 रुपये = (प्रोसेसिंग फ़ीस) + (10% * प्रोसेसिंग फ़ीस)
  • प्रोसेसिंग फ़ीस (सैन टैक्स) = 1,000 / 1.1 = 909.090909 डॉलर
  • पेमेंट इंटिग्रेटर की मदद से चुकाया गया टैक्स = 1000 - 909.090909 = 90.909091 डॉलर
  • vatToFeeRatioInMicros = (90.909091 / 1000) * 1000000 = 90909.091
  • 90909.091 = 90909 पर अर्ध-सम पूर्णांक

AcceptRemittanceStatementWithModificationsResultCode

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