Google Play Billing के बाहर कमाई करने की सुविधा के लिए, बैकएंड इंटिग्रेशन के दिशा-निर्देश

Google Play Developer API में, बिलिंग और लिंक प्रोग्राम से जुड़े लेन-देन की रिपोर्ट करने के लिए, अतिरिक्त फ़ंक्शन शामिल हैं. इस गाइड में, इन बिलिंग प्रोग्राम से जुड़े लेन-देन की रिपोर्ट करने का तरीका बताया गया है.

बैकएंड से, बाहरी लेन-देन को मैनेज करने के लिए, कुछ कॉम्पोनेंट की ज़रूरत पड़ सकती है. इन्हें बनाने के लिए, आपको Google Play Developer API को कॉन्फ़िगर करना में बताए गए तरीके से, बैकएंड इंटिग्रेशन सेट अप करना होगा. अगर आपको डेवलपर के बैकएंड के ऐसे फ़ंक्शन बनाने हैं जो बिलिंग और लिंक प्रोग्राम के लिए खास नहीं हैं, तो Google Play's billing system लेख देखें.

शब्दावली

इस गाइड में इस्तेमाल किए गए शब्दों के मतलब:

• बिलिंग और लिंक प्रोग्राम: ये ऐसे प्रोग्राम हैं जिनकी मदद से, Google Play के बाहर डिजिटल कॉन्टेंट खरीदा जा सकता है या ऐप्लिकेशन डाउनलोड किए जा सकते हैं. इनमें, अन्य बिलिंग सिस्टम और बाहरी कॉन्टेंट वाले प्रोग्राम शामिल हैं.
• बाहरी लेन-देन के एपीआई: इनका इस्तेमाल, ज़रूरी शर्तें पूरी करने वाले बिलिंग और लिंक प्रोग्राम से जुड़े लेन-देन की रिपोर्ट करने के लिए किया जाता है.
• बाहरी लेन-देन: यह ज़रूरी शर्तें पूरी करने वाला ऐसा लेन-देन है जो ऐप्लिकेशन के बाहर होता है. इसकी जानकारी, अन्य बिलिंग सिस्टम और बाहरी कॉन्टेंट वाले प्रोग्राम में दी गई है.
• बाहरी लेन-देन का टोकन: यह टोकन, Play Billing Library के ज़रिए उपलब्ध कराया जाता है. इसका इस्तेमाल तब किया जाता है, जब उपयोगकर्ता कोई बाहरी लेन-देन शुरू करता है. इस टोकन का इस्तेमाल, अनुमति वाले बाहरी लेन-देन के बारे में Google Play को सूचना देने के लिए किया जाता है.
• बाहरी लेन-देन आईडी: यह एक यूनीक आइडेंटिफ़ायर है, जिसे बाहरी लेन-देन की पहचान करने के लिए जनरेट किया जाता है.

Google Play को नए बाहरी लेन-देन की रिपोर्ट करना

समर्थित देशों में, Google Play के बिलिंग सिस्टम के बाहर होने वाले लेन-देन की रिपोर्ट करने के लिए, externaltransactions API को इंटिग्रेट करें. इसमें, मुफ़्त में आज़माने की सुविधा के तहत की गई खरीदारी और ऐप्लिकेशन इंस्टॉल करने से जुड़े वे लेन-देन शामिल हैं जिनमें आपको कोई शुल्क नहीं देना पड़ा. आपको सिर्फ़ ज़रूरी शर्तें पूरी करने वाले देशों में रहने वाले उपयोगकर्ताओं के लिए, बिलिंग और लिंक प्रोग्राम से जुड़े लेन-देन की रिपोर्ट करनी चाहिए. ऐसा अन्य बिलिंग सिस्टम और बाहरी कॉन्टेंट वाले प्रोग्राम के तहत ही किया जा सकता है. ऐसा न करने पर, एपीआई कॉल को अस्वीकार कर दिया जाता है. यह सभी लेन-देन पर लागू होता है. जैसे, नई खरीदारी करना, सदस्यता रिन्यू करना, टॉप-अप करना, अपग्रेड करना, डाउनग्रेड करना, और ऐप्लिकेशन डाउनलोड करना.

बाहरी लेन-देन की रिपोर्ट करना

बिलिंग और लिंक प्रोग्राम के ज़रिए पेमेंट की अनुमति मिलने के बाद, आपको externaltransactions API को कॉल करके, बाहरी लेन-देन की रिपोर्ट करनी चाहिए. यह सभी लेन-देन पर लागू होता है. जैसे, शुरुआती शुल्क, सदस्यता रिन्यू करना, रिफ़ंड, और अन्य. रिपोर्ट करने की ज़रूरी शर्तों के लिए, बिलिंग और लिंक प्रोग्राम से जुड़ी गाइडलाइन देखें.

हर बाहरी लेन-देन की रिपोर्ट, बाहरी लेन-देन आईडी के साथ की जाती है. बार-बार की जाने वाली खरीदारी (जैसे, अपने-आप रिन्यू होने वाली सदस्यताएं) के लिए, आपको बार-बार की जाने वाली खरीदारी के पहले लेन-देन से जुड़ा बाहरी लेन-देन आईडी, बाद के सभी लेन-देन के लिए पैरामीटर के तौर पर भेजना होगा. इसमें रिफ़ंड भी शामिल हैं. इससे, उस खरीदारी के लिए लेन-देन की सीरीज़ रिकॉर्ड हो जाती है. प्रॉडक्ट में बदलाव होने पर (जैसे, अपग्रेड या डाउनग्रेड), आपको खरीदारी के लिए नया बाहरी लेन-देन आईडी भेजना चाहिए. इसके अलावा, अगर बार-बार की जाने वाली सदस्यता रद्द हो जाती है या उसकी अवधि खत्म हो जाती है और बाद में उसी प्रॉडक्ट को फिर से खरीदा जाता है, तब भी आपको नया बाहरी लेन-देन आईडी भेजना चाहिए. आपको इस बाहरी लेन-देन आईडी में, निजी जानकारी, मालिकाना हक वाली जानकारी या गोपनीय जानकारी शामिल नहीं करनी चाहिए.

शुरुआती लेन-देन की रिपोर्ट करना

बिलिंग और लिंक प्रोग्राम में, हर बार नई खरीदारी या ऐप्लिकेशन डाउनलोड करने की अनुमति मिलने पर, आपको externaltransactions API को कॉल करना होगा.

ऐप्लिकेशन डाउनलोड करने, एक बार की जाने वाली खरीदारी, और बार-बार की जाने वाली खरीदारी (जैसे, सदस्यता) में पहली बार किए जाने वाले लेन-देन के लिए, अनुरोध के मुख्य हिस्से में, Google Play Billing Library के ज़रिए ऐप्लिकेशन को मिला externalTransactionToken शामिल करना ज़रूरी है. इसे शुरुआती लेन-देन कहा जाता है. शुरुआती लेन-देन के बाद, बाद के लेन-देन (जैसे, सदस्यता रिन्यू करना) की रिपोर्ट करने के लिए, एक नया यूनीक externalTransactionId उपलब्ध कराएं. ज़्यादा जानकारी के लिए, खरीदारी के बाद के लेन-देन की रिपोर्ट करना लेख देखें.

उदाहरण:

1. कोई डेवलपर, अपने ऐप्लिकेशन में अन्य बिलिंग सिस्टम को कॉन्फ़िगर और चालू करता है.
2. उपयोगकर्ता 1, दक्षिण कोरिया में है. यह एक ऐसा देश है जहां अन्य बिलिंग सिस्टम की सुविधा उपलब्ध है. वह हर महीने 12634.10KRW में product1 खरीदने की कोशिश कर रहा है. इसके साथ, उसे एक महीने के लिए बिना पैसे चुकाए आज़माने का ऑफ़र भी मिल रहा है.
3. ऐप्लिकेशन, product1 के लिए ProductDetails और उपयोगकर्ता ने जो ऑफ़र चुना है उसके साथ, खरीदारी का फ़्लो लॉन्च करता है.
4. उपयोगकर्ता 1, डेवलपर के अन्य बिलिंग सिस्टम को चुनता है.
5. UserChoiceBillingListener को externalTransactionToken के तौर पर, my_token वैल्यू मिलती है.
6. इसके बाद, डेवलपर अपने बैकएंड को ज़रूरी जानकारी भेजता है. जैसे, externalTransactionToken की वैल्यू और खरीदे जा रहे प्रॉडक्ट. फिर, वे अन्य बिलिंग सिस्टम में product1 के लिए, खरीदारी का फ़्लो लॉन्च करते हैं. इस लेन-देन को डेवलपर की ओर से एक यूनीक लेन-देन आईडी असाइन किया जाता है. इसका इस्तेमाल, Google Play को इसकी रिपोर्ट करने के लिए किया जाता है: 123-456-789. लेन-देन आईडी ज़रूरी है. भले ही, उपयोगकर्ता को मुफ़्त में आज़माने की सुविधा मिल रही हो.
7. अन्य बिलिंग सिस्टम में खरीदारी का लेन-देन होने के बाद, डेवलपर 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 का इस्तेमाल करना ज़रूरी है जिनके लिए एक से ज़्यादा पेमेंट या बाद में पेमेंट करना ज़रूरी होता है. उदाहरण के लिए, पहले से ऑर्डर करने के लिए, शुरुआत में शून्य डॉलर का ट्रांजै़क्शन हो सकता है. इसके बाद, पहले से ऑर्डर करना पूरा होने पर, एसकेयू की कीमत के लिए दूसरा ट्रांजै़क्शन किया जा सकता है. बाद के लेन-देन की रिपोर्ट करने के बारे में ज़्यादा जानकारी के लिए, खरीदारी के बाद के लेन-देन की रिपोर्ट करना लेख देखें.
• बाहरी ऑफ़र के शुरुआती लेन-देन की रिपोर्ट करते समय, आपको 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. उपयोगकर्ता 1 का पहला रिन्यूअल, अन्य बिलिंग सिस्टम पर होता है. शुरुआती लेन-देन आईडी 123-456-789 था.
2. डेवलपर, यूआरएल क्वेरी पैरामीटर में, लेन-देन की बार-बार होने की जानकारी को इस नए लेन-देन के लिए बाहरी लेन-देन आईडी के तौर पर रिपोर्ट करता है. साथ ही, 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 API में एक ही एंडपॉइंट और फ़ंक्शन का इस्तेमाल करें. साथ ही, अपग्रेड या डाउनग्रेड के लेन-देन के लिए, ऐप्लिकेशन को मिला 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"
 }
}

अन्य बिलिंग सिस्टम के लेन-देन की मैन्युअल रिपोर्टिंग से माइग्रेट करना

ध्यान दें: अन्य बिलिंग सिस्टम और उपयोगकर्ता की पसंद का बिलिंग सिस्टम की मैन्युअल रिपोर्टिंग बंद की जा रही है. माइग्रेशन की समयसीमा के बारे में ज़्यादा जानकारी के लिए, Google Play पर उपयोगकर्ताओं को उनकी पसंद का बिलिंग सिस्टम (यूज़र चॉइस बिलिंग) उपलब्ध कराने की सुविधा के बारे में जानकारी लेख देखें. मैन्युअल रिपोर्टिंग बंद होने से पहले, externaltransactions API के ज़रिए, उन सभी चालू सदस्यताओं को माइग्रेट करना न भूलें जो रिपोर्ट अपने-आप भेजने की सुविधा के बिना ही अन्य बिलिंग सिस्टम की सुविधा उपलब्ध कराने के दौरान शुरू हुई थीं.

उन चालू सदस्यताओं को माइग्रेट करने के लिए जो रिपोर्ट अपने-आप भेजने की सुविधा के बिना ही अन्य बिलिंग सिस्टम की सुविधा उपलब्ध कराने के दौरान शुरू हुई थीं, initialExternalTransactionId या externalTransactionToken तय करने के बजाय, migratedTransactionProgram फ़ील्ड का इस्तेमाल करके, शून्य लागत वाला नया लेन-देन बनाएं. transactionTime को उस समय पर सेट करें जब उपयोगकर्ता ने हर चालू सदस्यता के लिए पहली बार साइन अप किया था. इसके बाद, इन सदस्यताओं के लिए, एपीआई के ज़रिए सामान्य तरीके से, हर बाद के लेन-देन की रिपोर्ट करें. साथ ही, रिन्यूअल के लेन-देन बनाने के लिए पहले इस्तेमाल किया गया initialExternalTransactionId उपलब्ध कराएं. सदस्यता माइग्रेट होने के बाद, आपको सदस्यता के लिए बाद के लेन-देन की रिपोर्ट मैन्युअल तरीके से नहीं करनी होगी. हालांकि, ऐसा तब होगा, जब इस पेज पर बताए गए ऑटोमैटिक तरीकों से इनकी रिपोर्ट की जा रही हो.

सदस्यताओं को माइग्रेट करते समय, कोटा की सीमाओं का ध्यान रखें, ताकि यह पक्का किया जा सके कि माइग्रेशन की वजह से कोटा खत्म न हो. अगर कई सदस्यताओं को माइग्रेट करना है, तो उन्हें कई दिनों में फैलाएं या कोटा बढ़ाने का अनुरोध करें.

ध्यान दें: सिर्फ़ वे डेवलपर migratedTransactionProgram फ़ील्ड को सेट कर पाएंगे जिन्होंने रिपोर्ट अपने-आप भेजने की सुविधा के बिना ही अन्य बिलिंग सिस्टम की सुविधा उपलब्ध कराई है. अगर आपने पहले रिपोर्ट अपने-आप भेजने की सुविधा के बिना ही अन्य बिलिंग सिस्टम की सुविधा उपलब्ध कराई थी और सदस्यता को माइग्रेट करने का अनुरोध करने पर आपको कोई गड़बड़ी मिल रही है, तो मदद के लिए हमारी सहायता टीम से संपर्क करें.

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 को खरीदारी के रिफ़ंड की रिपोर्ट करना

Google Play के बिलिंग सिस्टम के बाहर, उपयोगकर्ताओं को रिफ़ंड किए गए लेन-देन की रिपोर्ट करने के लिए, externaltransactions API को इंटिग्रेट करें. Play को यह सही तरीके से पता चल सके कि किस लेन-देन का रिफ़ंड किया गया है, इसके लिए आपको यूआरएल पैरामीटर के तौर पर, पहले रिपोर्ट किए गए लेन-देन के लिए, उससे जुड़ा externalTransactionId शामिल करना होगा.

सदस्यता की खरीदारी के रिफ़ंड की रिपोर्ट करते समय, सदस्यता के उस खास रिन्यूअल के externalTransactionId का रेफ़रंस दें जिसका रिफ़ंड किया जा रहा है.

उदाहरण: मान लें कि किसी सदस्यता के लिए ये लेन-देन हुए हैं:

• बाहरी लेन-देन आईडी ABC.1234-5678-9012-34567 वाला शुरुआती लेन-देन

• बाहरी लेन-देन आईडी ABC.1234-5678-9012-34567..0 वाला पहला बार-बार होने वाला लेन-देन

• बाहरी लेन-देन आईडी ABC.1234-5678-9012-34567..1 वाला दूसरा बार-बार किया जाने वाला लेन-देन

सदस्यता के सभी लेन-देन के रिफ़ंड की रिपोर्ट करने के लिए, आपको रिफ़ंड के तीन अलग-अलग अनुरोध करने होंगे. एक अनुरोध शुरुआती लेन-देन के लिए और दो अनुरोध बाद के लेन-देन के लिए.

इस तरीके से, पूरे रिफ़ंड (जिसमें रकम, उपयोगकर्ता ने मूल बाहरी लेन-देन में चुकाई गई रकम के बराबर होती है) और कुछ हिस्से का रिफ़ंड (जिसमें रकम, उपयोगकर्ता ने मूल बाहरी लेन-देन में चुकाई गई रकम से कम होती है) दोनों के लिए अनुरोध स्वीकार किए जाते हैं. कुछ हिस्से के रिफ़ंड के लिए, आपको टैक्स से पहले की वह रकम बतानी होगी जिसका रिफ़ंड किया गया है.

एपीआई कोटा

Externaltransactions API पर, एपीआई कोटा सभी कॉल के लिए लागू होते हैं. यह Google Play Developer API के किसी भी अन्य एंडपॉइंट की तरह ही है.

इसके अलावा, Externaltransactions API पर, Externaltransactions.createexternaltransaction या Externaltransactions.refundexternaltransaction को कॉल करने की सीमा, हर मिनट 1,200 क्वेरी (क्यूपीएम) है. Externaltransactions.getexternaltransaction को कॉल करने की संख्या, इस 1,200 क्यूपीएम की सीमा में नहीं गिनी जाती.