বিলিং সমন্বয় করুন

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

ভূমিকা

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

বিলিং সমন্বয় পৃষ্ঠাটি অন্বেষণ করা

নীচে বর্ণিত পদ্ধতি অনুসারে বিলিং অ্যাডজাস্টমেন্টস পেজটি অ্যাক্সেস করুন।

বিলিং সমন্বয় যোগ করুন

বিলিং সমন্বয় যোগ করতে:

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

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

4. ক্রিয়েট অ্যাডজাস্টমেন্ট-এ ক্লিক করুন।

বিলিং সমন্বয় সম্পাদনা করা

বিলিং সমন্বয় সম্পাদনা করতে:

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

এপিআই ব্যবহার করে বিলিং সমন্বয় করা

নিম্নলিখিত বিভাগগুলিতে এপিআই ব্যবহার করে কীভাবে বিলিং সমন্বয় করতে হয় তা বর্ণনা করা হয়েছে।

এপিআই ব্যবহার করে বিলিং সমন্বয় করা

আপনি /organizations/{org_name}/billing-adjustments-এ একটি POST অনুরোধ পাঠিয়ে বিলিং বিবরণ সামঞ্জস্য করতে পারেন। অনুরোধটি করার সময়, আপনি অনুরোধের মূল অংশে উল্লেখ করবেন:

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

আপনি অন্যান্য বৈশিষ্ট্যও নির্দিষ্ট করতে পারেন, যেমন:

• যে ধরনের লেনদেনের জন্য আপনি সমন্বয়টি প্রয়োগ করতে চান (যেমন একটি ক্রয় লেনদেন)।
• যে ডেভেলপারের জন্য আপনি এই সমন্বয়টি প্রয়োগ করতে চান।
• আপনি এই সমন্বয়টি প্রিপেইড ডেভেলপার, পোস্টপেইড ডেভেলপার, নাকি উভয়ের ক্ষেত্রেই প্রয়োগ করতে চান।
• এপিআই প্যাকেজ যার জন্য আপনি সমন্বয়টি প্রয়োগ করতে চান।
• এপিআই পণ্য, যার জন্য আপনি সমন্বয়টি প্রয়োগ করতে চান।

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

যদি কোনো ঐচ্ছিক প্রপার্টি নির্দিষ্ট করা না থাকে, তাহলে বিলিং ডকুমেন্টের সমন্বয়টি সেই প্রপার্টির জন্য সর্বব্যাপী হবে। উদাহরণস্বরূপ, যদি কোনো ট্রানজ্যাকশন টাইপ নির্দিষ্ট করা না থাকে, তাহলে বিলিং সমন্বয়টি সব ধরনের ট্রানজ্যাকশন টাইপের ক্ষেত্রেই প্রযোজ্য হবে।

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

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

এপিআই ব্যবহার করে বিলিং সমন্বয় দেখা

আপনি একটি নির্দিষ্ট বিলিং অ্যাডজাস্টমেন্ট অথবা একটি প্রতিষ্ঠানের সমস্ত বিলিং অ্যাডজাস্টমেন্ট দেখতে পারেন। একটি নির্দিষ্ট বিলিং অ্যাডজাস্টমেন্ট দেখতে, /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
}

এপিআই ব্যবহার করে বিলিং সমন্বয় আপডেট করা

আপনি /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

এপিআই ব্যবহার করে বিলিং অ্যাডজাস্টমেন্ট মুছে ফেলা

আপনি /organizations/{org_name}/billing-adjustments/{billing_adjustment_id} -এ একটি DELETE অনুরোধ জারি করে একটি বিলিং অ্যাডজাস্টমেন্ট মুছে ফেলতে পারেন, যেখানে {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

এপিআই-এর জন্য বিলিং সমন্বয় কনফিগারেশন সেটিংস

বিলিং সমন্বয়ের জন্য নিম্নলিখিত কনফিগারেশন বিকল্পগুলি উপলব্ধ রয়েছে:

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

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