Google Play Developer API में, बिलिंग और लिंक प्रोग्राम से जुड़े लेन-देन की रिपोर्ट करने के लिए अतिरिक्त सुविधाएं शामिल हैं. इस गाइड में, इन बिलिंग प्रोग्राम से होने वाले लेन-देन की रिपोर्ट करने का तरीका बताया गया है.
अपने बैकएंड से बाहरी लेन-देन को मैनेज करने के लिए, कुछ कॉम्पोनेंट ज़रूरी हो सकते हैं. इन्हें बनाने के लिए, आपको बैकएंड इंटिग्रेशन सेट अप करना होगा. इसके बारे में Google Play Developer API को कॉन्फ़िगर करना लेख में बताया गया है. डेवलपर के लिए बैकएंड की ऐसी सुविधाएं बनाने के लिए जो बिलिंग और लिंक प्रोग्राम से जुड़ी नहीं हैं, Google Play का बिलिंग सिस्टम देखें.
शब्दावली
इस गाइड में इस्तेमाल किए गए शब्दों के बारे में जानकारी:
- बिलिंग और लिंक प्रोग्राम: ऐसे प्रोग्राम जो Google Play के बाहर डिजिटल कॉन्टेंट की खरीदारी या ऐप्लिकेशन डाउनलोड करने की सुविधा देते हैं. इसमें अन्य बिलिंग सिस्टम और बाहरी कॉन्टेंट से जुड़े प्रोग्राम शामिल हैं.
- External transaction API: ये ऐसे एपीआई होते हैं जिनका इस्तेमाल, ज़रूरी शर्तें पूरी करने वाले बिलिंग और लिंक प्रोग्राम के लिए लेन-देन की जानकारी देने के लिए किया जाता है.
- बाहरी लेन-देन: ज़रूरी शर्तें पूरी करने वाला ऐसा लेन-देन जो ऐप्लिकेशन के बाहर होता है. इसके बारे में अन्य बिलिंग सिस्टम और बाहरी कॉन्टेंट प्रोग्राम में बताया गया है.
- बाहरी लेन-देन का टोकन: यह टोकन, Play Billing Library के ज़रिए उपलब्ध कराया जाता है. इसका इस्तेमाल तब किया जाता है, जब उपयोगकर्ता कोई बाहरी लेन-देन शुरू करता है. इस टोकन का इस्तेमाल, Google Play को बाहरी लेन-देन की सूचना देने के लिए किया जाता है.
- बाहरी लेन-देन आईडी: यह एक यूनीक आइडेंटिफ़ायर होता है, जिसे बाहरी लेन-देन की पहचान करने के लिए जनरेट किया जाता है.
Play Console की अनुमतियां कॉन्फ़िगर करना
बाहरी लेन-देन की जानकारी देने या उन्हें रिफ़ंड करने के लिए, externaltransactions एपीआई को कॉल करें. इसके लिए, Google Play Console में जाकर, अपने सेवा खाते को ऑर्डर और सदस्यताएं मैनेज करें अनुमति दें. यह अनुमति, खाता लेवल पर या कुछ खास ऐप्लिकेशन के लिए दी जा सकती है.
सेवा खाता बनाने और Play Console में अनुमतियां देने के बारे में जानने के लिए, सेवा खाते का इस्तेमाल करना लेख पढ़ें. Play Console की अनुमतियों के बारे में ज़्यादा जानने के लिए, डेवलपर खाते के उपयोगकर्ताओं को जोड़ना और अनुमतियां मैनेज करना लेख पढ़ें.
Google Play को नए बाहरी लेन-देन की जानकारी देना
externaltransactions एपीआई के साथ इंटिग्रेट करें, ताकि जिन देशों में यह सुविधा उपलब्ध है वहां Google Play के बिलिंग सिस्टम के बाहर होने वाले लेन-देन की जानकारी दी जा सके. इसमें, मुफ़्त में आज़माने की सुविधा के तहत की गई खरीदारी और ऐप्लिकेशन इंस्टॉल करने से जुड़े वे लेन-देन भी शामिल हैं जिनमें आपको कोई शुल्क नहीं देना पड़ा. आपको सिर्फ़ उन देशों में बिलिंग और लिंक प्रोग्राम के लिए लेन-देन शुरू करने और उनकी रिपोर्ट भेजने की अनुमति है जहां के उपयोगकर्ता, अन्य बिलिंग सिस्टम और बाहरी कॉन्टेंट वाले प्रोग्राम की ज़रूरी शर्तें पूरी करते हैं. ऐसा न करने पर, एपीआई कॉल को अस्वीकार कर दिया जाएगा. यह सभी लेन-देन पर लागू होता है. इनमें नई खरीदारी, रिन्यूअल, टॉप-अप, अपग्रेड, डाउनग्रेड, और ऐप्लिकेशन डाउनलोड शामिल हैं.
बाहरी लेन-देन की रिपोर्टिंग
बिलिंग और लिंक प्रोग्राम के ज़रिए पेमेंट की अनुमति मिलने के बाद, बाहरी लेन-देन की जानकारी देने के लिए, आपको externaltransactions एपीआई को कॉल करना चाहिए.
यह सभी लेन-देन पर लागू होता है. इनमें शुरुआती शुल्क, रिन्यूअल, रिफ़ंड, और अन्य लेन-देन शामिल हैं. रिपोर्टिंग की ज़रूरी शर्तों के लिए, बिलिंग और लिंक प्रोग्राम से जुड़े दिशा-निर्देश देखें.
हर बाहरी लेन-देन की जानकारी, बाहरी लेन-देन आईडी के साथ दी जाती है. बार-बार होने वाली खरीदारी (जैसे, अपने-आप रिन्यू होने वाली सदस्यताएं) के लिए, आपको बार-बार होने वाली खरीदारी में पहले लेन-देन से जुड़ा बाहरी लेन-देन आईडी भेजना होगा. इसे रिफ़ंड के साथ-साथ, बाद में होने वाले किसी भी लेन-देन के लिए पैरामीटर के तौर पर भेजना होगा. यह उस खरीदारी के लिए लेन-देन की सीरीज़ को रिकॉर्ड करता है. प्रॉडक्ट में बदलाव होने पर, खरीदारी के लिए बाहरी लेन-देन का नया आईडी भेजना चाहिए. जैसे, अपग्रेड या डाउनग्रेड करना. इसके अलावा, अगर बार-बार होने वाला लेन-देन रद्द हो जाता है या उसकी समयसीमा खत्म हो जाती है और वही प्रॉडक्ट बाद में फिर से खरीदा जाता है, तो भी आपको बाहरी लेन-देन का नया आईडी भेजना चाहिए. इस बाहरी लेन-देन आईडी में, व्यक्तिगत पहचान से जुड़ी जानकारी, मालिकाना हक वाली जानकारी या गोपनीय जानकारी शामिल नहीं होनी चाहिए.
शुरुआती लेन-देन की शिकायत करना
बिलिंग और लिंक प्रोग्राम में, जब भी कोई नई खरीदारी या ऐप्लिकेशन डाउनलोड करने की अनुमति दी जाती है, तो आपको externaltransactions एपीआई को कॉल करना होगा.
Google Play Billing Library के ज़रिए ऐप्लिकेशन को मिलने वाला externalTransactionToken, अनुरोध के मुख्य हिस्से में शामिल होना चाहिए. यह ऐप्लिकेशन डाउनलोड करने, वन-टाइम खरीदारी करने, और बार-बार होने वाली खरीदारी (जैसे, सदस्यता) में पहली बार किए जाने वाले लेन-देन के लिए ज़रूरी है. इसे शुरुआती लेन-देन कहा जाता है. शुरुआती लेन-देन के बाद, बाद के लेन-देन (जैसे, सदस्यता रिन्यूअल) की रिपोर्ट करने के लिए, एक नया यूनीक externalTransactionId दें. ज़्यादा जानकारी के लिए, किसी खरीदारी के लिए बाद के लेन-देन की रिपोर्ट करना लेख पढ़ें.
उदाहरण:
- डेवलपर, अपने ऐप्लिकेशन में अन्य बिलिंग सिस्टम को कॉन्फ़िगर और चालू करता है.
- पहला उपयोगकर्ता दक्षिण कोरिया में है. यह उन देशों में शामिल है जहां Google Play की सेवाएं उपलब्ध हैं. वह 12,634.10 कोरियन वॉन प्रति महीने के हिसाब से
product1की सदस्यता खरीदना चाहता है. साथ ही, उसे एक महीने के लिए बिना पैसे चुकाए आज़माने का ऑफ़र भी मिला है. - ऐप्लिकेशन,
product1के लिएProductDetailsऔर उपयोगकर्ता के चुने गए ऑफ़र के साथ खरीदारी का फ़्लो लॉन्च करता है. - उपयोगकर्ता 1, डेवलपर का अन्य बिलिंग सिस्टम चुनता है.
UserChoiceBillingListenerकोexternalTransactionTokenके तौर पर,my_tokenवैल्यू मिलती है.- इसके बाद, डेवलपर ज़रूरी जानकारी को अपने बैकएंड पर भेजता है. इसमें
externalTransactionTokenवैल्यू और खरीदे जा रहे प्रॉडक्ट की जानकारी शामिल होती है. इसके बाद, वे अन्य बिलिंग सिस्टम मेंproduct1के लिए खरीदारी का फ़्लो लॉन्च करते हैं. डेवलपर की ओर से इस लेन-देन को एक यूनीक लेन-देन आईडी असाइन किया जाता है. इसका इस्तेमाल, Google Play को इसकी जानकारी देने के लिए किया जाता है: 123-456-789. लेन-देन आईडी डालना ज़रूरी है. भले ही, उपयोगकर्ता को मुफ़्त में आज़माने की सुविधा मिल रही हो. - अन्य बिलिंग सिस्टम में खरीदारी के लिए लेन-देन होने के बाद, डेवलपर इस अनुरोध के साथ Google Play को लेन-देन की जानकारी देता है. शुरुआत में, इसे शून्य डॉलर के लेन-देन के तौर पर रिपोर्ट किया जाता है, क्योंकि उपयोगकर्ता को एक महीने के लिए मुफ़्त में सदस्यता मिलती है.
POST /androidpublisher/v3/applications/com.myapp.android/externalTransactions?externalTransactionId=123-456-789
Body
{
"originalPreTaxAmount" : {
"priceMicros" : "0",
"currency" : "KRW"
},
"originalTaxAmount" : {
"priceMicros" : "0",
"currency" : "KRW"
},
"transactionTime" : "2022-02-22T12:45:00Z",
"recurringTransaction" : {
"externalTransactionToken" : "my_token",
"externalSubscription" : {
"subscriptionType" : "RECURRING"
}
},
"userTaxAddress" : {
"regionCode" : "KR"
}
}
शुरुआती लेन-देन की जानकारी देते समय, इन बातों का ध्यान रखें:
subscriptionTypeकी वैल्यू,RECURRING(अपने-आप रिन्यू होने वाली सदस्यताओं के लिए) याPREPAID(प्रीपेड सदस्यताओं के लिए) हो सकती है.OtherRecurringProductका इस्तेमाल, एक बार में की जाने वाली ऐसी खरीदारी के लिए किया जाना चाहिए जिसके लिए कई बार पेमेंट करना ज़रूरी हो या पेमेंट बाद में किया जाना हो. उदाहरण के लिए, पहले से ऑर्डर करने पर, हो सकता है कि शुरुआती लेन-देन 0 रुपये का हो. इसके बाद, ऑर्डर पूरा होने पर एसकेयू की कीमत के लिए, बाद की किसी तारीख पर दूसरा लेन-देन किया जाए. बाद के लेन-देन की रिपोर्ट करने के बारे में ज़्यादा जानकारी के लिए, खरीदारी के लिए बाद के लेन-देन की रिपोर्ट करें देखें.- बाहरी ऑफ़र के ज़रिए किए गए शुरुआती लेन-देन की रिपोर्ट करते समय, आपको
ExternalOfferDetailsउपलब्ध कराना होगा. इसके बाद के लेन-देन के लिए, ऐसा करना ज़रूरी नहीं है.
अगर भारत में रहने वाले किसी उपयोगकर्ता के साथ लेन-देन किया जा रहा है, तो टैक्स की दर उसके राज्य या प्रांत के हिसाब से तय होती है. ऐसे में, userTaxAddress में उस राज्य या प्रांत की जानकारी शामिल करें. एपीआई के लिए रेफ़रंस गाइड में, स्ट्रिंग की पहले से तय की गई सूची देखें. इससे आपको पता चलेगा कि किन राज्यों में यह सुविधा उपलब्ध है.
POST /androidpublisher/v3/applications/com.myapp.android/externalTransactions?externalTransactionId=123-456-789
Body
{
"originalPreTaxAmount" : {
"priceMicros" : "0",
"currency" : "INR"
},
"originalTaxAmount" : {
"priceMicros" : "0",
"currency" : "INR"
},
"transactionTime" : "2023-11-01T12:45:00Z",
"recurringTransaction" : {
"externalTransactionToken" : "my_token",
"externalSubscription" : {
"subscriptionType" : "RECURRING"
}
},
"userTaxAddress" : {
# Tax varies in India based on state, so include that information in
# administrativeArea
"regionCode" : "IN",
"administrativeArea" : "KERALA"
}
}
बाहरी ऑफ़र
अगर रिपोर्ट किया जा रहा लेन-देन, ऐप्लिकेशन के बाहर ऑफ़र वगैरह प्रमोट करने के प्रोग्राम के तहत किया गया है, तो आपको externalOfferDetails फ़ील्ड सेट करना होगा. ऐसा तब करना होगा, जब लेन-देन एक बार किया गया हो या बार-बार होने वाले लेन-देन की सीरीज़ का पहला लेन-देन हो:
- ऐप्लिकेशन डाउनलोड करने से जुड़े लेन-देन की रिपोर्टिंग करते समय,
linkTypeकोLINK_TO_APP_DOWNLOADपर सेट करें. साथ ही,installedAppPackageऔरinstalledAppCategoryके लिए सही वैल्यू दें. ज़्यादा जानकारी के लिए, ऐप्लिकेशन डाउनलोड की रिपोर्ट करना लेख पढ़ें. - डिजिटल कॉन्टेंट के ऑफ़र से जुड़े लेन-देन की रिपोर्ट करते समय,
linkTypeकोLINK_TO_DIGITAL_CONTENT_OFFERपर सेट करें. - ऐप्लिकेशन के बाहर ऑफ़र वगैरह प्रमोट करने के प्रोग्राम के ज़रिए कोई तीसरे पक्ष का ऐप्लिकेशन इंस्टॉल करने के बाद, आपको उस तीसरे पक्ष के ऐप्लिकेशन में किए गए लेन-देन की जानकारी देनी होगी. इन लेन-देन की जानकारी देते समय, इन्हें ऐप्लिकेशन डाउनलोड करने के ओरिजनल इवेंट से लिंक करें:
- ऐप्लिकेशन डाउनलोड इवेंट से
externalTransactionTokenदें. externalOfferDetailsफ़ील्ड में,appDownloadEventExternalTransactionIdको ऐप्लिकेशन डाउनलोड इवेंट केexternalTransactionIdपर सेट करें.externalOfferDetailsमें मौजूद अन्य फ़ील्ड ज़रूरी नहीं हैं.
- ऐप्लिकेशन डाउनलोड इवेंट से
बाहरी ऑफ़र के ज़रिए डाउनलोड किए गए किसी तीसरे पक्ष के ऐप्लिकेशन में लेन-देन के लिए अनुरोध का उदाहरण:
POST /androidpublisher/v3/applications/com.myapp.android/externalTransactions?externalTransactionId=ABC-DEF-GHI
Body
{
"originalPreTaxAmount" : {
"priceMicros" : "990000", # 0.99 EUR
"currency" : "EUR"
},
"originalTaxAmount" : {
"priceMicros" : "90000", # 0.09 EUR
"currency" : "EUR"
},
"transactionTime" : "2025-11-22T12:45:00Z",
"oneTimeTransaction" : {
"externalTransactionToken" : "my_external_transaction_token_for_link_to_download_event"
},
"userTaxAddress" : {
"regionCode" : "DE"
},
"externalOfferDetails" : {
"appDownloadEventExternalTransactionId" : "my_external_transaction_id_for_link_to_download_event"
}
}
अलग-अलग तरह के लेन-देन के लिए, Play सेवाओं के सेवा शुल्क की अपडेट की गई जानकारी, यूरोपियन इकनॉमिक एरिया (ईईए) में रहने वाले लोगों के लिए, ऐप्लिकेशन के बाहर ऑफ़र वगैरह प्रमोट करने के प्रोग्राम में हुए बदलाव पेज पर देखी जा सकती है.
किसी खरीदारी के लिए, बाद में किए गए लेन-देन की जानकारी देना
कुछ मामलों में, एक ही बाहरी खरीदारी के लिए उपयोगकर्ता एक से ज़्यादा बार पेमेंट करता है. उदाहरण के लिए, सदस्यता रिन्यूअल या प्रीपेड प्लान के टॉप-अप.
इन लेन-देन की जानकारी, Externaltransactions में उसी एपीआई का इस्तेमाल करके दी जा सकती है. नई खरीदारी की जानकारी दें में बताया गया है कि बाद के लेन-देन के लिए, externalTransactionToken ज़रूरी नहीं है. इसके बजाय, हर रिन्यूअल या टॉप-अप लेन-देन के लिए, क्वेरी पैरामीटर के तौर पर एक नया यूनीक externalTransactionId भेजा जाता है. इसमें, शुरुआती लेन-देन का आईडी initialExternalTransactionId फ़ील्ड में शामिल होता है.
पिछले उदाहरण के मुताबिक:
- उपयोगकर्ता 1 की सदस्यता का पहला रिन्यूअल, अन्य बिलिंग सिस्टम पर होता है. शुरुआती लेन-देन आईडी 123-456-789 था.
- डेवलपर, यूआरएल क्वेरी पैरामीटर में बार-बार होने वाले लेन-देन की जानकारी, इस नए लेन-देन के लिए बाहरी लेन-देन आईडी के तौर पर देता है. साथ ही,
initialExternalTransactionIdफ़ील्ड में शुरुआती लेन-देन के बाहरी लेन-देन आईडी का रेफ़रंस देता है.
अनुरोध का उदाहरण:
POST /androidpublisher/v3/applications/com.myapp.android/externalTransactions?externalTransactionId=abc-def-ghi
Body
{
"originalPreTaxAmount" : {
"priceMicros" : "12634000000", # 12634 KRW
"currency" : "KRW"
},
"originalTaxAmount" : {
"priceMicros" : "1263000000", # 1263 KRW
"currency" : "KRW"
},
"transactionTime" : "2022-02-22T12:45:00Z",
"recurringTransaction" : {
"initialExternalTransactionId" : "123-456-789",
"externalSubscription" : {
"subscriptionType" : "RECURRING"
}
},
"userTaxAddress" : {
"regionCode" : "KR"
}
}
अपग्रेड या डाउनग्रेड की शिकायत करना
अगर उपयोगकर्ता के पास अन्य बिलिंग सिस्टम में सदस्यता है, तो अपग्रेड या डाउनग्रेड की जानकारी देने के लिए, Externaltransactions एपीआई में उसी एंडपॉइंट और फ़ंक्शन का इस्तेमाल करें. साथ ही, वह externalTransactionToken भेजें जो अपग्रेड या डाउनग्रेड लेन-देन के लिए ऐप्लिकेशन को दिया गया था. यह नई खरीदारी की रिपोर्ट करने की तरह ही काम करता है.
ऐप्लिकेशन डाउनलोड करने की शिकायत करना
बाहरी ऑफ़र वाले बिलिंग सिस्टम में ऐप्लिकेशन इंस्टॉल की रिपोर्ट करने के लिए, आपको Externaltransactions.createexternaltransaction को कॉल करना होगा. साथ ही, ऐप्लिकेशन को दिया गया externalTransactionToken भेजना होगा. इसे बिना किसी शुल्क वाले वन-टाइम लेन-देन के तौर पर रिपोर्ट करें. यह प्रोसेस, शुरुआती लेन-देन की रिपोर्ट करने जैसी ही है. अनुरोध के मुख्य हिस्से में ExternalOfferDetails को शामिल करना न भूलें.
अनुरोध का उदाहरण:
POST /androidpublisher/v3/applications/com.myapp.android/externalTransactions?externalTransactionId=123-456-789
Body
{
"originalPreTaxAmount" : {
"priceMicros" : "0",
"currency" : "USD"
},
"originalTaxAmount" : {
"priceMicros" : "0",
"currency" : "USD"
},
"transactionTime" : "2025-12-22T12:45:00Z",
"oneTimeTransaction" : {
"externalTransactionToken" : "my_token",
},
"userTaxAddress" : {
"regionCode" : "US"
},
"externalOfferDetails" : {
"linkType" : "LINK_TO_APP_DOWNLOAD",
"installedAppPackage" : "my.external.app",
"installedAppCategory" : "APP"
}
}
अन्य बिलिंग सिस्टम से किए गए लेन-देन की मैन्युअल रिपोर्टिंग से माइग्रेट करना
अगर रिपोर्ट अपने-आप भेजने की सुविधा के बिना ही अन्य बिलिंग सिस्टम की सुविधा उपलब्ध कराई गई थी, तो चालू सदस्यताओं को माइग्रेट करने के लिए, बिना किसी शुल्क वाला नया लेन-देन बनाएं. इसके लिए, initialExternalTransactionId या externalTransactionToken की जानकारी देने के बजाय, migratedTransactionProgram फ़ील्ड का इस्तेमाल करें. transactionTime को उस समय पर सेट करें जब उपयोगकर्ता ने हर चालू सदस्यता के लिए, शुरुआत में साइन अप किया था. इसके बाद, इन सदस्यताओं के लिए होने वाले हर लेन-देन की जानकारी, एपीआई के ज़रिए सामान्य तरीके से भेजें. साथ ही, वह initialExternalTransactionId दें जिसका इस्तेमाल पहले रिन्यूअल लेन-देन बनाने के लिए किया गया था.
सदस्यता को माइग्रेट करने के बाद, आपको सदस्यता के लिए होने वाले लेन-देन की जानकारी मैन्युअल तरीके से भेजने की ज़रूरत नहीं होगी. हालांकि, इसके लिए ज़रूरी है कि लेन-देन की जानकारी, अपने-आप होने वाले तरीकों से भेजी जा रही हो. इन तरीकों के बारे में इस पेज पर बताया गया है.
सदस्यताओं को माइग्रेट करते समय, कोटा की सीमाओं का ध्यान रखें. इससे यह पक्का किया जा सकेगा कि माइग्रेशन की वजह से कोटा खत्म न हो. अगर कई सदस्यताओं को माइग्रेट करना है, तो उन्हें कुछ दिनों में बांट लें या कोटा बढ़ाने का अनुरोध करें.
migratedTransactionProgram फ़ील्ड का इस्तेमाल सिर्फ़ तब किया जा सकता है, जब मैन्युअल रिपोर्टिंग से माइग्रेट किया जा रहा हो. मैन्युअल रिपोर्टिंग की सुविधा बंद होने पर, इसे भी बंद कर दिया जाएगा.
अनुरोध का उदाहरण:
# Note that the externalTransactionId specified here will used to report
# subsequent transactions.
POST /androidpublisher/v3/applications/com.myapp.android/externalTransactions?externalTransactionId=abc-def-ghi
Body
{
# Be sure to set the price to 0 for this transaction since it does not reflect
# an actual subscription renewal.
"originalPreTaxAmount" : {
"priceMicros" : "0",
"currency" : "KRW"
},
"originalTaxAmount" : {
"priceMicros" : "0",
"currency" : "KRW"
},
# The transaction time should be set to when the user signed up for this
# subscription.
"transactionTime" : "2022-02-22T12:45:00Z",
"recurringTransaction" : {
"migratedTransactionProgram" : "USER_CHOICE_BILLING",
"externalSubscription" : {
"subscriptionType" : "RECURRING"
}
},
"userTaxAddress" : {
"regionCode" : "KR"
}
}
Play के पार्टनर प्रोग्राम के लिए ज़रूरी शर्तें
Play Media Experience Program जैसे पार्टनर प्रोग्राम में हिस्सा लेने वाले डेवलपर को, बाहरी लेन-देन की जानकारी देते समय transaction_program_code देना होगा. अगर आप ज़रूरी शर्तें पूरी करने वाले डेवलपर हैं, तो इस फ़ील्ड को सेट करने के तरीके के बारे में ज़्यादा जानकारी पाने के लिए, अपने बिज़नेस डेवलपमेंट मैनेजर से संपर्क करें.
Google Play पर खरीदारी के रिफ़ंड की शिकायत करना
externaltransactions एपीआई के साथ इंटिग्रेट करें, ताकि Google Play के बिलिंग सिस्टम के बाहर उपयोगकर्ताओं को रिफ़ंड किए गए लेन-देन की जानकारी दी जा सके. Play यह सही तरीके से पहचान सके कि किस लेन-देन को रिफ़ंड किया गया है, इसके लिए आपको यूआरएल पैरामीटर के तौर पर, पहले रिपोर्ट किए गए लेन-देन के लिए उससे जुड़ा externalTransactionId शामिल करना चाहिए.
सदस्यता की खरीदारी के रिफ़ंड की रिपोर्ट करते समय, सदस्यता के उस खास रिकरेंस के externalTransactionId का रेफ़रंस दें जिसे रिफ़ंड किया जा रहा है.
उदाहरण: मान लें कि किसी सदस्यता के लिए ये लेन-देन किए गए हैं:
बाहरी लेन-देन आईडी ABC.1234-5678-9012-34567 के साथ किया गया शुरुआती लेन-देन
बाहरी लेन-देन आईडी ABC.1234-5678-9012-34567..0 के साथ बार-बार होने वाला पहला लेन-देन
बाहरी लेन-देन आईडी ABC.1234-5678-9012-34567..1 के साथ बार-बार होने वाला दूसरा लेन-देन
सदस्यता के सभी लेन-देन के रिफ़ंड की शिकायत करने के लिए, आपको रिफ़ंड के तीन अलग-अलग अनुरोध करने होंगे: एक शुरुआती लेन-देन के लिए और दो बाद के लेन-देन के लिए.
इस तरीके से, पूरा रिफ़ंड (इसमें रिफ़ंड की जाने वाली रकम, बाहरी लेन-देन के दौरान उपयोगकर्ता की ओर से चुकाई गई रकम के बराबर होती है) और कुछ हिस्से का रिफ़ंड (इसमें रिफ़ंड की जाने वाली रकम, बाहरी लेन-देन के दौरान उपयोगकर्ता की ओर से चुकाई गई रकम से कम होती है), दोनों ही तरह के रिफ़ंड किए जा सकते हैं. कुछ हिस्से का रिफ़ंड जारी करने के लिए, आपको टैक्स लगने से पहले की वह रकम बतानी होगी जो रिफ़ंड की गई थी.
एपीआई कोटा
Google Play Developer API के किसी भी अन्य एंडपॉइंट की तरह ही, Externaltransactions एपीआई के सभी कॉल पर एपीआई कोटा लागू होता है.
इसके अलावा, Externaltransactions एपीआई में Externaltransactions.createexternaltransaction या Externaltransactions.refundexternaltransaction को किए जाने वाले कॉल के लिए, हर मिनट 1,200 क्वेरी (क्यूपीएम) की सीमा तय की गई है. Externaltransactions.getexternaltransaction को किए गए कॉल, हर मिनट 1,200 अनुरोधों की इस सीमा में नहीं गिने जाते.