रिफ़ंड के बाद

आपको Apigee Edge का दस्तावेज़ दिख रहा है.
Apigee X के दस्तावेज़ पर जाएं. जानकारी

परिचय

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

खरीदारी के लेन-देन के लिए रिफ़ंड मिल सकता है. उदाहरण के लिए, ऐसा हो सकता है कि कॉन्टेंट डिलीवर न किया गया हो या तीसरे पक्ष को खरीदारी से संतुष्टि न मिली हो. ऐसे मामलों में, डेवलपर तीसरे पक्ष को रिफ़ंड देता है. कमाई करने की सुविधा की मदद से, आपको उसी तरह का रिफ़ंड मिल सकता है. यह खास तौर पर रेवेन्यू शेयर करने के प्लान के लिए ज़रूरी है.

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

Classic Edge यूज़र इंटरफ़ेस (सिर्फ़ Private Cloud के लिए Edge) का इस्तेमाल करके रिफ़ंड पोस्ट करना

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

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

रिफ़ंड पोस्ट करने के लिए:

1. 'कमाई करना' टैब पर जाकर, रिफ़ंड चुनें.

   

   इससे, रिफ़ंड पेज खुलता है.

   

2. बिलिंग का महीना ड्रॉप-डाउन मेन्यू में, वह महीना चुनें जिसमें खरीदारी का लेन-देन हुआ था. इसके बाद, + रिफ़ंड पर क्लिक करें.

   इससे चुने गए महीने के लिए, खरीदारी के सभी सफल लेन-देन की सूची दिखती है.

   

   डेवलपर के नाम के हिसाब से, रिफ़ंड की सूची को फ़िल्टर किया जा सकता है. इसके अलावा, लेन-देन की जानकारी खोजकर भी सूची को फ़िल्टर किया जा सकता है.

   डेवलपर के हिसाब से फ़िल्टर करने के लिए, डेवलपर ड्रॉप-डाउन मेन्यू से डेवलपर चुनें. इससे, चुने गए डेवलपर से जुड़े सिर्फ़ लेन-देन की सूची दिखती है.

   

   लेन-देन आईडी के हिसाब से फ़िल्टर करने के लिए, उस मूल खरीदारी का लेन-देन आईडी डालें जिसके लिए आपको रिफ़ंड करना है. इससे उस आईडी के लिए लेन-देन की जानकारी मिलती है.

   

3. आपको जिन लेन-देन के लिए रिफ़ंड चाहिए उनकी लाइन में मौजूद, चुनें बॉक्स पर सही का निशान लगाएं.
4. टाइप ड्रॉप-डाउन मेन्यू में, कुल या आंशिक में से कोई एक विकल्प चुनें.

   'कुल' विकल्प चुनने पर, खरीदारी की पूरी रकम रिफ़ंड कर दी जाएगी. 'कुछ हिस्सा' विकल्प चुनने पर, खरीदारी के लिए चुकाए गए शुल्क का कुछ हिस्सा रिफ़ंड किया जाएगा.

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

   

5. रिफ़ंड प्रोसेस करने के लिए, 'सेव करें' पर क्लिक करें या रद्द करने के लिए, 'रद्द करें' पर क्लिक करें.

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

   कुछ हिस्से का रिफ़ंड करने पर, रिफ़ंड की प्रोसेस सिर्फ़ कुछ हिस्से के लिए की जाती है. साथ ही, रेवेन्यू शेयर में कटौती, रिफ़ंड किए गए हिस्से के हिसाब से की जाती है. ऊपर दिए गए आंशिक रिफ़ंड के उदाहरण में, आंशिक रिफ़ंड की रकम, कुल कीमत का 0.50/1.12 = 45% है. इसलिए, डेवलपर के रेवेन्यू शेयर में से 45% काट लिया जाएगा.

यूज़र इंटरफ़ेस (यूआई) में यह देखना कि रिफ़ंड प्रोसेस हुआ है या नहीं

यह पता लगाया जा सकता है कि रिफ़ंड प्रोसेस किया गया है या नहीं. इसके लिए, रिफ़ंड पेज पर सबसे ऊपर जाकर, बिलिंग का महीना चुनें. अगर बिलिंग का महीना अब भी खुला है, तो यह खरीदारी का महीना होता है. अगर बिलिंग का महीना बंद हो गया है, तो यह मौजूदा महीना होता है. इससे उस महीने में पोस्ट किए गए सभी रिफ़ंड की सूची दिखती है.

एपीआई का इस्तेमाल करके रिफ़ंड पोस्ट करना

रिफ़ंड पोस्ट करने के लिए, /organizations/{org_name}/monetization-packages/{package_id}/refund-transactions पर POST अनुरोध भेजें. यहां {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"
}

एपीआई के लिए रिफ़ंड कॉन्फ़िगरेशन सेटिंग

रिफ़ंड के अनुरोध में इन क्वेरी पैरामीटर को तय किया जा सकता है:

अगले चरण

कमाई करने से जुड़े कामों को शेड्यूल करने का तरीका जानें. साथ ही, उन कामों के बारे में जानें जो कमाई करने से जुड़े कामों को शेड्यूल करें में अपने-आप शेड्यूल हो जाते हैं.