आपको Apigee Edge दस्तावेज़ दिख रहा है.
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
इस पेज पर जाएं
Apigee X दस्तावेज़. जानकारी
परिचय
कमाई करने की सुविधा से, डेवलपर को "खरीदारी से जुड़े लेन-देन" होने पर रिफ़ंड पोस्ट किए जा सकते हैं. मान लीजिए कि मोबाइल ऑपरेटर हैं और आप डेवलपर को किसी ऐप्लिकेशन या उसमें मौजूद कॉन्टेंट की खरीदारी. हर बार जब कोई सदस्य एपीआई का इस्तेमाल करता है किसी खरीदारी के लिए, यह खरीदारी जैसा लेन-देन होता है.
खरीदारी के लेन-देन की वजह से रिफ़ंड मिल सकता है. उदाहरण के लिए, हो सकता है कि कॉन्टेंट डिलीवर न हो, या तीसरा पक्ष खरीदारी से असंतुष्ट है. ऐसे मामलों में, डेवलपर तीसरे पक्ष को रिफ़ंड जारी करता है. कमाई करने की सुविधा की मदद से, मिलते-जुलते रिफ़ंड की सुविधा चालू की जा सकती है. यह है जो खास तौर पर रेवेन्यू के बंटवारे के प्लान पर लागू होते हैं.
मान लें कि मोबाइल सदस्यों को रिफ़ंड जारी करने वाले डेवलपर ने रेवेन्यू खरीदा एपीआई प्रॉडक्ट के लिए प्लान शेयर करें. मान लें कि प्लान में डेवलपर को खरीदारी के लेन-देन की कुल/कुल कीमत. रिफ़ंड पोस्ट करने का मतलब है कि खरीदारी का लेन-देन. इसका मतलब है कि आपको उस महीने डेवलपर को चुकाई जाने वाली रकम में से 70% की कटौती करनी होती है कब रिफ़ंड किया गया था (यह महीना उस महीने से अलग हो सकता है जिसमें खरीदारी के लिए लेन-देन हुआ).
क्लासिक एज यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके रिफ़ंड पोस्ट करना (सिर्फ़ प्राइवेट क्लाउड के लिए Edge)
किसी "सफल" होने के लिए, रिफ़ंड पोस्ट किया जा सकता है खरीदारी लेन-देन, यानी जहां API तीसरे पक्ष से शुल्क ले लिया है और जिसके लिए आपने अभी तक पूरा शुल्क जारी नहीं किया है रिफ़ंड. रिफ़ंड पोस्ट करने पर, माता-पिता के साथ मिलकर रिफ़ंड का लेन-देन किया जाता है ट्रांज़ैक्शन आईडी, जहां ट्रांज़ैक्शन आईडी, खरीदारी वाले लेन-देन का आईडी होता है.
आप खरीदारी के मूल लेन-देन की पूरी रकम का रिफ़ंड पोस्ट कर सकते हैं या आंशिक रकम. कुछ हिस्से के रिफ़ंड को एक से ज़्यादा बार भी पोस्ट किया जा सकता है, लेकिन रिफ़ंड की कुल रकम खरीदारी की रकम, मूल कीमत से ज़्यादा नहीं होनी चाहिए.
रिफ़ंड पोस्ट करने के लिए:
- 'कमाई करें' टैब में जाकर, 'रिफ़ंड' चुनें.
इससे रिफ़ंड पेज खुलेगा.
- बिलिंग महीने में, ड्रॉप-डाउन मेन्यू में, उस महीने को चुनें जिसमें खरीदारी का लेन-देन हुआ है
हुआ है. इसके बाद, + रिफ़ंड पर क्लिक करें.
यहां चुने गए चैनलों के लिए, खरीदारी के लिए किए गए सभी ट्रांज़ैक्शन की सूची दिखती है महीना.
रिफ़ंड सूची को डेवलपर के नाम के हिसाब से फ़िल्टर किया जा सकता है. इसके अलावा, रिफ़ंड सूची को लेन-देन.
डेवलपर के अनुसार फ़िल्टर करने के लिए, डेवलपर ड्रॉप-डाउन मेन्यू से डेवलपर चुनें. यह सिर्फ़ चुने हुए डेवलपर से जुड़े लेन-देन की सूची दिखाता है.
ट्रांज़ैक्शन आईडी के हिसाब से फ़िल्टर करने के लिए, उस मूल खरीदारी का ट्रांज़ैक्शन आईडी डालें जिसे आपने रिफ़ंड करना चाहते हैं. इससे उस आईडी का ट्रांज़ैक्शन दिखता है.
- आपको जिन लेन-देन के लिए रिफ़ंड चाहिए उनकी लाइन में, 'चुनें' बॉक्स चुनें.
- प्रकार ड्रॉप-डाउन मेनू में कुल या आंशिक चुनें.
'कुल' विकल्प चुनने पर, खरीदारी की कुल रकम रिफ़ंड कर दी जाएगी. अगर आपको खरीदारी का कुछ हिस्सा रिफ़ंड किया जाएगा.
अगर आप आंशिक रिफ़ंड का विकल्प चुनते हैं, तो रकम फ़ील्ड में आंशिक रिफ़ंड की रकम डालें. आप सिर्फ़ खरीदारी की कुल रकम तक का रिफ़ंड मिलेगा. अगर आपने पहले ही धनवापसी के लिए, आप केवल खरीदारी पर शेष राशि तक राशि डाल सकते हैं. साथ ही, अगर मूल खरीदारी लेन-देन में कुल और नेट कीमतें शामिल हैं, इसलिए आपको यह भी बताना होगा कि चाहे आप जो आंशिक रकम वापस करना चाहते हैं वह कुल हो या कुल.
- रिफ़ंड प्रोसेस करने के लिए 'सेव करें' पर क्लिक करें या रद्द करने के लिए 'रद्द करें' पर क्लिक करें.
अगर बिलिंग महीना अब भी जारी है, तो रिफ़ंड उस महीने में भेज दिया जाता है जिस महीने में खरीदारी की गई थी खोलें, नहीं तो रिफ़ंड मौजूदा तारीख पर पोस्ट किया जाएगा.
कुछ हिस्से का रिफ़ंड देने के लिए, रिफ़ंड करने की प्रोसेस पूरी की जाती है. यह रिफ़ंड, बाकी बची रकम और रेवेन्यू के बंटवारे में किया जाता है काटा जाता है, जो पूरी रकम के मुकाबले बची हुई रकम के अनुपात के आधार पर काटा जाता है. इस आंशिक रिफ़ंड का उदाहरण ऊपर दिया गया है, आंशिक रकम कुल कीमत का 0.50/1.12 = 45% है, इसलिए डेवलपर के रेवेन्यू के हिस्से का 45% हिस्सा काटा जाएगा.
यूज़र इंटरफ़ेस (यूआई) में देखना कि रिफ़ंड मिल चुका है या नहीं प्रोसेस किया गया
सबसे ऊपर दाईं ओर मौजूद बिलिंग महीने को चुनकर, यह पता लगाया जा सकता है कि रिफ़ंड प्रोसेस हुआ है या नहीं रिफ़ंड पेज पर. खरीदारी वाला महीना तब माना जाता है, जब बिलिंग महीना अब भी खुला रहता है या अगर बिलिंग महीना बंद है, तो मौजूदा महीना. यह उन सभी रिफ़ंड की सूची दिखाता है जिन्हें महीने में पोस्ट की गई.
एपीआई का इस्तेमाल करके रिफ़ंड पोस्ट करना
रिफ़ंड पोस्ट करने के लिए,
/organizations/{org_name}/monetization-packages/{package_id}/refund-transactions
,
जहां {package_id}
उस एपीआई पैकेज की पहचान करता है जिस पर रिफ़ंड भेजा जाता है
लागू होती है.
अनुरोध करते समय, आपको क्वेरी पैरामीटर के तौर पर यह जानकारी देनी होगी:
- उस खरीदारी के लेन-देन की पहचान जिसका रिफ़ंड दिया जा रहा है.
- खरीदारी वाले लेन-देन से मिला रेवेन्यू (
GROSS
याNET
). - रिफ़ंड की रकम.
- रिफ़ंड की वजह बताने वाला नोट.
इसके अलावा, रिफ़ंड देने वाले एपीआई पैकेज की पहचान, यूआरएल पैरामीटर के तौर पर की जा सकती है लागू होती है.
यूआरएल की पूरी सूची के लिए, रिफ़ंड कॉन्फ़िगरेशन सेटिंग देखें ऐसे पैरामीटर जिन्हें रिफ़ंड के अनुरोध में तय किया जा सकता है.
उदाहरण के लिए, नीचे दिए गए अनुरोध में किसी खरीदारी के लेन-देन के लिए रिफ़ंड जारी किया जाता है. रिफ़ंड यह रकम खरीदारी वाले लेन-देन की कुल रकम का 50% होती है.
$ curl -H "Content-Type:application/json" -X POST \ "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/payment/refund-transactions?revenueType=GROSS&refundAmount=0.5&parentTxId=abf50909-2492-4bf5-8704-ade05f4d43b3&transactionNote=Refund for purchase transaction" \ -u email:password
जवाब कुछ ऐसा दिखना चाहिए (जवाब का सिर्फ़ एक हिस्सा दिखता है):
{ "application" : { ... }, "product" : [ { ... { "customAtt1Name" : "user", "description" : "Payment", "displayName" : "Payment", "id" : "payment", "name" : "payment", "organization" : { ... }, "status" : "CREATED", "transactionSuccessCriteria" : "Status=='200 OK'" } ], ... }, "currency" : "USD", "developer" : { ... "legalName" : "DEV ONE", "name" : "Dev One", "organization" : { ... }, ... }, "endTime" : "2013-09-01 21:59:59", "environment" : "PROD", "euroExchangeRate" : 0.8123, "gbpExchangeRate" : 0.6910, "grossPrice" : 0.5, "id" : "61f7eb88-f8cc-4cda-afd8-4a61fba3dd33", "isRevOnGrossOrNet" : "NET", "isVirtualCurrency" : false, "notes" : "Refund for purchase transaction", "itemDesc" : "test application", "netPrice" : 0.4464, "orgRevenueShareAmount" : 0.1339, "parentId" : "abf50909-2492-4bf5-8704-ade05f4d43b3", "pkgId" : "myorg@@@payment", "pkgRatePlanProductName" : "Payment", ... }, "ratePlanLevel" : "STANDARD", "revenueShareAmount" : 0.3125, "startTime" : "2013-09-01 21:59:59", "status" : "SUCCESS", "tax" : 0.0536, "taxModel" : "UNDISCLOSED", "txProviderStatus" : "SUCCESS", "type" : "REFUND", "usdExchangeRate" : 1.0724, "utcEndTime" : "2013-09-01 21:59:59", "utcStartTime" : "2013-09-01 21:59:59" }
एपीआई के लिए रिफ़ंड कॉन्फ़िगरेशन सेटिंग
रिफ़ंड के अनुरोध में, ये क्वेरी पैरामीटर इस्तेमाल किए जा सकते हैं:
नाम | ब्यौरा | डिफ़ॉल्ट | ज़रूरी है? |
---|---|---|---|
monetizationPackageId |
वह एपीआई पैकेज जिस पर रिफ़ंड लागू होता है. |
लागू नहीं | नहीं |
parentTxId |
खरीदारी के लिए रिफ़ंड किया जाने वाला लेन-देन. |
लागू नहीं | हां |
revenueType |
खरीदारी से मिला रेवेन्यू ( |
लागू नहीं | हां |
refundAmount |
रिफ़ंड की रकम. |
लागू नहीं | हां |
transactionNote |
रिफ़ंड की वजह बताने वाला टेक्स्ट नोट. |
लागू नहीं | हां |
अगले चरण
कमाई करने से जुड़ी नौकरियों को शेड्यूल करने और शेड्यूल की गई जॉब के बारे में जानें शेड्यूल में अपने-आप कमाई करने से जुड़ी नौकरियां.