ক্লায়েন্ট রেফারেন্স

এই রেফারেন্সে আপনার ওয়েব অ্যাপ্লিকেশনগুলিতে গুগল পে এপিআই (Google Pay API) প্রয়োগ করার জন্য প্রয়োজনীয় জাভাস্ক্রিপ্ট ক্লায়েন্ট মেথডগুলি বর্ণনা করা হয়েছে।

নির্মাতা

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

নতুন পেমেন্টসক্লায়েন্ট(পেমেন্টঅপশন)

যুক্তি

সম্পত্তি বর্ণনা
paymentOptions

একটি অবজেক্ট, যাতে গুগল পে এপিআই কনফিগারেশন ডেটার কী-ভ্যালু পেয়ার থাকে। কনফিগারযোগ্য বিভিন্ন প্রপার্টির জন্য PaymentOptions দেখুন।

উদাহরণ: {environment:'PRODUCTION'}

ফেরত

প্রকার বর্ণনা
google.payments.api.PaymentsClient PaymentsClient অবজেক্ট।

নিক্ষেপ

প্রকার বর্ণনা
Error

প্রদত্ত এনভায়রনমেন্ট প্রপার্টির মানটি সমর্থিত নয়।

অবজেক্ট পদ্ধতি

createButton(options)

ওয়েবপেজে যুক্ত করার জন্য, সর্বশেষ গুগল পে ব্র্যান্ডিং-এ সজ্জিত একটি গুগল পে পেমেন্ট বাটন তৈরি করতে কনভেনিয়েন্স মেথডটি ব্যবহার করা হয়।

তৈরি হওয়া HTMLElement টিতে ডাইনামিকভাবে যুক্ত করা CSS এবং গুগলের CDN-এ হোস্ট করা একটি SVG ইমেজ অন্তর্ভুক্ত রয়েছে।

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

যুক্তি

নাম বর্ণনা
options

একটি অবজেক্ট যা বাটনের কনফিগারেশনের জন্য কী-ভ্যালু পেয়ার ধারণ করে। কনফিগারযোগ্য প্রোপার্টিগুলোর জন্য ButtonOptions দেখুন।

উদাহরণ: {onClick:onGooglePaymentButtonClicked}

ফেরত

প্রকার বর্ণনা
HTMLElement একটি <div> এর মতো জেনেরিক ফ্লো কন্টেন্ট কন্টেইনারের ভিতরে একটি HTML <button> ।

নিক্ষেপ

প্রকার বর্ণনা
Error

একটি প্রয়োজনীয় প্রপার্টি সেট করা নেই।

পরিশোধের জন্য প্রস্তুত (পরিশোধের জন্য প্রস্তুত অনুরোধ)

কোনো ব্যবহারকারী Google Pay API থেকে অর্থপ্রদানের কোনো মাধ্যম ফেরত পাঠাতে পারবেন কিনা, তা নির্ধারণ করতে isReadyToPay(isReadyToPayRequest) মেথডটি ব্যবহার করুন।

যদি ব্রাউজারটি গুগল পে সমর্থন করে, তাহলে isReadyToPay ট্রু true রিটার্ন করে। ব্যবহারকারী কোনো গুগল অ্যাকাউন্টে লগ ইন করেছেন কিনা, বা গুগল পে-তে আগে থেকেই কোনো পেমেন্ট পদ্ধতি সংরক্ষণ করেছেন কিনা তা নির্ধারণ করতে, IsReadyToPayRequest.existingPaymentMethodRequired কে ট্রু ( true সেট করুন এবং রিজলভড প্রমিজে paymentMethodPresent ট্রু true রিটার্ন করছে কিনা তা যাচাই করুন। আরও বিস্তারিত জানতে, IsReadyToPayResponse দেখুন।

যদি PaymentsClient TEST নামক একটি এনভায়রনমেন্ট প্রপার্টি দিয়ে ইনিশিয়ালাইজ করা হয়, তাহলে paymentMethodPresent সর্বদা true রিটার্ন করে।

যুক্তি

নাম বর্ণনা
isReadyToPayRequest একটি অবজেক্ট যাতে মার্চেন্ট কর্তৃক সমর্থিত অর্থপ্রদানের পদ্ধতিগুলো থাকে। কনফিগারযোগ্য বিভিন্ন প্রপার্টি সম্পর্কে বিস্তারিত জানতে, IsReadyToPayRequest দেখুন।

ফেরত

প্রকার বর্ণনা
Promise

সমাধান করা হয়েছে: একটি অবজেক্ট যা ব্যবহারকারীর অর্থ প্রদানের ক্ষমতা সম্পর্কে তথ্য ধারণ করে। আরও তথ্যের জন্য, IsReadyToPayResponse দেখুন।

প্রত্যাখ্যাত: একটি ত্রুটি অবজেক্ট যা প্রত্যাখ্যানের কারণ সম্পর্কে আরও তথ্য ধারণ করে। আরও তথ্যের জন্য, PaymentsError দেখুন।

ত্রুটি

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

পেমেন্ট ডেটা লোড করুন (পেমেন্ট ডেটা অনুরোধ)

এই পদ্ধতিতে একটি গুগল পে পেমেন্ট শিট দেখানো হয়, যেখান থেকে পেমেন্ট পদ্ধতি এবং ঐচ্ছিকভাবে কনফিগার করা প্যারামিটার নির্বাচন করা যায়।

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

যুক্তি

নাম বর্ণনা
paymentDataRequest একটি অবজেক্ট যাতে সম্পূর্ণ গুগল পে এপিআই কনফিগারেশনের কী-ভ্যালু পেয়ার থাকে। কনফিগারযোগ্য প্রোপার্টিগুলোর জন্য PaymentDataRequest দেখুন।

ফেরত

প্রকার বর্ণনা
Promise

সমাধান করা হয়েছে: একটি অবজেক্ট যাতে অনুরোধ করা ক্রেতার ডেটা রয়েছে। আরও তথ্যের জন্য PaymentData দেখুন।

প্রত্যাখ্যাত: একটি অবজেক্ট, যাতে একটি ত্রুটি কোড এবং প্রত্যাখ্যানের কারণ সম্পর্কে আরও তথ্য থাকে। আরও তথ্যের জন্য PaymentsError দেখুন।

ত্রুটি

স্ট্যাটাসকোড বর্ণনা
CANCELED
  • বর্তমান ব্রাউজার বা লগ-ইন করা গুগল ব্যবহারকারী সমর্থিত নয়।
  • ক্রেতা অর্থপ্রদানের অনুমোদন ছাড়াই গুগল পে পেমেন্ট শিটটি বাতিল করে দিয়েছেন।
  • অনুরোধটি এমন একটি নিরাপত্তা প্রেক্ষাপট থেকে শুরু করা হয়েছিল যা পেমেন্ট এজেন্ট বা ব্রাউজার পূরণ না করার সিদ্ধান্ত নিয়েছিল। এটি সাধারণত একটি অসুরক্ষিত ব্রাউজার প্রেক্ষাপট হয়ে থাকে ।
  • গুগল পে পেমেন্ট শিটটি দেখানো থাকা অবস্থাতেই মেথডটি কল করা হয়েছিল।
  • প্রদত্ত PaymentDataRequest অবজেক্টটি গুগল পে পেমেন্ট শিট দ্বারা প্রত্যাখ্যাত হয়েছে। আপনার গেটওয়ের জন্য PaymentMethodTokenizationSpecification প্যারামিটার অনুপস্থিত বা অসম্পূর্ণ থাকা, অথবা প্যারামিটারের মান অবৈধ হওয়া এর একটি সাধারণ কারণ।
DEVELOPER_ERROR প্রদত্ত PaymentDataRequest অবজেক্টটি ভুলভাবে ফরম্যাট করা হয়েছে, এতে ন্যূনতম প্রয়োজনীয় প্যারামিটার অনুপস্থিত, অথবা এতে একটি অবৈধ প্যারামিটার এবং/অথবা মান রয়েছে।

prefetchPaymentData(paymentDataRequest)

পরবর্তী ব্যবহারকারীর ইন্টারঅ্যাকশনে loadPaymentData এক্সিকিউশন টাইম উন্নত করতে PaymentDataRequest কনফিগারেশন প্রিফেচ করার জন্য এই পদ্ধতিটি ব্যবহার করুন। কোনো ভ্যালু রিটার্ন করা হয় না।

অ্যান্ড্রয়েডের জন্য ক্রোমে প্রিফেচ অপটিমাইজেশন উপলব্ধ আছে।

যুক্তি

নাম বর্ণনা
paymentDataRequest একটি অবজেক্ট যা সম্পূর্ণ গুগল পে এপিআই কনফিগারেশনের কী-ভ্যালু পেয়ার ধারণ করে। কনফিগারযোগ্য প্রোপার্টিগুলোর জন্য PaymentDataRequest দেখুন। transactionInfo প্রোপার্টির কোনো পরিবর্তন ক্যাশ করা প্রিফেচ ভ্যালুকে প্রভাবিত করে না।