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

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

ভূমিকা

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

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

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

ক্রেডিট পৃষ্ঠা এক্সপ্লোর করা

নিচে বর্ণনা করা ক্রেডিট পৃষ্ঠা অ্যাক্সেস ও এক্সপ্লোর করুন।

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

1. ক্রেডিট পৃষ্ঠা অ্যাক্সেস করুন।
2. + ক্রেডিট বিকল্পে ক্লিক করুন।
3. নিচে উল্লেখ করা তথ্য লিখুন:

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

4. ক্রেডিট সেভ করুন বিকল্পে ক্লিক করুন।

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

API ব্যবহার করে, কোনও API প্রোডাক্ট বান্ডেলের জন্য সামগ্রিকভাবে অথবা API প্রোডাক্ট বান্ডেলের মধ্যে কোনও নির্দিষ্ট API প্রোডাক্ট ব্যবহারের জন্য ডেভেলপারকে ক্রেডিট ইস্যু করুন।

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

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

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

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

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

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

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

$ 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"
}

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

ক্রেডিট API-এর সাথে ব্যবহার করার জন্য নিম্নলিখিত কোয়েরি প্যারামিটার উপলভ্য: