ক্রেডিট প্রদান

আপনি Apigee Edge-এর ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশন .info- তে যান।

ভূমিকা

মনিটাইজেশন আপনাকে ডেভেলপার ক্রেডিট প্রদানের সুবিধা দেয়।

একজন প্রিপেইড ডেভেলপারের জন্য, ক্রেডিট ব্যবহারের পরিমাণ হ্রাস হিসাবে প্রদর্শিত হয় — এটি ভবিষ্যতে ডেভেলপারের প্রিপেইড ব্যালেন্স বাড়ায় বা কমায়। ডেবিট কার্ড ব্যবহারের মতোই, যখন একজন ডেভেলপার একটি এপিআই প্রোডাক্ট বান্ডেল কেনেন, তখন তার প্রিপেইড ব্যালেন্স থেকে অর্থ কেটে নেওয়া হয়। কেনাকাটার জন্য ডেভেলপারকে অবশ্যই পর্যাপ্ত ব্যালেন্স বজায় রাখতে হবে। দেখুন, আমি কীভাবে আমার প্রিপেইড অ্যাকাউন্টের অবশিষ্ট ব্যালেন্স গণনা করব?

পোস্টপেইড ডেভেলপারের ক্ষেত্রে, ক্রেডিট ইনভয়েসে একটি আলাদা লাইন হিসেবে প্রদর্শিত হয়, যা ইনভয়েসের চার্জ কমিয়ে দেয়।

ক্রেডিট পৃষ্ঠাটি অন্বেষণ করা

নীচে বর্ণিত পদ্ধতি অনুসারে ক্রেডিট পৃষ্ঠাটি প্রবেশ করুন এবং অন্বেষণ করুন।

ক্রেডিট ইস্যু করা

1. ক্রেডিট পৃষ্ঠায় প্রবেশ করুন ।
2. ক্লিক করুন + ক্রেডিট ।
3. নিম্নলিখিত তথ্য প্রবেশ করান:

   মাঠ	বর্ণনা
   বিলিং মাস	যে বিলিং মাসে ক্রেডিটটি প্রযোজ্য হবে। তালিকা থেকে একটি মাস নির্বাচন করুন।
   ডেভেলপার	ডেভেলপার বা কোম্পানির নাম, যার জন্য এই ক্রেডিট প্রযোজ্য। টেক্সট বক্সে নামটি লিখুন। আপনি টাইপ করার সাথে সাথে, একটি ড্রপ-ডাউনে সেইসব ডেভেলপার/কোম্পানির একটি তালিকা প্রদর্শিত হবে যাদের নামে এই স্ট্রিংটি রয়েছে। ড্রপ-ডাউন তালিকা থেকে ডেভেলপার বা কোম্পানির নামে ক্লিক করুন। দ্রষ্টব্য : আপনি কোনো ডেভেলপার বা কোম্পানি নির্বাচন করার পর, বাকি ক্ষেত্রগুলো প্রদর্শিত হবে। আপনি যদি এমন কোনো কোম্পানি বা ডেভেলপার নির্বাচন করেন যারা কোনো রেট প্ল্যান গ্রহণ করেনি, তাহলে আপনি ক্রেডিট ইস্যু করতে পারবেন না।
   পণ্য বান্ডেল	যে এপিআই প্রোডাক্ট বান্ডেলের উপর ক্রেডিটটি প্রযোজ্য। উপলব্ধ এপিআই প্রোডাক্ট বান্ডেলগুলির তালিকা থেকে নির্বাচন করুন।
   পণ্য	নির্বাচিত এপিআই প্রোডাক্ট বান্ডেলের অন্তর্ভুক্ত এপিআই প্রোডাক্ট, যেটির উপর ক্রেডিট প্রযোজ্য। তালিকা থেকে সমস্ত প্রোডাক্ট অথবা একটি একক এপিআই প্রোডাক্ট নির্বাচন করুন।
   মুদ্রা	ক্রেডিটের জন্য ব্যবহৃত মুদ্রা। ডেভেলপার কর্তৃক ক্রয়কৃত এপিআই প্রোডাক্ট বান্ডেলের রেট প্ল্যানে এই মুদ্রাটি কনফিগার করা থাকে এবং এটি পরিবর্তন করা যায় না। যদি একটি রেট প্ল্যানে একাধিক মুদ্রা সংজ্ঞায়িত থাকে, তবে আপনি সেগুলোর মধ্যে থেকে যেকোনো একটি মুদ্রা নির্বাচন করতে পারবেন।
   পরিমাণ	ক্রেডিটের পরিমাণ (নির্দিষ্ট মুদ্রায়)। একটি ধনাত্মক বা ঋণাত্মক মান উল্লেখ করুন। মানটি শূন্য হতে পারবে না।
   দ্রষ্টব্য	ক্রেডিট প্রদানের কারণ বর্ণনা করার জন্য ঐচ্ছিক টীকা।

4. ক্রেডিট সংরক্ষণ করুন -এ ক্লিক করুন।

এপিআই ব্যবহার করে ক্রেডিট প্রদান করা

এপিআই ব্যবহার করে, কোনো ডেভেলপারকে সম্পূর্ণ এপিআই প্রোডাক্ট বান্ডেলের বিপরীতে, অথবা সেই বান্ডেলের অন্তর্ভুক্ত কোনো নির্দিষ্ট এপিআই প্রোডাক্ট ব্যবহারের জন্য ক্রেডিট প্রদান করা যেতে পারে।

API ব্যবহার করে ক্রেডিট ইস্যু করতে, /organizations/{org_name}/monetization-packages/{package_id}/rate-plans/{rate-plan_id}/real-currency-credit-transactions একটি POST রিকোয়েস্ট পাঠান, যেখানে {package_id} এবং {rate-plan_id} যথাক্রমে সেই API প্রোডাক্ট বান্ডেল এবং রেট প্ল্যানের পরিচয় নির্দেশ করে, যেগুলোর উপর ক্রেডিটটি প্রযোজ্য।

অনুরোধটি করার সময়, আপনাকে কোয়েরি প্যারামিটার হিসেবে নির্দিষ্ট করতে হবে:

• ডেভেলপার আইডি (ইমেল ঠিকানা), যার প্রাপ্য কৃতিত্ব তাকেই দেওয়া হবে।
• ক্রেডিটের পরিমাণ।
• ক্রেডিটের জন্য ব্যবহৃত মুদ্রা।
• ক্রেডিট প্রদানের কারণ বর্ণনা করে নোট।

ঐচ্ছিকভাবে, আপনি নিম্নলিখিত অতিরিক্ত কোয়েরি প্যারামিটারগুলো নির্দিষ্ট করতে পারেন:

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

উদাহরণস্বরূপ, নিম্নলিখিত অনুরোধটি dev1@myorg.com হিসাবে চিহ্নিত একজন ডেভেলপারকে এপ্রিল ২০১৮ বিলিং মাসের জন্য $১০০-এর একটি ক্রেডিট প্রদান করে। এই ক্রেডিটটি payment এপিআই প্রোডাক্ট বান্ডেল এবং payment_standard_plan রেট প্ল্যানের জন্য প্রযোজ্য:

একটি ক্রেডিট অনুরোধে আপনি যে সমস্ত কোয়েরি প্যারামিটার উল্লেখ করতে পারেন তার সম্পূর্ণ তালিকার জন্য, ক্রেডিট এপিআই-এর কোয়েরি প্যারামিটারসমূহ দেখুন।

$ curl -H "Content-Type:application/json" -X POST \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/payment/rate-plans/payment_standard_plan/real-currency-credit-transactions?currencyId=usd&developerId=dev1@myorg.com&transactionAmount=100&transactionNote=Credit+for+failed+transactions&billingMonth=APRIL&billingYear=2013" \
-u email:password

নিম্নলিখিতটি উত্তরের একটি নমুনা অংশ প্রদান করে:

{
  "currency" : "USD",
  "developer" : {
    "address" : [ {
      "address1" : "Dev One Address",
     ...
    } ],
    "approxTaxRate" : 0.0000,
    "billingType" : "PREPAID",
    "broker" : false,
    "developerRole" : [ ],
    "email" : "dev1@myorg.com",
    "hasSelfBilling" : false,
    "id" : "K4jW2QLjZ1h8GFA8",
    "legalName" : "DEV ONE",
    "name" : "Dev One",
    "organization" : {
     ...
    },
    "registrationId" : "TestRegId",
    "status" : "ACTIVE",
    "type" : "TRUSTED"
  },
  "endTime" : "2013-09-04 15:54:36",
  "environment" : "PROD",
  "euroExchangeRate" : 0.8107,
  "gbpExchangeRate" : 0.6860,
  "id" : "904c3f73-ab8d-4e5d-a48c-225fd49a3bde",
  "isVirtualCurrency" : false,
  "notes" : "Credit for failed transactions",
  "pkgId" : "myorg@@@payment",
  "pkgRatePlanProductName" : "Payment",
  "providerTxId" : "904c3f73-ab8d-4e5d-a48c-225fd49a3bde",
  "rate" : 100,
  "ratePlan" : {
    ...
      },
      "status" : "ACTIVE",
      "virtualCurrency" : false
    },
    "description" : "Standard Plan",
    "displayName" : "Standard Plan",
    …
    "monetizationPackage" : {
      "description" : "Payment",
      ...
        } ],
       ...
      },
      "product" : [ {
        "customAtt1Name" : "user",
        "description" : "Payment",
        "displayName" : "Payment",
        "id" : "payment",
        "name" : "payment",
        "organization" : {
          ...
        },
        "status" : "CREATED",
        "transactionSuccessCriteria" : "Status=='200 OK'"
      } ],
      "status" : "CREATED"
    },
    "name" : "Standard Plan",
    "organization" : {
     ...
    },
    ...
      },
      ...
      },
      ...
  },
  "revenueShareAmount" : 0,
  "startTime" : "2013-09-04 15:54:36",
  "status" : "SUCCESS",
  "taxModel" : "UNDISCLOSED",
  "txProviderStatus" : "SUCCESS",
  "type" : "CREDIT",
  "usdExchangeRate" : 1.0675,
  "utcEndTime" : "2013-09-04 15:54:36",
  "utcStartTime" : "2013-09-04 15:54:36"
}

ক্রেডিট এপিআই-এর জন্য কোয়েরি প্যারামিটার

ক্রেডিট এপিআই-এর সাথে ব্যবহারের জন্য নিম্নলিখিত কোয়েরি প্যারামিটারগুলো উপলব্ধ রয়েছে: