নেটিভ চেকআউট ওভারভিউ

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

চেকআউট প্রবাহ

নেটিভ ইন্টিগ্রেশনের জন্য আপনাকে একটি RESTful API তৈরি করতে হবে, যেটিকে গুগল চেকআউট সেশন তৈরি ও পরিচালনা করার জন্য কল করতে পারবে।

সামগ্রিক প্রবাহটি নিম্নরূপ:

1. চেকআউট সেশন তৈরি করুন: ব্যবহারকারী এবং ঐচ্ছিকভাবে একজন এজেন্ট সেশনে আইটেম যোগ করার একটি চক্রের মধ্যে থাকেন।
2. গুগল ইউআই-এর কাছে হস্তান্তর: ব্যবহারকারী যখন চেক আউট করার সিদ্ধান্ত নেন, তখন এজেন্ট (যদি নিযুক্ত থাকেন) চেক আউট সেশন ডেটা সহ নিয়ন্ত্রণ গুগল ইউআই-এর কাছে হস্তান্তর করেন।
3. ম্যানুয়াল চেকআউট: ব্যবহারকারী এখন সংবেদনশীল ফুলফিলমেন্ট ও পেমেন্টের বিবরণ পূরণ করতে এবং অর্ডার জমা দিতে শুধুমাত্র গুগল ইউআই (Google UI) ব্যবহার করেন। এই অংশে এজেন্ট জড়িত থাকে না, যা সুনির্দিষ্টতা নিশ্চিত করে।
4. সম্পূর্ণকরণ ও ফেরত: অর্ডারটি নিশ্চিত করার জন্য গুগল ইউআই একটি "ধন্যবাদ" পৃষ্ঠা দেখায়। ঐচ্ছিকভাবে, ব্যবহারকারীকে এজেন্টের কাছে ফেরত পাঠানো যেতে পারে, যাঁকে হয়তো ইতিমধ্যেই কেনাকাটা সম্পন্ন হওয়ার বিষয়ে জানানো হয়েছে।

চেকআউট সেশন স্থিতির জীবনচক্র

ব্যবহারকারী যখন চেকআউট প্রক্রিয়ার মধ্য দিয়ে অগ্রসর হন, তখন আপনাকে অবশ্যই চেকআউট সেশনের status তার বর্তমান অবস্থা অনুযায়ী আপডেট করতে হবে। সেশনটি নিম্নলিখিত জীবনচক্রের মধ্য দিয়ে যায়:

• incomplete : একটি সেশন তৈরি করার সময়কার প্রাথমিক অবস্থা। এটি নির্দেশ করে যে বাধ্যতামূলক তথ্য (যেমন শিপিং পদ্ধতি, কর বা ব্যবহারকারীর বিবরণ) অনুপস্থিত বা গণনা করা হয়নি।
• ready_for_payment : ব্যবহারকারী তার শিপিং ঠিকানা আপডেট করার পর এবং আপনি শিপিং বিকল্প ও মোট মূল্য গণনা করার পরে, কিন্তু অর্থপ্রদানের মাধ্যম চূড়ান্ত করার আগে, এই স্ট্যাটাসটি ব্যবহৃত হবে।
• ready_for_complete : পেমেন্ট মাধ্যম নির্বাচন করা এবং অর্ডারের সমস্ত বিবরণ যাচাই করা হয়ে গেলে, সম্পূর্ণ চেকআউট অবজেক্ট হাইড্রেশনের সময় ব্যবহার করার জন্য স্ট্যাটাস।
• completed : আপনি সফলভাবে পেমেন্ট সম্পন্ন করে অর্ডার দেওয়ার পর প্রাপ্ত চূড়ান্ত অবস্থা।
• canceled : চেকআউট সেশন বাতিল করা হলে এই স্ট্যাটাসটি ফেরত আসে।
• error : যখন কোনো অপূরণীয় ব্যবসায়িক যুক্তির ত্রুটির কারণে চেকআউট করা যায় না, তখন এই স্ট্যাটাসটি ফেরত আসে। এই স্ট্যাটাসটি UCP সংস্করণ 2026-04-08 এবং তার পরবর্তী সংস্করণগুলোতে উপলব্ধ।

একাধিক আইটেম চেকআউট প্রক্রিয়া:

গুগল এখন একটিমাত্র চেকআউট সেশনে একাধিক স্বতন্ত্র লাইন আইটেম সমর্থন করে। এর সাধারণ কার্যপ্রবাহ নিম্নরূপ:

1. ব্যবহারকারী একটি UCP-সক্ষম ইন্টারফেস থেকে চেকআউট শুরু করেন (যেমন, কোনো পণ্যের 'এখনই কিনুন' বোতামে ক্লিক করে)।
2. POST /checkout-sessions কল করা হয় এবং line_items অ্যারের সমস্ত স্বতন্ত্র আইটেম এতে অন্তর্ভুক্ত করা হয়। চেক আউট করা প্রতিটি অনন্য আইটেমের জন্য line_items অ্যারেটিতে একটি পৃথক অবজেক্ট থাকবে।
3. ব্যবহারকারী PUT /checkout-sessions/{id} কল ব্যবহার করে তাদের পেমেন্ট পদ্ধতি, পূরণের বিবরণ আপডেট করতে বা ডিসকাউন্ট প্রয়োগ করতে পারেন।
4. যখন ব্যবহারকারী "Pay with GPay" বোতামে ক্লিক করেন, তখন POST /checkout-sessions/{id}/complete কলটি করা হয়।

প্রমাণীকরণ

যদিও কোনো প্রমাণীকরণের প্রয়োজন নেই, ব্যবসার চেকআউট এপিআই এন্ডপয়েন্ট কল করার জন্য গুগল নিম্নলিখিত বিকল্পগুলো সমর্থন করে।

এপিআই কী

HTTP হেডার: X-API-Key

একটি শেয়ার্ড সিক্রেট ভ্যালু যা গুগলের ইউসিপি এপিআই ক্লায়েন্ট রিকোয়েস্ট এইচটিটিপি হেডারে checkout এন্ডপয়েন্টের সাথে প্রমাণীকরণের জন্য ব্যবহৃত হবে।

OAuth 2.0 (প্রস্তাবিত)

HTTP হেডার: Authorization: Bearer <Access Token>

RFC 6749 অনুসরণ করে, গুগলের UCP প্ল্যাটফর্ম এজেন্ট checkout এন্ডপয়েন্ট ইন্টারঅ্যাকশনের জন্য প্রয়োজনীয় অ্যাক্সেস টোকেন অনুরোধ করতে নিম্নলিখিত প্রোপার্টিগুলো ব্যবহার করে।

ডেভেলপার টুলস

আপনার নেটিভ চেকআউট এপিআই বাস্তবায়নে সহায়তার জন্য, আপনি ইউনিভার্সাল কমার্স প্রোটোকল গিটহাব রিপোজিটরিতে নিম্নলিখিত রিসোর্সগুলো খুঁজে পেতে পারেন:

• ইউসিপি গিটহাব রিপোজিটরি: বিস্তারিত ডকুমেন্টেশন, স্পেসিফিকেশন এবং কমিউনিটি রিসোর্সের জন্য মূল রিপোজিটরিটি ঘুরে দেখুন।
• এসডিকে: আপনার ইন্টিগ্রেশনকে ত্বরান্বিত করতে সফটওয়্যার ডেভেলপমেন্ট কিট ব্যবহার করুন। ভাষা-ভিত্তিক এসডিকে উপলব্ধ আছে, যার মধ্যে রয়েছে:
  • পাইথন এসডিকে
  • জাভাস্ক্রিপ্ট এসডিকে

• সামঞ্জস্য পরীক্ষা: সামঞ্জস্য পরীক্ষা স্যুট ব্যবহার করে UCP স্পেসিফিকেশনের সাথে আপনার API এন্ডপয়েন্টগুলি যাচাই করুন।

  এটি আপনার বাস্তবায়নকে প্রয়োজনীয় মান ও আচরণবিধি মেনে চলতে সাহায্য করে।

আপনার উন্নয়ন ও পরীক্ষণ প্রক্রিয়াকে সুবিন্যস্ত করতে আমরা এই সরঞ্জামগুলি ব্যবহারের জন্য দৃঢ়ভাবে সুপারিশ করছি।

পরিষেবা স্তরের উদ্দেশ্য

নেটিভ চেকআউট REST API এন্ডপয়েন্টগুলোর জন্য নিম্নলিখিত সার্ভিস লেভেল অবজেক্টিভস (SLOs) প্রযোজ্য। গুগলের সাথে ইন্টিগ্রেট করা ব্যবসা প্রতিষ্ঠানগুলোর কাছ থেকে API-এর পারফরম্যান্স এবং প্রাপ্যতার জন্য এই লক্ষ্যমাত্রাগুলো পূরণ করার প্রত্যাশা করা হয়।

৫০তম পার্সেন্টাইল ল্যাটেন্সি নির্দেশ করে যে, কমপক্ষে ৫০% অনুরোধ এই সময়ের মধ্যে সম্পন্ন হবে বলে আশা করা যায়। ৯৫তম পার্সেন্টাইল ল্যাটেন্সি নির্দেশ করে যে, কমপক্ষে ৯৫% অনুরোধ এই সময়ের মধ্যে সম্পন্ন হবে বলে আশা করা যায়।

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

আপনার UCP সংস্করণের জন্য চেকআউট API পেলোড এবং প্রযুক্তিগত বাস্তবায়নের বিবরণ দেখুন:

• সংস্করণ ২০২৬-০৪-০৮ নেটিভ চেকআউট REST API
• সংস্করণ ২০২৬-০১-২৩ নেটিভ চেকআউট REST API