ওয়েব টপ-আপ API

ইন্টিগ্রেটরদের অবশ্যই টপ-আপ উদ্দেশ্যে ব্যবহারকারীদের পুনঃনির্দেশ করতে একটি ওয়েব হোস্ট প্রয়োগ করতে হবে। এই টপ-আপটি একটি ভিন্ন পদ্ধতি, কিন্তু Android টপ-আপ দ্বারা প্রদত্ত টপ-আপের একই উদ্দেশ্য। এই ওয়েব হোস্টের অবশ্যই একটি মোবাইল-বান্ধব ওয়েব সাইট থাকতে হবে।

ওয়েব হোস্টকে অবশ্যই ব্যবহারকারী-এজেন্ট হেডার মানের উপর ভিত্তি করে মোবাইল ওয়েব অনুরোধ বনাম ডেস্কটপ ওয়েব অনুরোধ নির্ধারণ করতে হবে। মোবাইল ওয়েব অনুরোধে বিতরণ করা পৃষ্ঠাটি অবশ্যই Android এবং iOS-এ মোবাইল ওয়েব বন্ধুত্বপূর্ণ হতে হবে। ব্যবহারকারী-এজেন্ট শিরোনাম মান ছাড়াও, ক্লায়েন্ট আপনাকে পরিবেশের জন্য অন্য কোন ইঙ্গিত দেবে না যেখানে এই ব্যবহারকারী অনুরোধ করছেন (ডেস্কটপ বা ওয়েব)।

সার্ভারকে অবশ্যই GET ব্যবহার করে একটি HTTPS প্রোটোকল প্রয়োগ করতে হবে। পথ এবং হোস্ট ইন্টিগ্রেটর দ্বারা সংজ্ঞায়িত করা হয়। ইন্টিগ্রেটরকে অবশ্যই 2,048 অক্ষরের URL দৈর্ঘ্য সমর্থন করতে হবে। এর মধ্যে রয়েছে স্কিম, হোস্ট, পোর্ট, পাথ এবং প্যারামিটার।

URL-এনকোড হওয়ার আগে সমস্ত প্যারামিটার UTF-8 এনকোড করা হবে।

অনুরোধ

অনুরোধের ভিত্তিতে, Google নিম্নলিখিতগুলি URL প্যারামিটার হিসাবে প্রদান করে:

ক্ষেত্র
gspMajorVersion int

এই অনুরোধের জন্য প্রধান সংস্করণ নম্বর।

gspTopUpRequest TopUpRedirectRequest

টপ আপ অনুরোধ.

gspAssociationId string

একটি শনাক্তকারী রয়েছে যা ইন্টিগ্রেটর ব্যবহারকারী টপ আপ করা অ্যাকাউন্টের জন্য শংসাপত্রগুলি সন্ধান করতে ব্যবহার করে৷ এটি হল অ্যাসোসিয়েশন আইডি যা AssociateAccountRequest এ অ্যাকাউন্ট লিঙ্ক করার সময় পাঠানো হয়।

gspCallbackUrl string

Google-এ টপ-আপ ফ্লো শেষ করার জন্য ব্যবহারকারীকে রিডাইরেক্ট করার URL। এই মান url এনকোড করা হয়.

প্রতিক্রিয়া

টপ-আপ শেষ হলে, ব্যবহারকারীকে অবশ্যই HTTPS GET ব্যবহার করে gspCallbackUrl এ পুনঃনির্দেশিত করতে হবে। এই URL-এ অবশ্যই নিম্নলিখিত ক্যোয়ারী প্যারামিটার থাকতে হবে:

ক্ষেত্র
gspResult int

100
টপ-আপ সফল হয়েছে।
201 ব্যবহারকারী ম্যানুয়ালি প্রবাহ বাতিল করেছে এবং প্রবাহটি বাতিল করা উচিত।
202 একটি মারাত্মক কারণে টপ-আপ ব্যর্থ হয়েছে এবং প্রবাহটি বাতিল করা উচিত৷
redirectRequestId string

প্রয়োজনীয় : রিডাইরেক্ট পেমেন্টের অনুরোধের মূল/শুরুতে পাঠানো requestId । Google এটি প্রেরিত requestId সাথে মেলে তা যাচাই করবে, এবং সম্পূর্ণ পুনঃনির্দেশ প্রবাহ ব্যর্থ হবে যদি এটি মেলে না।
gspTopUpResponse RedirectResponse

প্রয়োজনীয় : TopUpRedirectResponse এনক্রিপ্ট করা উচিত এবং PGP বা JWE+JWS ব্যবহার করে স্বাক্ষর করা উচিত। আরও, এই মান ওয়েব-নিরাপদ base64 এনকোড করা উচিত।