পোস্ট ফেরত

আপনি Apigee Edge ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশনে যান । তথ্য

ভূমিকা

নগদীকরণ আপনাকে "ক্রয় লেনদেনের" জন্য বিকাশকারীদের কাছে ফেরত পোস্ট করার অনুমতি দেয়। ধরুন আপনি একজন মোবাইল অপারেটর এবং আপনি ডেভেলপারদের একটি পেমেন্ট এপিআই অফার করেন যাতে মোবাইল গ্রাহকদের থেকে অ্যাপ্লিকেশন বা সামগ্রী কেনার জন্য চার্জ করা যায়। প্রতিবার একজন গ্রাহক ক্রয় করার জন্য API ব্যবহার করে, এটি একটি ক্রয় লেনদেন।

ক্রয় লেনদেন ফেরত হতে পারে. উদাহরণস্বরূপ, বিষয়বস্তু বিতরণ নাও হতে পারে, অথবা তৃতীয় পক্ষ অন্যথায় ক্রয়ের সাথে অসন্তুষ্ট। এই ক্ষেত্রে, বিকাশকারী তৃতীয় পক্ষকে ফেরত প্রদান করে। নগদীকরণ আপনাকে একটি অনুরূপ ফেরত দিতে সক্ষম করে। এটি রাজস্ব ভাগ পরিকল্পনার জন্য বিশেষভাবে প্রাসঙ্গিক।

কল্পনা করুন যে বিকাশকারী যে মোবাইল গ্রাহককে রিফান্ড জারি করেছে সে আপনার API পণ্যের জন্য একটি আয় ভাগের পরিকল্পনা কিনেছে৷ ধরুন প্ল্যানটি ডেভেলপারকে ক্রয় লেনদেনের নেট/মোট মূল্যের 70% গ্রহণ করতে বলছে। একটি রিফান্ড পোস্ট করার মাধ্যমে, আপনি, কার্যত, ক্রয় লেনদেনকে বিপরীত করেন, অর্থাৎ, আপনি যে মাসের জন্য ডেভেলপারের বকেয়া অর্থপ্রদান থেকে 70% কেটে নেন যখন রিফান্ড প্রয়োগ করা হয়েছিল (মাসটি প্রকৃতপক্ষে যে মাসের চেয়ে ভিন্ন হতে পারে ক্রয় লেনদেন ঘটেছে)।

ক্লাসিক এজ UI ব্যবহার করে ফেরত পোস্ট করা (শুধুমাত্র ব্যক্তিগত ক্লাউডের জন্য এজ)

আপনি যেকোন "সফল" ক্রয় লেনদেনের জন্য একটি ফেরত পোস্ট করতে পারেন, অর্থাৎ যেখানে API সফলভাবে তৃতীয় পক্ষকে চার্জ করেছে এবং যার জন্য আপনি ইতিমধ্যে একটি সম্পূর্ণ ফেরত জারি করেননি৷ একটি ফেরত পোস্ট করার ফলে একটি অভিভাবক লেনদেন আইডি সহ একটি ফেরত লেনদেন তৈরি হয়, যেখানে লেনদেন আইডিটি ক্রয় লেনদেনের আইডি।

আপনি মূল ক্রয় লেনদেনের সম্পূর্ণ পরিমাণ বা আংশিক পরিমাণের জন্য একটি ফেরত পোস্ট করতে পারেন। আপনি একাধিক আংশিক ফেরত পোস্ট করতে পারেন, তবে ফেরতের মোট পরিমাণ আসল ক্রয়ের পরিমাণের বেশি হতে পারে না।

একটি ফেরত পোস্ট করতে:

1. মনিটাইজেশন ট্যাবে, রিফান্ড নির্বাচন করুন।

   

   এটি রিফান্ড পৃষ্ঠাটি খোলে।

   

2. বিলিং মাসে, ড্রপ-ডাউন মেনুতে, যে মাসে ক্রয় লেনদেন হয়েছিল সেটি নির্বাচন করুন। তারপর + ফেরত ক্লিক করুন।

   এটি নির্বাচিত মাসের জন্য সমস্ত সফল ক্রয় লেনদেনের একটি তালিকা প্রদর্শন করে।

   

   আপনি বিকাশকারীর নাম দ্বারা বা প্রকৃত লেনদেন অনুসন্ধান করে ফেরত তালিকা ফিল্টার করতে পারেন।

   বিকাশকারী দ্বারা ফিল্টার করতে, বিকাশকারী ড্রপ-ডাউন মেনু থেকে বিকাশকারী নির্বাচন করুন। এটি শুধুমাত্র নির্বাচিত বিকাশকারীর সাথে সম্পর্কিত লেনদেনের একটি তালিকা প্রদর্শন করে।

   

   লেনদেন আইডি দ্বারা ফিল্টার করতে, আসল ক্রয়ের লেনদেন আইডি লিখুন যা আপনি ফেরত দিতে চান। এটি সেই আইডির জন্য লেনদেন ফেরত দেয়।

   

3. আপনি যে লেনদেন (গুলি) ফেরত দিতে চান তার জন্য সারি(গুলি) নির্বাচন বাক্সে টিক চিহ্ন দিন৷
4. টাইপ ড্রপ-ডাউন মেনুতে মোট বা আংশিক নির্বাচন করুন।

   আপনি যদি মোট নির্বাচন করেন, তাহলে ক্রয়ের মোট পরিমাণ ফেরত দেওয়া হবে। আপনি আংশিক নির্বাচন করলে, ক্রয়ের আংশিক পরিমাণ ফেরত দেওয়া হবে।

   আপনি যদি আংশিক নির্বাচন করেন, তাহলে পরিমাণ ক্ষেত্রে আংশিক ফেরতের পরিমাণ লিখুন। আপনি শুধুমাত্র ক্রয়ের মোট পরিমাণ পর্যন্ত ফেরত দিতে পারবেন। আপনি যদি ইতিমধ্যেই একটি আংশিক ফেরত পোস্ট করে থাকেন, তাহলে আপনি শুধুমাত্র ক্রয়ের অবশিষ্ট পরিমাণ পর্যন্ত একটি পরিমাণ লিখতে পারেন। এছাড়াও, যদি আসল ক্রয় লেনদেনের মোট এবং নেট উভয় মূল্যই থাকে, তবে আপনি যে আংশিক পরিমাণ অর্থ ফেরত দিতে চান তা মোট বা নেট কিনা তাও আপনাকে বলতে হবে।

   

5. ফেরত প্রক্রিয়া করতে সংরক্ষণ করুন ক্লিক করুন (বা বাতিল করতে বাতিল করুন)।

   যদি বিলিং মাস এখনও খোলা থাকে তাহলে মূল কেনাকাটার মাসে রিফান্ড পোস্ট করা হয়, অন্যথায় রিফান্ড বর্তমান তারিখে পোস্ট করা হয়।

   আংশিক ফেরতের জন্য, আংশিক পরিমাণের জন্য ফেরত প্রক্রিয়া করা হয় এবং সম্পূর্ণ পরিমাণের উপর আংশিক পরিমাণের অনুপাতের উপর ভিত্তি করে কোনো রাজস্ব ভাগ কাটা হয়। উপরের আংশিক ফেরতের উদাহরণে, আংশিক পরিমাণ হল মোট মূল্যের 0.50/1.12 = 45%, তাই ডেভেলপারের রাজস্ব ভাগের 45% কেটে নেওয়া হবে।

ফেরত প্রক্রিয়া করা হয়েছে কিনা তা UI-তে চেক করা হচ্ছে

রিফান্ড পৃষ্ঠার শীর্ষে বিলিং মাস নির্বাচন করে আপনি একটি রিফান্ড প্রক্রিয়া করা হয়েছে কিনা তা নির্ধারণ করতে পারেন। বিলিং মাস এখনও খোলা থাকলে এটি কেনার মাস, বা বিলিং মাস বন্ধ থাকলে বর্তমান মাস। এটি মাসে পোস্ট করা সমস্ত রিফান্ডের একটি তালিকা প্রদর্শন করে।

API ব্যবহার করে ফেরত পোস্ট করা

ফেরত পোস্ট করতে, /organizations/{org_name}/monetization-packages/{package_id}/refund-transactions এ একটি POST অনুরোধ জারি করুন, যেখানে {package_id} হল API প্যাকেজের শনাক্তকরণ যেখানে রিফান্ড প্রযোজ্য।

আপনি যখন অনুরোধটি ইস্যু করেন, তখন আপনাকে ক্যোয়ারী প্যারামিটার হিসাবে উল্লেখ করতে হবে:

• ক্রয় লেনদেনের শনাক্তকরণ যা ফেরত দেওয়া হচ্ছে।
• ক্রয় লেনদেনের রাজস্ব প্রকার ( GROSS বা NET )৷
• ফেরতের পরিমাণ।
• ফেরতের কারণ বর্ণনা করে একটি নোট।

ঐচ্ছিকভাবে, আপনি একটি URL প্যারামিটার হিসাবে একটি API প্যাকেজ সনাক্ত করতে পারেন যেখানে ফেরত প্রযোজ্য।

ইউআরএল প্যারামিটারগুলির একটি সম্পূর্ণ তালিকার জন্য রিফান্ড কনফিগারেশন সেটিংস দেখুন যা আপনি একটি ফেরত অনুরোধে নির্দিষ্ট করতে পারেন।

উদাহরণস্বরূপ, নিম্নলিখিত অনুরোধ একটি ক্রয় লেনদেনের জন্য একটি ফেরত প্রদান করে৷ ফেরতের পরিমাণ ক্রয় লেনদেনের মোট পরিমাণের 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"
}

API-এর জন্য রিফান্ড কনফিগারেশন সেটিংস

নিম্নলিখিত ক্যোয়ারী পরামিতি একটি ফেরত অনুরোধে নির্দিষ্ট করা যেতে পারে:

পরবর্তী পদক্ষেপ

কীভাবে নগদীকরণ-সম্পর্কিত কাজের সময়সূচী করবেন এবং নগদীকরণ কাজের সময়সূচীতে স্বয়ংক্রিয়ভাবে নির্ধারিত চাকরি সম্পর্কে জানুন।