বিলিং অ্যাডজাস্টমেন্ট করা

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

ভূমিকা

মনিটাইজেশন আপনাকে বিলিংয়ের বিবরণে পরিবর্তন করতে দেয়। যেমন, আপনার রেকর্ডে কোনও অসঙ্গতি থাকার কারণে, কোনও নির্দিষ্ট বিলিং মাসের জন্য আপনাকে হয়ত উপার্জনের শেয়ার বা ফি বাড়াতে বা কমাতে হবে।

বিলিং অ্যাডজাস্টমেন্ট পৃষ্ঠা এক্সপ্লোর করা

নিচে যেভাবে বর্ণনা করা হয়েছে সেইভাবে বিলিং অ্যাডজাস্টমেন্ট পৃষ্ঠা অ্যাক্সেস করুন।

বিলিং অ্যাডজাস্টমেন্ট যোগ করা

বিলিং অ্যাডজাস্টমেন্ট যোগ করতে:

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

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

4. অ্যাডজাস্টমেন্ট তৈরি করুন বিকল্পে ক্লিক করুন।

বিলিং অ্যাডজাস্টমেন্ট এডিট করা

বিলিং অ্যাডজাস্টমেন্ট এডিট করতে:

1. বিলিং অ্যাডজাস্টমেন্ট পৃষ্ঠা অ্যাক্সেস করুন।
2. আপনি যে বিলিং অ্যাডজাস্টমেন্ট এডিট করতে চান সেটির উপরে কার্সর নিয়ে যান এবং অ্যাকশন মেনুতে আইকনে ক্লিক করুন।
3. প্রয়োজন অনুযায়ী বিলিং অ্যাডজাস্টমেন্ট আপডেট করুন।
4. অ্যাডজাস্টমেন্ট আপডেট করুন বিকল্পে ক্লিক করুন।

API ব্যবহার করে বিলিং অ্যাডজাস্টমেন্ট করা

API ব্যবহার করে কীভাবে বিলিং অ্যাডজাস্টমেন্ট করা যায় তা নিম্নলিখিত বিভাগ থেকে জানতে পারবেন।

API ব্যবহার করে বিলিং অ্যাডজাস্টমেন্ট করা

আপনি /organizations/{org_name}/billing-adjustments-এ একটি POST অনুরোধ ইস্যু করে বিলিংয়ের বিবরণ অ্যাডজাস্ট করতে পারবেন। অনুরোধ করার সময়, অনুরোধের বডিতে আপনি এগুলি নির্দিষ্ট করেন:

• বিলিং অ্যাডজাস্টমেন্টের নাম।
• অ্যাডজাস্টমেন্টের শতাংশ, অর্থাৎ, ধনাত্মক বা ঋণাত্মক শতাংশের ভ্যালু যা যথাক্রমে বিলের পরিমাণ বাড়ায় বা কমায়।
• বিলিং মাস।
• বিলিং বছর।
• যে সংস্থার ক্ষেত্রে বিলিং অ্যাডজাস্টমেন্ট প্রয়োগ করা হয়েছে।

এছাড়াও, আপনি অন্যান্য প্রপার্টি নির্দিষ্ট করতে পারেন, যেমন:

• আপনি যে ধরনের ট্রানজ্যাকশনের জন্য অ্যাডজাস্টমেন্ট প্রয়োগ করতে চান (যেমন, কেনাকাটা ট্রানজ্যাকশন)।
• আপনি যে ডেভেলপারের জন্য অ্যাডজাস্টমেন্ট প্রয়োগ করতে চান।
• আপনি প্রিপেড ডেভেলপার, পোস্টপেড ডেভেলপার নাকি উভয়ের ক্ষেত্রে অ্যাডজাস্টমেন্ট প্রয়োগ করতে চান।
• যে API প্যাকেজের জন্য আপনি অ্যাডজাস্টমেন্ট প্রয়োগ করতে চান।
• আপনি যে API প্রোডাক্টের জন্য অ্যাডজাস্টমেন্ট প্রয়োগ করতে চান।

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

ঐচ্ছিক প্রপার্টি উল্লেখ করা না থাকলে, বিলিং ডকুমেন্ট অ্যাডজাস্টমেন্টে সেই প্রপার্টির জন্য সবকিছু অন্তর্ভুক্ত থাকবে। যেমন, কোনও ট্রানজ্যাকশনের ধরন উল্লেখ করা না থাকলে, বিলিং অ্যাডজাস্টমেন্ট সব ধরনের ট্রানজ্যাকশনের ক্ষেত্রে প্রযোজ্য হবে।

নিম্নলিখিত উদাহরণে, ২০১৩ সালের জুন মাসের খোলা বিলিং মাসের জন্য বিলিং অ্যাডজাস্টমেন্ট করা হয়েছে। এই অ্যাডজাস্টমেন্ট ৩% ফ্যাক্টর দ্বারা হ্রাস করে এবং এটি কেনাকাটা সংক্রান্ত ট্রানজ্যাকশন, পেমেন্ট প্রোডাক্ট এবং পোস্টপেড ডেভেলপারদের ক্ষেত্রে প্রযোজ্য। কারণ, কোনও নির্দিষ্ট ডেভেলপার বা API প্যাকেজ শনাক্ত করার প্রপার্টি নির্দিষ্ট করা নেই, তাই সমস্ত ডেভেলপার (যারা পোস্টপেড ডেভেলপার) এবং সমস্ত API প্যাকেজের পেমেন্ট প্রোডাক্টের ক্ষেত্রে অ্যাডজাস্টমেন্ট প্রয়োগ করা হবে।

$ curl -H "Content-Type:application/json" -X POST -d \
'{
  "name": "Purchase Adjustment Negative3",
  "adjustmentPercentageFactor": -3,
  "billingMonth": 6,
  "billingYear": 2017,
  "isPublished": false,
  "transactionType": "PURCHASE",
  "developerBillingType": "POSTPAID",
  "organization": {
      "id": "{org_name}" 
  },
  "product": { "id": "payment" }
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/billing-adjustments" \
-u email:password

উত্তরটি এই ধরনের হওয়া উচিত (উত্তরের শুধুমাত্র একটি অংশ দেখানো হয়েছে):

{
  "adjustmentPercentageFactor" : -3,
  "billingMonth" : 6,
  "billingYear" : 2017,
  "developerBillingType" : "POSTPAID",
  "id" : "511144db-7fb1-4c74-bafb-5bc7a6380c9c",
  "isPublished" : false,
  "name" : "Purchase Adjustment Negative3",
  "organization" : {
   ...
  },
  "product" : {
    "customAtt1Name" : "user",
    "description" : "Payment",
    "displayName" : "Payment",
    "id" : "payment",
    "name" : "payment",
    "organization" : {
      ...
    },
    "status" : "CREATED",
    "transactionSuccessCriteria" : "Status=='200 OK'"
  },
  "transactionType" : "PURCHASE"
}

API ব্যবহার করে বিলিং অ্যাডজাস্টমেন্ট দেখা

আপনি কোনও সংস্থার জন্য নির্দিষ্ট বিলিং অ্যাডজাস্টমেন্ট বা সমস্ত বিলিং অ্যাডজাস্টমেন্ট দেখতে পারবেন। নির্দিষ্ট বিলিং অ্যাডজাস্টমেন্ট দেখতে, /organizations/{org_name}/billing-adjustments/{billing_adjustment_id}-এ একটি GET অনুরোধ করুন, যেখানে {billing_adjustment_id} হল নির্দিষ্ট বিলিং অ্যাডজাস্টমেন্টের শনাক্তকারী (আপনি বিলিং অ্যাডজাস্টমেন্ট তৈরি করলে, উত্তরে আইডিটি ফেরত দেওয়া হয়)। যেমন:

$ curl -H "Accept:application/json" -X GET \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/billing-adjustments/511144db-7fb1-4c74-bafb-5bc7a6380c9c" \
-u email:password

কোনও সংস্থার জন্য সব বিলিং অ্যাডজাস্টমেন্ট দেখতে, /organizations/{org_name}/billing-adjustments-এ GET অনুরোধ ইস্যু করুন। যেমন:

$ curl -H "Accept:application/json" -X GET \ 
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/billing-adjustments" \ 
-u email:password

উত্তরটি এই ধরনের হওয়া উচিত (উত্তরের শুধুমাত্র একটি অংশ দেখানো হয়েছে):

{
  "billingAdjustment" : [ {
    "adjustmentPercentageFactor" : -3,
    "billingMonth" : 6,
    "billingYear" : 2017,
    "developerBillingType" : "POSTPAID",
    "id" : "511144db-7fb1-4c74-bafb-5bc7a6380c9c",
    "isPublished" : false,
    "name" : "Purchase Adjustment Negative3",
    "organization" : {
      ...
    },
    "product" : {
      "customAtt1Name" : "user",
      "description" : "Payment",
      "displayName" : "Payment",
      "id" : "payment",
      "name" : "payment",
      "organization" : {
        ...
      },
      "status" : "CREATED",
      "transactionSuccessCriteria" : "Status=='200 OK'"
    },
    "transactionType" : "PURCHASE"
  }, {
    "adjustmentPercentageFactor" : 5.0000,
    "billingMonth" : 5,
    "billingYear" : 2017,
    "id" : "53c363c0-7e1d-4dc1-9392-cf86656225f2",
    "isPublished" : false,
    "monetizationPackage" : {
      "description" : "Communications",
      "displayName" : "Communications",
      "id" : "communications",
      "name" : "Communications",
      "organization" : {
       ...
      },
      "product" : [ {
        "customAtt1Name" : "user",
        "description" : "Messaging",
        "displayName" : "Messaging",
        "id" : "messaging",
        "name" : "messaging",
        "organization" : {
          ...
        },
        "status" : "CREATED"
      }, {
        ...
        },
        "status" : "CREATED",
        "transactionSuccessCriteria" : "Status=='200 OK'"
      } ],
      "status" : "CREATED"
    },
    "name" : "Test Package Adjustment",
    "organization" : {
     ...
    },
    "product" : {
      "customAtt1Name" : "user",
      "description" : "Location",
      "displayName" : "Location",
      "id" : "location",
      "name" : "location",
      "organization" : {
        ...
      },
      "status" : "CREATED",
      "transactionSuccessCriteria" : "Status=='200 OK'"
    }
  } ],
  "totalRecords" : 2
}

API ব্যবহার করে বিলিং অ্যাডজাস্টমেন্ট আপডেট করা

আপনি /organizations/{org_name}/billing-adjustments/{billing_adjustment_id}-এ PUT অনুরোধ ইস্যু করে বিলিং অ্যাডজাস্টমেন্ট আপডেট করতে পারবেন, যেখানে {billing_adjustment_id} হল নির্দিষ্ট বিলিং অ্যাডজাস্টমেন্টের শনাক্তকারী। আপনি আপডেট করার সময়, অনুরোধের বডিতে আপডেট করা প্রপার্টি এবং আপডেট করা বিলিং অ্যাডজাস্টমেন্টের শনাক্তকরণ নির্দিষ্ট করতে হবে। এছাড়াও, বিলিং অ্যাডজাস্টমেন্টের জন্য আপনাকে বাধ্যতামূলক প্রপার্টি উল্লেখ করতে হবে, অর্থাৎ নাম, অ্যাডজাস্টমেন্টের শতাংশ, বিলিং মাস, বিলিং বছর এবং সংস্থার প্রপার্টি।

যেমন, নিম্নলিখিত API কলটি অ্যাডজাস্টমেন্ট পার্সেন্টেজ ফ্যাক্টর ও নাম আপডেট করে (উদাহরণে আপডেট করা প্রপার্টি হাইলাইট করা হয়েছে):

$ curl -H "Content-Type: application/json" -X PUT -d \
'{
  "id" : "511144db-7fb1-4c74-bafb-5bc7a6380c9c ",
  "adjustmentPercentageFactor": -5,
  "name" : "Purchase Adjustment Negative5",
  "billingMonth": 6,
  "billingYear": 2017,
  "isPublished": false,
  "transactionType": "PURCHASE",
  "developerBillingType": "POSTPAID",
  "organization": {
      "id": "{org_name}" 
    },
  "product": { "id": "payment" }
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/billing-adjustments/511144db-7fb1-4c74-bafb-5bc7a6380c9c" \
-u email:password

API ব্যবহার করে বিলিং অ্যাডজাস্টমেন্ট মুছে দেওয়া

আপনি /organizations/{org_name}/billing-adjustments/{billing_adjustment_id}-এ একটি মুছে ফেলার অনুরোধ ইস্যু করে বিলিং অ্যাডজাস্টমেন্ট মুছে দিতে পারেন, যেখানে {billing_adjustment_id} হল মুছে ফেলার জন্য বিলিং অ্যাডজাস্টমেন্টের শনাক্তকরণ। যেমন:

$ curl -H "Accept:application/json" -X GET \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/billing-adjustments/511144db-7fb1-4c74-bafb-5bc7a6380c9c" \
-u email:password

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

বিলিং অ্যাডজাস্টমেন্টের জন্য নিম্নলিখিত কনফিগারেশন বিকল্প উপলভ্য:

পরবর্তী ধাপ

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