Google Play Billing-এর বাইরে মনিটাইজেশনের জন্য ব্যাকএন্ড ইন্টিগ্রেশন সংক্রান্ত নির্দেশিকা

Google Play Developer API-তে বিলিং ও লিঙ্ক প্রোগ্রাম থেকে ট্রানজ্যাকশন রিপোর্ট করার জন্য অতিরিক্ত কার্যকারিতা অন্তর্ভুক্ত আছে। এই নির্দেশিকা থেকে আপনি জানতে পারবেন যে কীভাবে এই বিলিং প্রোগ্রাম থেকে ট্রানজ্যাকশন রিপোর্ট করতে হয়।

আপনার ব্যাকএন্ড থেকে এক্সটার্নাল ট্রানজ্যাকশন ম্যানেজ করার জন্য কিছু কম্পোনেন্ট প্রয়োজন হতে পারে। এগুলি তৈরি করতে, আপনাকে Google Play Developer API কনফিগার করুন-এ নির্দেশিত হিসাবে আপনার ব্যাকএন্ড ইন্টিগ্রেশন সেট-আপ করতে হবে। বিলিং ও লিঙ্ক প্রোগ্রামের সাথে সম্পর্কিত নয় এমন ডেভেলপার ব্যাকএন্ড কার্যকারিতা তৈরি করতে, Google Play-এর বিলিং সিস্টেম দেখুন।

শব্দকোষ

এই গাইডে ব্যবহৃত শব্দ সংক্রান্ত কনভেনশন:

  • বিলিং ও লিঙ্ক প্রোগ্রাম: Google Play-এর বাইরে ডিজিটাল কন্টেন্ট কেনা বা অ্যাপ ডাউনলোড করার সুবিধা প্রদানকারী প্রোগ্রাম। এর মধ্যে বিকল্প বিলিং এবং এক্সটার্নাল কন্টেন্ট প্রোগ্রাম অন্তর্ভুক্ত।
  • এক্সটার্নাল ট্রানজ্যাকশন API: উপযুক্ত বিলিং ও লিঙ্ক প্রোগ্রামের জন্য ট্রানজ্যাকশন রিপোর্ট করতে API ব্যবহার করা হয়।
  • এক্সটার্নাল ট্রানজ্যাকশন: বিকল্প বিলিং এবং এক্সটার্নাল কন্টেন্ট প্রোগ্রাম দ্বারা সংজ্ঞায়িত অ্যাপের বাইরে হওয়া একটি উপযুক্ত ট্রানজ্যাকশন।
  • এক্সটার্নাল ট্রানজ্যাকশন টোকেন: Play Billing Library-এর মাধ্যমে আপনাকে প্রদান করা টোকেন, যা ব্যবহারকারী এক্সটার্নাল ট্রানজ্যাকশন শুরু করলে আপনি ব্যবহার করতে পারবেন। এই টোকেনটি Google Play-কে একটি অনুমোদিত এক্সটার্নাল ট্রানজ্যাকশন সম্পর্কে জানাতে ব্যবহার করা হয়।
  • এক্সটার্নাল ট্রানজ্যাকশন আইডি: এক্সটার্নাল ট্রানজ্যাকশন শনাক্ত করার জন্য আপনার তৈরি করা অনন্য শনাক্তকারী।

Play Console-এর অনুমতি কনফিগার করা

এক্সটার্নাল ট্রানজ্যাকশন সম্পর্কে অভিযোগ জানাতে বা রিফান্ড করতে externaltransactions API কল করতে, Google Play Console-এ আপনার পরিষেবা অ্যাকাউন্টকে অর্ডার ও সাবস্ক্রিপশন ম্যানেজ করুন অনুমতি দিন। আপনি অ্যাকাউন্ট লেভেলে বা নির্দিষ্ট অ্যাপের জন্য এই অনুমতি দিতে পারেন।

Play Console-এ পরিষেবা অ্যাকাউন্ট তৈরি করা এবং অনুমতি দেওয়ার ব্যাপারে নির্দেশাবলী পেতে, পরিষেবা অ্যাকাউন্ট ব্যবহার করুন দেখুন। Play Console-এর অনুমতি সম্পর্কে আরও জানতে, ডেভেলপার অ্যাকাউন্টের ব্যবহারকারী যোগ করা ও অনুমতি ম্যানেজ করা দেখুন।

Google Play-তে নতুন এক্সটার্নাল ট্রানজ্যাকশন সম্পর্কে রিপোর্ট করা

externaltransactions API-এর সাথে ইন্টিগ্রেট করুন যাতে আপনি Google Play-এর বিলিং সিস্টেমের বাইরে হওয়া ট্রানজ্যাকশন সম্পর্কে রিপোর্ট করতে পারেন। এটি সেইসব দেশে প্রযোজ্য যেখানে এই সুবিধা উপলভ্য আছে। এর মধ্যে ফ্রি ট্রায়াল কেনাকাটা এবং অ্যাপ ইনস্টল করার ফলে হওয়া $০ ট্রানজ্যাকশনও অন্তর্ভুক্ত। বিকল্প বিলিং এবং এক্সটার্নাল কন্টেন্ট প্রোগ্রামের অধীনে অনুমোদিত হিসেবে উপযুক্ত ব্যবহারকারীর দেশের জন্য আপনাকে শুধুমাত্র বিলিং এবং লিঙ্ক প্রোগ্রামে ট্রানজ্যাকশন শুরু করতে এবং রিপোর্ট করতে হবে; অন্যথায়, API কল বাতিল করা হবে। নতুন কেনাকাটা, রিনিউ করা, টপ-আপ, আপগ্রেড, ডাউনগ্রেড ও অ্যাপ ডাউনলোড সহ সব ট্রানজ্যাকশনের ক্ষেত্রে এটি প্রযোজ্য।

এক্সটার্নাল ট্রানজ্যাকশন রিপোর্টিং

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

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

প্রাথমিক ট্রানজ্যাকশন সম্পর্কে অভিযোগ জানানো

বিলিং ও লিঙ্ক প্রোগ্রামে প্রতিবার নতুন কেনাকাটা বা অ্যাপ ডাউনলোড অনুমোদিত হলে, আপনাকে অবশ্যই externaltransactions API কল করতে হবে।

অ্যাপ ডাউনলোড, এক-বার ক্রয় এবং রেকারিং কেনাকাটার (যেমন, সাবস্ক্রিপশন) ক্ষেত্রে প্রথমবার ট্রানজ্যাকশনের জন্য অনুরোধের প্রধান অংশের অংশ হিসেবে Google Play Billing Library-এর মাধ্যমে অ্যাপের পাওয়া externalTransactionToken প্রয়োজন। একে প্রাথমিক ট্রানজ্যাকশন বলা হয়। প্রাথমিক ট্রানজ্যাকশনের পরে, নতুন অনন্য externalTransactionId প্রদান করে পরবর্তী ট্রানজ্যাকশন (যেমন সাবস্ক্রিপশন রিনিউ করা) সম্পর্কে রিপোর্ট করুন। আরও তথ্যের জন্য, কেনাকাটার জন্য পরবর্তী ট্রানজ্যাকশন সম্পর্কে অভিযোগ করুন দেখুন।

উদাহরণ:

  1. ডেভেলপার তার অ্যাপে বিকল্প বিলিং কনফিগার ও চালু করেন।
  2. ব্যবহারকারী ১ দক্ষিণ কোরিয়াতে আছেন, এটি একটি কাজ করে এমন দেশ এবং তিনি product1 কেনার চেষ্টা করছেন, প্রতি মাসে ১২৬৩৪.১০KRW দিয়ে, এক মাসের ফ্রি ট্রায়াল অফার সহ।
  3. অ্যাপটি product1-এর জন্য ProductDetails এবং ব্যবহারকারীর বেছে নেওয়া অফারের সাথে পারচেজ ফ্লো চালু করে।
  4. ব্যবহারকারী ১ ডেভেলপারের বিলিংয়ের বিকল্প সিস্টেম বেছে নেন।
  5. UserChoiceBillingListener, my_token ভ্যালু externalTransactionToken হিসেবে রিসিভ করে।
  6. ডেভেলপার তখন তার ব্যাকএন্ডে প্রাসঙ্গিক তথ্য পাঠান (externalTransactionToken ভ্যালু এবং প্রোডাক্ট কেনা হচ্ছে)। তারপর, তারা বিকল্প বিলিং সিস্টেমে product1-এর জন্য পারচেজ ফ্লো লঞ্চ করে। এই ট্রানজ্যাকশনের জন্য ডেভেলপার সাইডে একটি অনন্য ট্রানজ্যাকশন আইডি অ্যাসাইন করা হয়েছে যা Google Play-তে রিপোর্ট করতে ব্যবহৃত হয়: 123-456-789। ব্যবহারকারী ফ্রি ট্রায়াল পেলেও, ট্রানজ্যাকশন আইডি প্রয়োজন।
  7. বিলিংয়ের বিকল্প সিস্টেমে কেনাকাটার জন্য ট্রানজ্যাকশন হওয়ার পরে, ডেভেলপার নিম্নলিখিত অনুরোধ সহ Google Play-তে ট্রানজ্যাকশন রিপোর্ট করেন। এটি প্রাথমিকভাবে শূন্য-ডলারের ট্রানজ্যাকশন হিসেবে রিপোর্ট করা হয় কারণ ব্যবহারকারী এক মাস বিনামূল্যে পান।
POST /androidpublisher/v3/applications/com.myapp.android/externalTransactions?externalTransactionId=123-456-789

Body
 {
"originalPreTaxAmount" : {
   "priceMicros" : "0",
   "currency" : "KRW"
 },
 "originalTaxAmount" : {
   "priceMicros" : "0",
   "currency" : "KRW"
 },
"transactionTime" : "2022-02-22T12:45:00Z",
 "recurringTransaction" : {
   "externalTransactionToken" : "my_token",
   "externalSubscription" : {
     "subscriptionType" : "RECURRING"
   }
 },
 "userTaxAddress" : {
   "regionCode" : "KR"
 }
}

প্রাথমিক ট্রানজ্যাকশন সম্পর্কে অভিযোগ জানানোর সময়, নিম্নলিখিত বিষয়গুলি মনে রাখবেন:

  • subscriptionType-এর ভ্যালু RECURRING (অটোমেটিক রিনিউ হওয়া সাবস্ক্রিপশনের জন্য) অথবা PREPAID (প্রিপেড সাবস্ক্রিপশনের জন্য) হতে পারে।
  • OtherRecurringProduct অবশ্যই এককালীন কেনাকাটার ক্ষেত্রে ব্যবহার করতে হবে যার জন্য একাধিক পেমেন্ট বা দেরিতে পেমেন্ট করতে হয়। যেমন, প্রি-অর্ডারের ক্ষেত্রে প্রথমে $০ ট্রানজ্যাকশন হতে পারে এবং পরে প্রি-অর্ডার সম্পূর্ণ হলে SKU-এর দামের জন্য দ্বিতীয় ট্রানজ্যাকশন হতে পারে। পরবর্তী ট্রানজ্যাকশন সম্পর্কে অভিযোগ জানানোর ব্যাপারে আরও জানতে, কোনও কেনাকাটার জন্য পরবর্তী ট্রানজ্যাকশন সম্পর্কে অভিযোগ জানান দেখুন।
  • প্রাথমিক এক্সটার্নাল অফার ট্রানজ্যাকশন রিপোর্ট করার সময় আপনাকে অবশ্যই ExternalOfferDetails প্রদান করতে হবে। পরবর্তী ট্রানজ্যাকশনের জন্য এটি করার প্রয়োজন নেই।

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

POST /androidpublisher/v3/applications/com.myapp.android/externalTransactions?externalTransactionId=123-456-789

Body
 {
"originalPreTaxAmount" : {
   "priceMicros" : "0",
   "currency" : "INR"
 },
 "originalTaxAmount" : {
   "priceMicros" : "0",
   "currency" : "INR"
 },
"transactionTime" : "2023-11-01T12:45:00Z",
 "recurringTransaction" : {
   "externalTransactionToken" : "my_token",
   "externalSubscription" : {
     "subscriptionType" : "RECURRING"
   }
 },
 "userTaxAddress" : {
   # Tax varies in India based on state, so include that information in
   # administrativeArea
   "regionCode" : "IN",
   "administrativeArea" : "KERALA"
 }
}

এক্সটার্নাল অফার

রিপোর্ট করা ট্রানজ্যাকশনটি এক্সটার্নাল অফার প্রোগ্রামের অধীনে হলে, ট্রানজ্যাকশনটি এককালীন ট্রানজ্যাকশন বা রেকারিং সিরিজের প্রথম ট্রানজ্যাকশন হলে আপনাকে অবশ্যই externalOfferDetails ফিল্ড সেট করতে হবে:

  • অ্যাপ ডাউনলোড ট্রানজ্যাকশন রিপোর্ট করার সময়, linkType-এর ভ্যালু LINK_TO_APP_DOWNLOAD হিসেবে সেট করুন এবং installedAppPackage ও installedAppCategory-এর জন্য উপযুক্ত ভ্যালু প্রদান করুন। অ্যাপ ডাউনলোড সম্পর্কে অভিযোগ জানান লিঙ্কটি দেখুন।
  • ডিজিটাল কন্টেন্ট অফার ট্রানজ্যাকশন রিপোর্ট করার সময়, linkType-কে LINK_TO_DIGITAL_CONTENT_OFFER-এ সেট করুন।
  • এক্সটার্নাল অফার প্রোগ্রামের মাধ্যমে কোনও এক্সটার্নাল অ্যাপ ইনস্টল করা হলে, আপনাকে এক্সটার্নাল অ্যাপে করা ট্রানজ্যাকশন সম্পর্কে জানাতে হবে। এইসব ট্রানজ্যাকশন সম্পর্কে জানানোর সময়, এগুলিকে আসল অ্যাপ ডাউনলোড ইভেন্টের সাথে লিঙ্ক করুন:
    • অ্যাপ ডাউনলোড ইভেন্ট থেকে externalTransactionToken প্রদান করুন।
    • externalOfferDetails ফিল্ডে, অ্যাপ ডাউনলোড ইভেন্টের externalTransactionId-এ appDownloadEventExternalTransactionId সেট করুন। externalOfferDetails-এর অন্যান্য ফিল্ডের প্রয়োজন নেই।

এক্সটার্নাল অফারের মাধ্যমে ডাউনলোড করা এক্সটার্নাল অ্যাপে ট্রানজ্যাকশনের জন্য অনুরোধের উদাহরণ:

POST /androidpublisher/v3/applications/com.myapp.android/externalTransactions?externalTransactionId=ABC-DEF-GHI

Body
 {
"originalPreTaxAmount" : {
   "priceMicros" : "990000", # 0.99 EUR
   "currency" : "EUR"
 },
 "originalTaxAmount" : {
   "priceMicros" : "90000", # 0.09 EUR
   "currency" : "EUR"
 },
"transactionTime" : "2025-11-22T12:45:00Z",
 "oneTimeTransaction" : {
   "externalTransactionToken" : "my_external_transaction_token_for_link_to_download_event"
 },
 "userTaxAddress" : {
   "regionCode" : "DE"
 },
 "externalOfferDetails" : {
   "appDownloadEventExternalTransactionId" : "my_external_transaction_id_for_link_to_download_event"
 }
}

ইউরোপীয় অর্থনৈতিক অঞ্চলের (EEA) ব্যবহারকারীদের জন্য বিভিন্ন ধরনের ট্রানজ্যাকশনের ক্ষেত্রে Play পরিষেবা ফি সংক্রান্ত আপডেট করা বিবরণ এক্সটার্নাল অফার প্রোগ্রামে পরিবর্তন থেকে পাওয়া যাবে।

কোনও কেনাকাটার জন্য পরবর্তী ট্রানজ্যাকশন সম্পর্কে অভিযোগ জানানো

কিছু ক্ষেত্রে, একই এক্সটার্নাল কেনাকাটার সাথে একাধিক ব্যবহারকারীর পেমেন্ট যুক্ত থাকে, যেমন সাবস্ক্রিপশন রিনিউ করা বা প্রিপেড প্ল্যান টপ-আপ করা। আপনি Externaltransactions-এ একই API ব্যবহার করে এইসব পরবর্তী ট্রানজ্যাকশন সম্পর্কে অভিযোগ জানাতে পারবেন। নতুন কেনাকাটার ব্যাপারে অভিযোগ জানান বিভাগে যেমন বর্ণনা করা হয়েছে, পরবর্তী ট্রানজ্যাকশনের জন্য externalTransactionToken-এর প্রয়োজন নেই। পরিবর্তে, প্রতিটি রিনিউয়াল বা টপ-আপ ট্রানজ্যাকশনের জন্য কোয়েরি প্যারামিটার হিসেবে একটি নতুন অনন্য externalTransactionId পাঠানো হয়, যার মধ্যে initialExternalTransactionId ফিল্ডে প্রাথমিক ট্রানজ্যাকশনের আইডি অন্তর্ভুক্ত থাকে।

আগের উদাহরণ অনুযায়ী:

  1. ব্যবহারকারী ১-এর প্রথম রিনিউয়াল বিলিংয়ের বিকল্প সিস্টেমে হয়। প্রাথমিক ট্রানজ্যাকশন আইডি ছিল ১২৩-৪৫৬-৭৮৯।
  2. ডেভেলপার URL কোয়েরি প্যারামিটারে ট্রানজ্যাকশনের পুনরাবৃত্তি রিপোর্ট করেন এই নতুন ট্রানজ্যাকশনের জন্য এক্সটার্নাল ট্রানজ্যাকশন আইডি হিসেবে, যেখানে initialExternalTransactionId ফিল্ডে প্রাথমিক ট্রানজ্যাকশনের এক্সটার্নাল ট্রানজ্যাকশন আইডি উল্লেখ করা হয়।

অনুরোধের উদাহরণ:

POST /androidpublisher/v3/applications/com.myapp.android/externalTransactions?externalTransactionId=abc-def-ghi

Body
 {
"originalPreTaxAmount" : {
   "priceMicros" : "12634000000", # 12634 KRW
   "currency" : "KRW"
 },
 "originalTaxAmount" : {
   "priceMicros" : "1263000000", # 1263 KRW
   "currency" : "KRW"
 },
"transactionTime" : "2022-02-22T12:45:00Z",
 "recurringTransaction" : {
   "initialExternalTransactionId" : "123-456-789",

   "externalSubscription" : {
     "subscriptionType" : "RECURRING"
   }
 },
 "userTaxAddress" : {
   "regionCode" : "KR"
 }
}

আপগ্রেড বা ডাউনগ্রেড সম্পর্কে অভিযোগ জানানো

ব্যবহারকারী বিলিংয়ের বিকল্প সিস্টেমে সাবস্ক্রিপশন নিলে, আপগ্রেড বা ডাউনগ্রেড সম্পর্কে রিপোর্ট করতে, আপনি Externaltransactions API-তে একই এন্ডপয়েন্ট ও ফাংশন ব্যবহার করেন এবং আপগ্রেড বা ডাউনগ্রেড ট্রানজ্যাকশনের জন্য অ্যাপে প্রদান করা externalTransactionToken পাঠান। এটি নতুন কেনাকাটার ব্যাপারে অভিযোগ জানানোর মতোই কাজ করে।

অ্যাপ ডাউনলোড সম্পর্কে অভিযোগ জানানো

এক্সটার্নাল অফার বিলিং সিস্টেমে অ্যাপ ইনস্টল করার বিষয়ে রিপোর্ট করতে, আপনাকে অবশ্যই Externaltransactions.createexternaltransaction কল করতে হবে, অ্যাপে প্রদান করা externalTransactionToken পাঠাতে হবে। এটি একটি শূন্য-খরচ, এককালীন ট্রানজ্যাকশন হিসেবে রিপোর্ট করুন; এই প্রসেসটি প্রাথমিক ট্রানজ্যাকশন রিপোর্ট করার মতোই। অনুরোধের প্রধান অংশে ExternalOfferDetails অন্তর্ভুক্ত করতে ভুলবেন না।

অনুরোধের উদাহরণ:

POST /androidpublisher/v3/applications/com.myapp.android/externalTransactions?externalTransactionId=123-456-789

Body
 {
"originalPreTaxAmount" : {
   "priceMicros" : "0",
   "currency" : "USD"
 },
 "originalTaxAmount" : {
   "priceMicros" : "0",
   "currency" : "USD"
 },
"transactionTime" : "2025-12-22T12:45:00Z",
 "oneTimeTransaction" : {
   "externalTransactionToken" : "my_token",
 },
 "userTaxAddress" : {
   "regionCode" : "US"
 },
 "externalOfferDetails" : {
   "linkType" : "LINK_TO_APP_DOWNLOAD",
   "installedAppPackage" : "my.external.app",
   "installedAppCategory" : "APP"
 }
}

বিকল্প বিলিং ট্রানজ্যাকশনের ম্যানুয়াল রিপোর্টিং থেকে মাইগ্রেট করা

অটোমেটেড রিপোর্টিং ছাড়া বিকল্প বিলিং অফার করার সময় শুরু হওয়া অ্যাক্টিভ সাবস্ক্রিপশন মাইগ্রেট করতে, initialExternalTransactionId বা externalTransactionToken উল্লেখ করার পরিবর্তে migratedTransactionProgram ফিল্ড ব্যবহার করে একটি নতুন জিরো-কস্ট ট্রানজ্যাকশন তৈরি করুন। transactionTime-এর সময়টি সেই সময় হিসেবে সেট করুন যখন ব্যবহারকারী প্রতিটি অ্যাক্টিভ সাবস্ক্রিপশনের জন্য প্রাথমিকভাবে সাইন-আপ করেছিলেন। এর পরে, API-এর মাধ্যমে স্বাভাবিকভাবে এই সাবস্ক্রিপশনের জন্য প্রতিটি পরবর্তী ট্রানজ্যাকশন রিপোর্ট করুন, রিনিউয়াল ট্রানজ্যাকশন তৈরি করতে আগে ব্যবহার করা initialExternalTransactionId প্রদান করুন। সাবস্ক্রিপশন মাইগ্রেট করা হয়ে গেলে, আপনাকে আর সাবস্ক্রিপশনের পরবর্তী ট্রানজ্যাকশন ম্যানুয়ালি রিপোর্ট করতে হবে না, তবে এই পৃষ্ঠায় বর্ণিত অটোমেটেড পদ্ধতির মাধ্যমে রিপোর্ট করা হচ্ছে কিনা তা দেখে নিতে হবে।

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

migratedTransactionProgram ফিল্ডটি শুধুমাত্র ম্যানুয়াল রিপোর্টিং থেকে মাইগ্রেট করার সময় ব্যবহার করা যেতে পারে। ম্যানুয়াল রিপোর্টিং আর কাজ না করলে এটি বন্ধ করে দেওয়া হবে।

অনুরোধের উদাহরণ:

# Note that the externalTransactionId specified here will used to report
# subsequent transactions.

POST /androidpublisher/v3/applications/com.myapp.android/externalTransactions?externalTransactionId=abc-def-ghi

Body
 {
 # Be sure to set the price to 0 for this transaction since it does not reflect
 # an actual subscription renewal.
 "originalPreTaxAmount" : {
   "priceMicros" : "0",
   "currency" : "KRW"
 },
 "originalTaxAmount" : {
   "priceMicros" : "0",
   "currency" : "KRW"
 },

 # The transaction time should be set to when the user signed up for this
 # subscription.
 "transactionTime" : "2022-02-22T12:45:00Z",
  "recurringTransaction" : {
    "migratedTransactionProgram" : "USER_CHOICE_BILLING",

    "externalSubscription" : {
      "subscriptionType" : "RECURRING"
    }
  },
 "userTaxAddress" : {
   "regionCode" : "KR"
 }
}

Play পার্টনার প্রোগ্রামের জন্য প্রয়োজনীয়তা

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

Google Play-তে কেনাকাটার রিফান্ড সম্পর্কে রিপোর্ট করা

Google Play-এর বিলিং সিস্টেমের বাইরে ব্যবহারকারীদের রিফান্ড করা ট্রানজ্যাকশনের রিপোর্ট করতে externaltransactions API-এর সাথে ইন্টিগ্রেট করুন। কোন ট্রানজ্যাকশন রিফান্ড করা হয়েছে তা Play যাতে সঠিকভাবে শনাক্ত করতে পারে, তার জন্য আপনাকে URL প্যারামিটারের অংশ হিসেবে আগে রিপোর্ট করা ট্রানজ্যাকশনের জন্য সংশ্লিষ্ট externalTransactionId অন্তর্ভুক্ত করতে হবে।

সাবস্ক্রিপশন কেনাকাটার রিফান্ড সম্পর্কে অভিযোগ করার সময়, সাবস্ক্রিপশনের নির্দিষ্ট পুনরাবৃত্তির externalTransactionId উল্লেখ করুন, যেটি রিফান্ড করা হচ্ছে।

উদাহরণ: ধরুন, কোনও সাবস্ক্রিপশনে নিম্নলিখিত ট্রানজ্যাকশন আছে:

  • এক্সটার্নাল ট্রানজ্যাকশন আইডি ABC.1234-5678-9012-34567 সহ একটি প্রাথমিক ট্রানজ্যাকশন

  • এক্সটার্নাল ট্রানজ্যাকশন আইডি ABC.1234-5678-9012-34567..0-এর সাথে প্রথম রেকারিং ট্রানজ্যাকশন

  • এক্সটার্নাল ট্রানজ্যাকশন আইডি ABC.1234-5678-9012-34567..1 সহ দ্বিতীয় রেকারিং ট্রানজ্যাকশন

সাবস্ক্রিপশনের জন্য সব ট্রানজ্যাকশনের রিফান্ডের রিপোর্ট করতে, আপনাকে তিনটি আলাদা রিফান্ডের অনুরোধ করতে হবে: একটি প্রাথমিক ট্রানজ্যাকশনের জন্য এবং দুটি পরবর্তী ট্রানজ্যাকশনের জন্য।

এই পদ্ধতিতে ফুল রিফান্ড (যেখানে রিফান্ডের পরিমাণ মূল এক্সটার্নাল ট্রানজ্যাকশনে ব্যবহারকারীর পেমেন্ট করা পরিমাণের সমান) এবং আংশিক রিফান্ড (যেখানে রিফান্ডের পরিমাণ মূল এক্সটার্নাল ট্রানজ্যাকশনে ব্যবহারকারীর পেমেন্ট করা পরিমাণের চেয়ে কম) দুটিই করা যায়। আংশিক রিফান্ডের জন্য, আপনাকে ট্যাক্স-পূর্ববর্তী রিফান্ড করা পরিমাণ উল্লেখ করতে হবে।

API কোটা

Google Play Developer API-এর অন্যান্য এন্ডপয়েন্টের মতোই, Externaltransactions API-এর সব কলের ক্ষেত্রে API কোটা প্রযোজ্য।

এছাড়াও, Externaltransactions API-এর ক্ষেত্রে Externaltransactions.createexternaltransaction বা Externaltransactions.refundexternaltransaction-এ কল করার জন্য প্রতি মিনিটে ১,২০০ কোয়েরি (QPM) করার সীমা আছে। Externaltransactions.getexternaltransaction-এ করা কল এই ১,২০০ QPM সীমার মধ্যে ধরা হয় না।