Method: acceptRemittanceStatementWithModifications

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

अगर इस तरीके से कोई एचटीटीपी 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.acceptRemittanceStatement कॉल का नतीजा.

FeeToVATModification

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

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

string (Int64Value format)

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

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

  • पेमेंट इंटिग्रेटर से इकट्ठा किया जाने वाला टैक्स शामिल है, जिसमें टैक्स शामिल है: 1,00,000 रुपये
  • टैक्स की दर: 10%
  • इस तरह, 1,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 अमान्य अनुरोध की वजह से वैट में बदलाव को स्वीकार नहीं किया गया.