- एचटीटीपी अनुरोध
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- RequestHeader
- वर्शन
- PaymentLookupCriteria
- ArnCriteria
- GoogleTransactionReferenceNumberCriteria
- RequestOriginator
- GetDisputeInquiryReportResultCode
- PurchaseReport
- CustomerAccount
- क्रम
- पता
- आइटम
- टैक्स
- पेमेंट
- रिफ़ंड
- PaymentCardDetails
- AuthResult
पैसे चुकाने के संभावित विवाद के बारे में उपयोगकर्ता के साथ ग्राहक सहायता की बातचीत को आसान बनाने के लिए, जानकारी देने वाली रिपोर्ट पाएं.
अगर अनुरोध को प्रोसेस करते समय एंडपॉइंट किसी गड़बड़ी का सामना करता है, तो इस एंडपॉइंट से मिलने वाला रिस्पॉन्स
टाइप का होगा.ErrorResponse
अगर इस तरीके से कोई एचटीटीपी 200 नहीं मिलती है, तो इस क्वेरी के जवाब खाली हो सकते हैं. रिस्पॉन्स का मुख्य हिस्सा तब खाली होता है, जब साफ़ तौर पर जानकारी देने वाले
का इस्तेमाल किया जा सकता है. इससे किसी हमलावर को यह समझने में मदद मिलती है कि अन्य इंटिग्रेटर के पेमेंट इंटिग्रेटर खाते का आइडेंटिफ़ायर है या नहीं. इन स्थितियों में, जब साइनिंग पासकोड मेल नहीं खाता, पेमेंट इंटिग्रेटर आइडेंटिफ़ायर नहीं मिलता या एन्क्रिप्ट (सुरक्षित) करने वाली कुंजी के बारे में जानकारी नहीं थी, तो यह तरीका खाली बॉडी के साथ एचटीटीपी 404 दिखाएगा. अगर अनुरोध पर किए गए हस्ताक्षर की पुष्टि हो पाती है, तो गड़बड़ी के बारे में ज़्यादा जानकारी जवाब के मुख्य हिस्से में दिखेगी.ErrorResponse
अनुरोध का एक उदाहरण ऐसा दिखता है:
{
"requestHeader": {
"protocolVersion": {
"major": 1,
"minor": 1,
"revision": 0
},
"requestId": "HsKv5pvtQKTtz7rdcw1YqE",
"requestTimestamp": "1519996751331"
},
"paymentIntegratorAccountId": "InvisiCashUSA",
"paymentLookupCriteria": {
"googleTransactionReferenceNumberCriteria": {
"googleTransactionReferenceNumber": "714545417102363157911822",
"authorizationCode": "111111"
}
},
"existingGoogleClaimId": "138431383281",
"requestOriginator": {
"organizationId": "ISSUER_256",
"organizationDescription": "Community Bank of Some City",
"agentId": "982749"
}
}
जवाब का एक उदाहरण ऐसा दिखता है:
{
"responseHeader": {
"responseTimestamp": "1519996752221"
},
"result": "SUCCESS",
"googleClaimId": "138431383281",
"report": {
"customerAccount": {
"customerEmail": "example@gmail.com",
"customerName" : "Example Customer"
},
"order": {
"timestamp": "1517992525972",
"orderId": "SOP.8976-1234-1234-123456..99",
"currencyCode": "USD",
"subTotalAmount": "206990000",
"totalAmount": "212990000",
"shippingAddress": {
"name": "Example Customer",
"addressLine": ["123 Main St"],
"localityName": "Springfield",
"administrativeAreaName": "CO",
"postalCodeNumber": "80309",
"countryCode": "US"
},
"taxes": [
{
"description": "Colorado Sales Tax",
"amount": "6000000"
}
],
"items": [
{
"description": "Super cool gizmo",
"merchant": "HTC",
"googleProductName": "Google Store",
"quantity": "2",
"totalPrice": "198000000"
},
{
"description": "Gizmo charger",
"merchant": "HTC",
"googleProductName": "Google Store",
"quantity": "1",
"totalPrice": "8990000"
}
]
},
"payment": {
"billingAddress" : {
"name": "Example Customer",
"addressLine": ["123 Main St"],
"localityName": "Springfield",
"administrativeAreaName": "CO",
"postalCodeNumber": "80309",
"countryCode": "US"
},
"amount": "100000000",
"refunds": [
{
"amount": "9250000",
"initiatedTimestamp": "1518811245384"
}
],
"cardDetails": {
"authResult": "APPROVED"
}
}
}
}
एचटीटीपी अनुरोध
POST https://vgw.googleapis.com/secure-serving/gsp/v1/getDisputeInquiryReport/:PIAID
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में इस तरह का डेटा शामिल होता है:
जेएसओएन के काेड में दिखाना |
---|
{ "requestHeader": { object ( |
फ़ील्ड | |
---|---|
requestHeader |
ज़रूरी: सभी अनुरोधों के लिए सामान्य हेडर. |
paymentIntegratorAccountId |
ज़रूरी: पेमेंट इंटिग्रेटर खाता आइडेंटिफ़ायर, जो कॉलर और इस इंटरैक्शन के लिए समझौते से जुड़ी पाबंदियों की पहचान करता है. |
paymentLookupCriteria |
ज़रूरी: इस पूछताछ के लिए किस पेमेंट की जानकारी चाहिए, यह दिखाने वाला मानदंड. |
existingGoogleClaimId |
ज़रूरी नहीं: Google की जनरेट की गई स्ट्रिंग, जिसे अगर यह मौजूद नहीं है, तो एक नया दावा आईडी जनरेट किया जाएगा. कॉल करने वाला (कॉलर) यहां भरे गए या जनरेट किए गए दावे के आईडी को, जवाब के
|
requestOriginator |
ज़रूरी: यह अनुरोध करने वाले संगठन या संगठन के सब-ग्रुप की जानकारी. |
जवाब का मुख्य भाग
getDisputeInquiryReport
तरीके के लिए रिस्पॉन्स पेलोड.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
जेएसओएन के काेड में दिखाना |
---|
{ "responseHeader": { object ( |
फ़ील्ड | |
---|---|
responseHeader |
ज़रूरी: सभी जवाबों के लिए सामान्य हेडर. |
result |
ज़रूरी: इस कॉल का नतीजा. |
googleClaimId |
ज़रूरी नहीं: Google की जनरेट की गई स्ट्रिंग, जो ग्राहक से जुड़े इस विवाद को अलग पहचान देती है. (यह तब ही दिखता है, जब अगर अनुरोध में |
report |
ज़रूरी नहीं: अनुरोध में बताए गए पेमेंट के विवाद से जुड़ी ज़रूरी जानकारी. (यह तब ही दिखता है, जब |
RequestHeader
हेडर ऑब्जेक्ट, जो सर्वर को भेजे गए सभी अनुरोधों पर तय होता है.
जेएसओएन के काेड में दिखाना |
---|
{
"requestId": string,
"requestTimestamp": string,
"userLocale": string,
"protocolVersion": {
object ( |
फ़ील्ड | |
---|---|
requestId |
ज़रूरी है: इस अनुरोध का यूनीक आइडेंटिफ़ायर. यह स्ट्रिंग ज़्यादा से ज़्यादा 100 वर्णों की होती है. साथ ही, इसमें सिर्फ़ "a-z", "A-Z", "0-9", -->, "-", और "_" वर्ण शामिल हैं. |
requestTimestamp |
ज़रूरी है: इस अनुरोध का टाइमस्टैंप, epoch के बाद के मिलीसेकंड के तौर पर दिखाया जाता है. रिसीवर को यह पुष्टि करनी चाहिए कि यह टाइमस्टैंप 'अभी' के ± 60 सेकंड का है. बार-बार कोशिश करने पर, अनुरोध के इस टाइमस्टैंप का पता नहीं चलता. |
userLocale |
रोक दिया गया: दो या तीन अक्षर का ISO 639-2 Alpha 3 भाषा कोड. इसके बाद हाइफ़न और ISO 3166-1 Alpha-2 देश का कोड डालें, उदाहरण के लिए, 'pt', 'pt-BR', 'fil' या 'fil-PH'. जवाब में, |
protocolVersion |
ज़रूरी: इस अनुरोध का वर्शन. |
वर्शन
वर्शन ऑब्जेक्ट, जो a.b.c
के क्लासिक वर्शन के स्ट्रक्चर का स्ट्रक्चर है. इस बात की गारंटी है कि एक ही नंबर वाले मुख्य वर्शन, सभी के साथ काम करेंगे. ध्यान दें कि मामूली और बदलाव, बिना किसी सूचना के बार-बार बदल सकते हैं. इंटिग्रेटर को एक ही मेजर वर्शन के सभी अनुरोधों के साथ काम करना चाहिए.
जेएसओएन के काेड में दिखाना |
---|
{ "major": integer, "minor": integer, "revision": integer } |
फ़ील्ड | |
---|---|
major |
ज़रूरी: मेजर वर्शन. इसे अलग-अलग वर्शन के साथ कम्पैटबिलटी रिक्वेस्ट के लिए मार्क किया जाता है. इसकी कोई गारंटी नहीं है कि इसके साथ काम करने की सुविधा मिलेगी. |
minor |
ज़रूरी: माइनर वर्शन. यह अहम गड़बड़ियां ठीक करता है. |
revision |
ज़रूरी: माइनर वर्शन. यह छोटी गड़बड़ियों को ठीक करने के बारे में बताता है. |
PaymentLookupCriteria
शर्तों के हिसाब से कंटेनर, जो किसी पेमेंट को खास तरीके से देख सकता है. सदस्य के एक (और सिर्फ़ एक) फ़ील्ड में जानकारी भरी जानी चाहिए.
जेएसओएन के काेड में दिखाना |
---|
{ // Union field |
फ़ील्ड | |
---|---|
यूनियन फ़ील्ड
|
|
arnCriteria |
ज़रूरी नहीं: ऐक्वायरर रेफ़रंस नंबर (एआरएन) के आधार पर लुकअप. |
googleTransactionReferenceNumberCriteria |
ज़रूरी नहीं: Google लेन-देन रेफ़रंस नंबर के आधार पर लुकअप. |
ArnCriteria
ऐक्क्वायरर रेफ़रंस नंबर (एआरएन) पर आधारित पेमेंट लुकअप.
जेएसओएन के काेड में दिखाना |
---|
{ "acquirerReferenceNumber": string, "authorizationCode": string } |
फ़ील्ड | |
---|---|
acquirerReferenceNumber |
ज़रूरी: एक्क्वायरर रेफ़रंस नंबर (ARN) जिससे पेमेंट की खास पहचान होती है. कोड में 23 अंक होने चाहिए. |
authorizationCode |
ज़रूरी: लेन-देन के लिए अनुमति कोड. |
GoogleTransactionReferenceNumberCriteria
Google के जनरेट किए गए ट्रांज़ैक्शन रेफ़रंस नंबर पर आधारित पेमेंट लुकअप.
जेएसओएन के काेड में दिखाना |
---|
{ "googleTransactionReferenceNumber": string, "authorizationCode": string } |
फ़ील्ड | |
---|---|
googleTransactionReferenceNumber |
ज़रूरी: Google का जनरेट किया गया ट्रांज़ैक्शन रेफ़रंस नंबर, जिससे पेमेंट की खास पहचान होती है. |
authorizationCode |
ज़रूरी: लेन-देन के लिए अनुमति कोड. |
RequestOriginator
यह अनुरोध करने वाले संगठन या संगठन के सब-ग्रुप की जानकारी और वैकल्पिक तौर पर उस कर्मचारी की जानकारी जिससे यह अनुरोध किया गया है. इससे Google, समस्याओं या बुरे बर्ताव का पता लगा पाता है. साथ ही, paymentIntegratorAccountId
के मुकाबले बेहतर तरीके से कंट्रोल लागू कर पाता है. यह खास तौर पर तब अहम होता है, जब कॉलर एक मध्यस्थ सेवा देने वाला होता है जो कई बाहरी क्लाइंट से अनुरोध लेता है.
जेएसओएन के काेड में दिखाना |
---|
{ "organizationId": string, "organizationDescription": string, "agentId": string } |
फ़ील्ड | |
---|---|
organizationId |
ज़रूरी: उस कंपनी, संगठन या संगठन के ग्रुप का आइडेंटिफ़ायर जिससे यह अनुरोध किया गया है. इस |
organizationDescription |
ज़रूरी है: संगठन का ऐसा नाम या ब्यौरा जिसे कोई भी व्यक्ति आसानी से पढ़ सके. इसका इस्तेमाल, Google के कर्मचारियों और उस संगठन के इंटिग्रेटर के बीच कम्यूनिकेशन को आसान बनाने के लिए किया जा सकता है. |
agentId |
ज़रूरी नहीं: संगठन के उस खास एजेंट (कर्मचारी) के लिए यूनीक आइडेंटिफ़ायर जिसकी पहचान |
GetDisputeInquiryReportResultCode
getDisputeInquiryReport
मेथड कॉल का नतीजा.
Enums | |
---|---|
UNKNOWN_RESULT |
कभी भी यह डिफ़ॉल्ट वैल्यू सेट न करें! |
SUCCESS |
पेमेंट की जानकारी मिल गई है और शिकायत भी दे दी गई है. |
PAYMENT_NOT_FOUND |
जिस पेमेंट का अनुरोध किया गया था वह नहीं मिला. |
PAYMENT_TOO_OLD |
अनुरोध किया गया पेमेंट मिल गया है, लेकिन पेमेंट करने की उम्र की वजह से रिपोर्ट नहीं दी गई है. |
ORDER_CANNOT_BE_RETURNED |
अनुरोध किया गया पेमेंट किसी ऐसे ऑर्डर का है जो मौजूद है, लेकिन उसे वापस नहीं किया जा सकता. इसकी वजहों में, वे मामले शामिल होते हैं जिनमें मालिक के अनुरोध पर ऑर्डर हटा दिया गया था. |
NO_ADDITIONAL_DETAILS |
अनुरोध किया गया पेमेंट मिल गया है, लेकिन रिपोर्ट नहीं है. |
PurchaseReport
एक रिपोर्ट जिसमें अनुरोध किए गए पेमेंट से जुड़ी खरीदारी की ज़रूरी जानकारी शामिल होती है.
जेएसओएन के काेड में दिखाना |
---|
{ "customerAccount": { object ( |
फ़ील्ड | |
---|---|
customerAccount |
ज़रूरी है: ग्राहक और उसके खाते के बारे में जानकारी. |
order |
ज़रूरी: उस ऑर्डर की जानकारी जिसके लिए पेमेंट किया गया था. |
payment |
ज़रूरी नहीं: पेमेंट के बारे में जानकारी. ध्यान दें: एक ही ऑर्डर के लिए एक से ज़्यादा पेमेंट किए जा सकते हैं. हालांकि, इसमें सिर्फ़ उस पेमेंट की जानकारी शामिल होगी जिसके बारे में मूल अनुरोध में बताया गया था. यह सुविधा, सभी तरह के ऑर्डर के लिए उपलब्ध नहीं है. |
CustomerAccount
ग्राहक के खाते की जानकारी
जेएसओएन के काेड में दिखाना |
---|
{ "customerEmail": string, "customerName": string } |
फ़ील्ड | |
---|---|
customerEmail |
ज़रूरी है: ग्राहक के Google खाते से जुड़ा ईमेल पता. |
customerName |
ज़रूरी: ग्राहक का नाम. |
ऑर्डर
ऑर्डर के बारे में जानकारी.
जेएसओएन के काेड में दिखाना |
---|
{ "timestamp": string, "orderId": string, "currencyCode": string, "subTotalAmount": string, "totalAmount": string, "shippingAddress": { object ( |
फ़ील्ड | |
---|---|
timestamp |
ज़रूरी नहीं: ऑर्डर कब दिया गया था उसका टाइमस्टैंप, epoch के बाद के मिलीसेकंड के तौर पर दिखाया जाता है. यह सुविधा, सभी तरह के ऑर्डर के लिए उपलब्ध नहीं है. |
orderId |
ज़रूरी नहीं: इस ऑर्डर की खास तौर पर पहचान करने वाली स्ट्रिंग. यह सुविधा, सभी तरह के ऑर्डर के लिए उपलब्ध नहीं है. |
currencyCode |
ज़रूरी नहीं: इस ऑर्डर की सभी रकम के लिए, ISO 4217 का तीन अक्षर वाला मुद्रा कोड. यह सुविधा, सभी तरह के ऑर्डर के लिए उपलब्ध नहीं है. |
subTotalAmount |
ज़रूरी नहीं: टैक्स से पहले इस ऑर्डर की कुल रकम, जिसे |
totalAmount |
ज़रूरी नहीं: टैक्स के साथ इस ऑर्डर की कुल रकम, जिसे |
shippingAddress |
ज़रूरी नहीं: इस ऑर्डर में मौजूद सामान की शिपिंग का पता. |
items[] |
ज़रूरी: उन आइटम की सूची जो इस ऑर्डर में शामिल थे. |
taxes[] |
ज़रूरी: उन आइटम की सूची जो इस ऑर्डर में शामिल थे. यह सूची खाली हो सकती है. |
पता
स्ट्रक्चर में किसी पते की जानकारी होती है.
जेएसओएन के काेड में दिखाना |
---|
{ "name": string, "addressLine": [ string ], "localityName": string, "administrativeAreaName": string, "postalCodeNumber": string, "countryCode": string } |
फ़ील्ड | |
---|---|
name |
ज़रूरी नहीं: ग्राहक का पूरा नाम. |
addressLine[] |
ज़रूरी नहीं: इसमें पते का ऐसा टेक्स्ट होता है जिसे स्ट्रक्चर नहीं किया गया होता. |
localityName |
ज़रूरी नहीं: यह अस्पष्ट शब्द है, लेकिन आम तौर पर इसका मतलब किसी पते के शहर/कस्बे वाले हिस्से से होता है. दुनिया के उन इलाकों में जहां इलाके तय नहीं हैं या इस स्ट्रक्चर में सही से फ़िट नहीं होते (उदाहरण के लिए, जापान और चीन), localityName खाली छोड़ें और addressLine का इस्तेमाल करें. उदाहरण: अमेरिका का शहर, आईटी कम्यून, यूके पोस्ट टाउन. |
administrativeAreaName |
ज़रूरी नहीं: इस देश का टॉप लेवल प्रशासनिक उपविभाग" उदाहरण: अमेरिका का राज्य, आईटी क्षेत्र, सीएन प्रांत, जेपी प्रांत." |
postalCodeNumber |
ज़रूरी नहीं: नाम होने के बावजूद, postalCodeNumber की वैल्यू अक्सर अक्षर और अंक होती हैं. जैसे: "94043", "SW1W", "SW1W 9TQ". |
countryCode |
ज़रूरी नहीं: ग्राहक के पते का देश कोड, ISO-3166-1 Alpha-2 होना चाहिए. |
आइटम
ऑर्डर में मौजूद किसी आइटम की जानकारी.
जेएसओएन के काेड में दिखाना |
---|
{ "description": string, "merchant": string, "quantity": string, "totalPrice": string, "googleProductName": string } |
फ़ील्ड | |
---|---|
description |
ज़रूरी नहीं: खरीदे गए आइटम की जानकारी. यह सुविधा, सभी तरह के ऑर्डर के लिए उपलब्ध नहीं है. |
merchant |
ज़रूरी है: आइटम बेचने वाला, कलाकार या निर्माता. |
quantity |
ज़रूरी नहीं: ऑर्डर की गई इस आइटम की संख्या. अगर प्रॉडक्ट के लिए पूर्णांकों की संख्या लागू नहीं होती है, तो इस फ़ील्ड को छोड़ दिया जाएगा. उदाहरण के लिए, मीटर वाले प्रॉडक्ट में दशमलव वाली संख्या हो सकती है. |
totalPrice |
ज़रूरी नहीं: इस आइटम की कुल कीमत, जिसे |
googleProductName |
ज़रूरी: आइटम के लिए Google प्रॉडक्ट सेवा का नाम. |
टैक्स
इस ऑर्डर पर लागू होने वाले टैक्स की जानकारी.
जेएसओएन के काेड में दिखाना |
---|
{ "description": string, "amount": string } |
फ़ील्ड | |
---|---|
description |
ज़रूरी: टैक्स का ब्यौरा. |
amount |
ज़रूरी है: टैक्स की रकम, जो |
पेमेंट
पेमेंट के बारे में जानकारी.
जेएसओएन के काेड में दिखाना |
---|
{ "billingAddress": { object ( |
फ़ील्ड | |
---|---|
billingAddress |
ज़रूरी: इस पेमेंट के लिए बिलिंग पता. |
amount |
ज़रूरी है: इस पेमेंट की रकम, |
refunds[] |
ज़रूरी: इस पेमेंट के लिए किए गए रिफ़ंड की सूची. यह सूची खाली हो सकती है. |
यूनियन फ़ील्ड
|
|
cardDetails |
ज़रूरी नहीं: क्रेडिट और डेबिट कार्ड के एफ़ओपी से जुड़े पेमेंट की जानकारी. |
रिफ़ंड
पैसे चुकाने पर किए गए रिफ़ंड की जानकारी.
जेएसओएन के काेड में दिखाना |
---|
{ "amount": string, "initiatedTimestamp": string } |
फ़ील्ड | |
---|---|
amount |
ज़रूरी है: रिफ़ंड की गई रकम, |
initiatedTimestamp |
ज़रूरी है: रिफ़ंड कब शुरू किया गया था, इसका टाइमस्टैंप, epoch के बाद के मिलीसेकंड के तौर पर दिखाया जाता है. |
PaymentCardDetails
क्रेडिट और डेबिट कार्ड से जुड़ी पेमेंट की जानकारी.
जेएसओएन के काेड में दिखाना |
---|
{
"authResult": enum ( |
फ़ील्ड | |
---|---|
authResult |
ज़रूरी: पेमेंट की पुष्टि का नतीजा. |
AuthResult
पेमेंट की पुष्टि के नतीजे.
Enums | |
---|---|
UNKNOWN_RESULT |
कभी भी यह डिफ़ॉल्ट वैल्यू सेट न करें! |
APPROVED |
अनुमति दी गई. |
DENIED |
अनुमति नहीं दी गई. |
NOT_ATTEMPTED |
अनुमति देने की कोशिश नहीं की गई. |