নগদীকরণের সমস্যা সমাধান করা

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

এই বিষয়টিতে সাধারণত দেখা যায় এমন মনিটাইজেশন সমস্যা সমাধানের জন্য তথ্য ও নির্দেশনা প্রদান করা হয়েছে।

ডেভেলপারকে বরখাস্ত করা হয়েছে

লক্ষণ

ডেভেলপারকে সাময়িকভাবে বরখাস্ত করা হয়েছে এবং তিনি আর কোনো অতিরিক্ত মনিটাইজেশন লেনদেন বা এপিআই কল করতে পারবেন না।

ত্রুটির বার্তা 

<error>
   <messages>
        <message>Exceeded developer limit configuration -</message>
        <message>Is Developer Suspended - true</message>
   </messages>
</error>

রোগ নির্ণয়

ডেভেলপারকে সাসপেন্ড করার কারণ জানতে, নিম্নলিখিত ধাপগুলো অনুসরণ করুন:

  1. স্থগিতকৃত ডেভেলপারের সাথে সম্পর্কিত ত্রুটি কোডটি শনাক্ত করতে নিম্নলিখিত API কলটি চালান:
    1. আপনি যদি পাবলিক ক্লাউড ব্যবহারকারী হন, তাহলে নিচের API-টি ব্যবহার করুন: 
      curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org}/suspended-developers/{developer-email}" -u orgadminEmail:password
    2. আপনি যদি একজন প্রাইভেট ক্লাউড ব্যবহারকারী হন, তাহলে নিচের API-টি ব্যবহার করুন: 
      curl -X GET "http://<management-host>:<port#>/v1/mint/organizations/{org}/suspended-developers/{developer-email}" -u orgadminEmail:password
  2. ডেভেলপারকে কেন সাসপেন্ড করা হয়েছিল তা নির্ধারণ করতে এরর কোডটিকে নিম্নলিখিত কারণ কোডগুলোর সাথে তুলনা করুন।

আরও দেখুন: স্থগিত ডেভেলপারদের জন্য কারণ কোডগুলির সারাংশ

কারণ কোড

কারণ

বিস্তারিত

অপর্যাপ্ত তহবিল

ডেভেলপার অ্যাকাউন্টের ব্যালেন্স শেষ হয়ে গেছে

প্রিপেইড ডেভেলপার অ্যাকাউন্টের ব্যালেন্সে অতিরিক্ত কোনো লেনদেনের জন্য পর্যাপ্ত অর্থ না থাকলে, ডেভেলপারকে সাসপেন্ড করা হবে।

পোস্টপেইড ডেভেলপারদের ক্ষেত্রে, এই ত্রুটিটি ঘটতে পারে যদি তারা তাদের ক্রেডিট সীমা অতিক্রম করেন অথবা ব্যবহৃত মুদ্রার জন্য নির্ধারিত ক্রেডিট সীমা শেষ হয়ে যায়।

সীমা লঙ্ঘন করা হয়েছে

রেট_প্ল্যান_রেট_ব্যান্ড_অতিক্রম করেছে

ডেভেলপার আর কোনো লেনদেন করতে অক্ষম।

প্রতিটি ডেভেলপারকে ক্রয়কৃত রেট প্ল্যানের উপর ভিত্তি করে একটি নির্দিষ্ট সংখ্যক লেনদেন করার অনুমতি দেওয়া হয়। লেনদেনের সংখ্যা অতিক্রম করা হলে, ডেভেলপারকে স্থগিত করা হয় এবং তিনি আর কোনো অতিরিক্ত লেনদেন সম্পন্ন করতে পারেন না।

বর্তমানে প্রকাশযোগ্য কোনো সত্তা নেই

ডেভেলপার কোনো রেট প্ল্যান ক্রয় করেননি।

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

সমাধান

ত্রুটি

সমাধানের পদক্ষেপ

অপর্যাপ্ত তহবিল

ডেভেলপারকে নিশ্চিত করতে হবে যে, যেকোনো অতিরিক্ত লেনদেন সম্পন্ন করার জন্য অ্যাকাউন্টে পর্যাপ্ত ব্যালেন্স বা উপলব্ধ ক্রেডিট রয়েছে।

সীমা লঙ্ঘন করা হয়েছে

রেট_প্ল্যান_রেট_ব্যান্ড_অতিক্রম করেছে

  1. ডেভেলপার রেট প্ল্যান এবং লেনদেনের বিবরণ যথাক্রমে পেতে নিম্নলিখিত API কলগুলি করুন:
    • ডেভেলপারের কেনা রেট প্ল্যানগুলোর শুরু এবং শেষের তারিখ পেতে নিম্নলিখিত API কলটি চালান: 
      http://docs.apigee.com/monetize/apis/get/organizations/%7Borg_name%7D/developers/%7Bdeveloper_id%7D/developer-accepted-rateplans
    • ডেভেলপারের করা সফল লেনদেনের সংখ্যা জানতে নিম্নলিখিত API কলটি চালান: 
      http://docs.apigee.com/monetize/apis/get/organizations/%7Borg_name%7D/transactions/developers/%7Bdeveloper_email_or_id%7D

  2. Edge UI-তে, একজন ডেভেলপার কতগুলি কল করতে পারবেন তা নির্বাচন করে আপনি আরও দেখতে পারেন:

    প্যাকেজসমূহ > প্যাকেজের নাম > রেট প্ল্যানের নাম > রেট কার্ড

    উদাহরণস্বরূপ, যদি প্যাকেজের নাম প্রো প্যাকেজ হয় এবং এটি একটি ফ্রি প্ল্যান হয়, তাহলে পাথটি হবে:

    প্যাকেজসমূহ > প্রো প্যাকেজ > ফ্রি প্ল্যান > রেট কার্ড

বর্তমানে প্রকাশযোগ্য কোনো সত্তা নেই

এপিআই কল করতে হলে ডেভেলপারকে একটি রেট প্ল্যান কিনতে হবে।

নগদীকরণ সেটআপ সমস্যা

লক্ষণ

মনিটাইজেশন সেটআপের সমস্যাগুলো বিভিন্ন লক্ষণ হিসেবে প্রকাশ পেতে পারে, যেমন:

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

ত্রুটির বার্তা

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

সম্ভাব্য কারণসমূহ

আপনি যদি 'লক্ষণ' অংশে তালিকাভুক্ত কোনো উপসর্গ দেখতে পান, তাহলে খুব সম্ভবত লেনদেনগুলো নগদীকরণ হচ্ছে না।

কারণ নির্ণয় করা

  1. লেনদেনগুলো নগদীকরণ করা হচ্ছে কিনা তা পরীক্ষা করতে পরবর্তী বিভাগে বর্ণিত ম্যানেজমেন্ট এপিআই কলটি ব্যবহার করুন।

    লেনদেনের অবস্থা দেখুন

  2. যদি নির্দিষ্ট সময়কালের মধ্যে কোনো লেনদেনকে সফল (SUCCESS) হিসেবে তালিকাভুক্ত হতে না দেখেন, তাহলে লেনদেনগুলো থেকে অর্থ উপার্জন করা হয়নি।

লেনদেনগুলো নগদায়ন না হওয়ার সাধারণ কারণগুলো হলো:

নিম্নলিখিত বিভাগগুলিতে প্রতিটি সমস্যা কীভাবে নির্ণয় ও সমাধান করতে হয় তা বর্ণনা করা হয়েছে।

এপিআই প্রক্সিতে নগদীকরণ সীমা যাচাই নীতি ব্যবহার করা হয়নি

রোগ নির্ণয়

  1. এপিআই প্রক্সিগুলোর সাথে মনিটাইজেশন লিমিটস চেক পলিসি সংযুক্ত আছে কিনা তা যাচাই করুন।
  2. যদি পলিসি সংযুক্ত না থাকে, তাহলে লেনদেনগুলো ব্যর্থ (FAILED) হিসেবে তালিকাভুক্ত হওয়ার এটি একটি কারণ হতে পারে।

সমাধান

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

যদি সমস্যাটি অব্যাহত থাকে, তাহলে পরীক্ষা করে দেখুন যে API Product থেকে অর্থ উপার্জন করা হচ্ছে না ।

এপিআই পণ্য থেকে অর্থ উপার্জন করা হয় না

রোগ নির্ণয়

  1. এপিআই প্রোডাক্টটি মনিটাইজড কিনা তা যাচাই করুন (শুধুমাত্র মনিটাইজড এপিআই প্রোডাক্টগুলোই রেট করা হয় এবং ট্রানজ্যাকশনের অধীনে তালিকাভুক্ত থাকবে)। একটি মনিটাইজড প্রোডাক্ট হলো সেটি, যার জন্য অন্তত একটি সক্রিয় রেট প্ল্যান উপলব্ধ থাকে।
  2. মনিটাইজ করা এপিআই প্রোডাক্টগুলোর তালিকা পেতে নিম্নলিখিত ম্যানেজমেন্ট এপিআই কলটি ব্যবহার করুন:
    1. আপনি যদি পাবলিক ক্লাউড ব্যবহারকারী হন, তাহলে নিচের API-টি ব্যবহার করুন: 
      curl -v https://api.enterprise.apigee.com/v1/mint/organizations/{org_id}/products?monetized=true -u orgadminEmail:password
    2. আপনি যদি একজন প্রাইভেট ক্লাউড ব্যবহারকারী হন, তাহলে নিচের API-টি ব্যবহার করুন: 
      curl -v http://<management-host>:<port#>/v1/mint/organizations/{org_id}/products?monetized=true -u orgadminEmail:password
  3. আপনার এপিআই প্রক্সির সাথে যুক্ত এপিআই প্রোডাক্টটি যদি মনিটাইজড না হয়, তাহলে লেনদেনগুলো মনিটাইজড না হওয়ার এটি একটি কারণ হতে পারে।

সমাধান

একটি এপিআই পণ্য থেকে আয় করতে, নিম্নলিখিত ধাপগুলো অনুসরণ করুন:

  1. লেনদেন রেকর্ডিং নীতি কনফিগার করুন ।

  2. যাচাই করুন যে API প্রোডাক্টটির একটি সক্রিয় রেট প্ল্যান আছে।

যদি সমস্যাটি অব্যাহত থাকে, তাহলে ‘Transaction recording policy incorrectly defined’ চেক করুন।

লেনদেন রেকর্ডিং নীতি ভুলভাবে সংজ্ঞায়িত করা হয়েছে

রোগ নির্ণয়

  1. যে এপিআই প্রক্সিতে মনিটাইজেশন লিমিটস চেক পলিসি সংযুক্ত আছে, সেটির জন্য UI ট্রেস সক্রিয় করুন।
  2. UI ট্রেস থেকে একটি নির্দিষ্ট API অনুরোধ নির্বাচন করুন।
  3. Analytics AX ফ্লোটি নির্বাচন করুন এবং নিম্নলিখিত মনিটাইজেশন (মিন্ট) ফ্লো ভেরিয়েবলগুলোর সঠিক মান আছে কিনা তা পরীক্ষা করুন: 
    mint.tx.status - Should match the value set up for "success criteria" in the transaction recording policy for the API product being used. When tracing, the txProviderStatus in the transaction recording policy is stored in the variable 'mint.tx.status'.
mint.tx.app_id - Application id of API product.
mint.tx.prod_id - API product id.

  4. এখানে একটি নমুনা UI ট্রেস দেওয়া হলো যা থেকে বোঝা যায় যে মিন্ট ফ্লো ভেরিয়েবলগুলো সঠিকভাবে সেটআপ করা হয়েছে।

  5. যদি আপনি mint.tx.status ভেরিয়েবলে কোনো ত্রুটি লক্ষ্য করেন, তাহলে এটি নির্দেশ করে যে লেনদেন রেকর্ডিং নীতিটি ভুলভাবে সংজ্ঞায়িত করা হয়েছে।

সমাধান

  1. ট্রানজ্যাকশন রেকর্ডিং পলিসি তৈরি করার সময়, 'Create transaction recording policy'- তে বর্ণিত সমস্ত ধাপ সঠিকভাবে অনুসরণ করা হয়েছে কিনা তা নিশ্চিত করুন।
  2. মূল মানটি হলো ট্রানজ্যাকশন রেকর্ডিং পলিসিতে সেট করা 'ট্রানজ্যাকশন সফলতার মানদণ্ড'। ট্রানজ্যাকশন রেকর্ডিং পলিসিতে ট্রানজ্যাকশন সফলতার মানদণ্ড সেট করার উদাহরণ দেখুন।

ডেভেলপার রেট প্ল্যান ক্রয় করেনি

রোগ নির্ণয়

  1. ডেভেলপার কর্তৃক ক্রয়কৃত রেট প্ল্যানগুলো যাচাই করতে নিম্নলিখিত ম্যানেজমেন্ট এপিআই কলটি ব্যবহার করুন:
    1. আপনি যদি পাবলিক ক্লাউড ব্যবহারকারী হন, তাহলে নিচের API-টি ব্যবহার করুন: 
      curl -v https://api.enterprise.apigee.com/v1/mint/organizations/{org}/developers/{dev_email}/products/{prod}/developer-rateplans -u orgadminEmail:password
    2. আপনি যদি প্রাইভেট ক্লাউড ব্যবহারকারী হন, তাহলে নিচের API-টি ব্যবহার করুন: 
      curl -v http://<management-host>:<port#>/v1/mint/organizations/{org}/developers/{dev_email}/products/{prod}/developer-rateplans -u orgadminEmail:password
  2. উপরোক্ত কলের প্রতিক্রিয়ার ভিত্তিতে, ডেভেলপার কর্তৃক লেনদেনটি সম্পন্ন করার সময় যে প্ল্যানটি সক্রিয় ছিল, সেটি খুঁজে বের করুন।

সমাধান

ডেভেলপারকে অবশ্যই তাদের প্রয়োজন অনুযায়ী রেট প্ল্যান ক্রয় করতে হবে এবং তারপর ট্রানজ্যাকশন/এপিআইগুলো সম্পাদন করতে হবে।

যদি সমস্যাটি অব্যাহত থাকে, তাহলে Apigee Edge Support-এর সাথে যোগাযোগ করুন।