প্রতিক্রিয়া বস্তু

এই রেফারেন্সটি আপনার ওয়েবসাইটের সাথে ব্যবহার করার জন্য Google Pay API রেসপন্স অবজেক্টের বিকল্পগুলি বর্ণনা করে। রেসপন্স অবজেক্ট হল এমন অবজেক্ট যা Google Pay API ক্লায়েন্ট পদ্ধতি দ্বারা ফেরত পাঠানো হয়।

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

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

সম্পত্তি আদর্শ সর্বদা বিদ্যমান বিবরণ
result বুলিয়ান হাঁ বর্তমান ভিজিটর যে সাইটের জন্য অনুরোধ করছে তাকে পেমেন্টের তথ্য প্রদান করতে সক্ষম। একজন ভিজিটরের পেমেন্ট করার ক্ষমতা তার ওয়েব ব্রাউজারের নির্দিষ্ট পেমেন্ট পদ্ধতির জন্য প্রয়োজনীয় উপাদানগুলি প্রদর্শনের ক্ষমতার সাথে সম্পর্কিত হতে পারে। এর মধ্যে রয়েছে যখন তারা একটি Google অ্যাকাউন্টে লগ ইন করে একটি পেমেন্ট পদ্ধতি প্রদান করে।
paymentMethodPresent বুলিয়ান না

যদি true , তাহলে প্রদত্ত ব্যক্তির allowedPaymentMethods সম্পত্তিতে উল্লেখিত এক বা একাধিক পেমেন্ট পদ্ধতি দর্শকের কাছে রয়েছে। ইজ রেডিটুপে রিকোয়েস্ট ।

শুধুমাত্র তখনই বিদ্যমান যখন existingPaymentMethodRequired কে true হিসেবে সেট করা হয়েছিল ইজ রেডিটুপে রিকোয়েস্ট ।

যদি PaymentsClient TEST এর environment বৈশিষ্ট্য দিয়ে শুরু করা হয়, তাহলে একটি পেমেন্ট পদ্ধতি সর্বদা উপস্থিত বলে বিবেচিত হবে।

উদাহরণ

নিচের উদাহরণটি আপনাকে দেখাবে কখন বর্তমান ভিজিটর অনুরোধকারী সাইটে অর্থপ্রদানের তথ্য সরবরাহ করতে সক্ষম।

{
  "result": true
}

পেমেন্ট ডেটা

এটি একটি রেসপন্স অবজেক্ট যা একজন পেয়ার পেমেন্ট অনুমোদন করার পর Google ফেরত পাঠায়।

সম্পত্তি আদর্শ সর্বদা বিদ্যমান বিবরণ
apiVersion সংখ্যা হাঁ প্রধান API সংস্করণ। প্রতিক্রিয়ার মানটি এতে প্রদত্ত মানের সাথে মিলে যায় PaymentDataRequest ।
apiVersionMinor সংখ্যা হাঁ মাইনর API ভার্সন। প্রতিক্রিয়ার মানটি এতে প্রদত্ত মানের সাথে মিলে যায় PaymentDataRequest ।
paymentMethodData পেমেন্ট মেথডডেটা হাঁ নির্বাচিত পেমেন্ট পদ্ধতি সম্পর্কে তথ্য।
email স্ট্রিং না ইমেল ঠিকানা, যদি emailRequired true হিসেবে সেট করা থাকে পেমেন্ট ডেটা অনুরোধ ।যদি অন্য কোনও অনুরোধে সম্পত্তিটি true সেট করা থাকে তবে কোনও প্রভাব পড়বে না।
shippingAddress জানুন না শিপিং ঠিকানা, যদি shippingAddressRequired true হিসেবে সেট করা থাকে পেমেন্ট ডেটা অনুরোধ ।

উদাহরণ

Google Pay API সংস্করণ 2.0 এর জন্য এই উদাহরণ প্রতিক্রিয়াটি Google Pay পেমেন্ট শিটে নির্বাচিত একটি CARD পেমেন্ট পদ্ধতি দেখায়। example গেটওয়ের জন্য একটি পেমেন্ট পদ্ধতি টোকেন তৈরি করা হয়েছিল।

{
  "apiVersion": 2,
  "apiVersionMinor": 0,
  "paymentMethodData": {
    "type": "CARD",
    "description": "Visa •••• 1234",
    "info": {
      "cardNetwork": "VISA",
      "cardDetails": "1234",
      "cardFundingSource": "CREDIT"
    },
    "tokenizationData": {
      "type": "PAYMENT_GATEWAY",
      "token": "examplePaymentMethodToken"
    }
  }
}

মধ্যবর্তী অর্থপ্রদানের তথ্য

পেমেন্ট শিটে শিপিং ঠিকানা বা শিপিং বিকল্প পরিবর্তন করা হলে Google Pay API onPaymentDataChanged() ইনপুট দ্বারা এই অবজেক্টটি ফেরত পাঠানো হয়।

সম্পত্তি আদর্শ প্রয়োজনীয়তা বিবরণ
callbackTrigger স্ট্রিং ঐচ্ছিক

কেন পেমেন্ট ডেটা কলব্যাক আহ্বান করা হয়েছিল তার কারণ বর্ণনা করে।

  • INITIALIZE
  • SHIPPING_ADDRESS
  • SHIPPING_OPTION
  • OFFER
offerData অফারডেটা ঐচ্ছিক ব্যবহারকারীর দ্বারা প্রদত্ত প্রচারমূলক কোড।
shippingAddress মধ্যবর্তী ঠিকানা ঐচ্ছিক পেমেন্ট শিটে নির্বাচিত ঠিকানা।
shippingOptionData নির্বাচন বিকল্প তথ্য ঐচ্ছিক পেমেন্ট শিটে নির্বাচিত শিপিং বিকল্প।

উদাহরণ

এই উদাহরণে Google Pay API থেকে ফিরে আসা মধ্যবর্তী পেলোড দেখানো হয়েছে।

{
  "callbackTrigger": "SHIPPING_ADDRESS",
  "offerData": {
    "redemptionCode": "exampleCode"
  },
  "shippingAddress": {
    "administrativeArea": "NY",
    "countryCode": "US",
    "locality": "New York",
    "postalCode": "10011"
  },
  "shippingOptionData": {
    "id": "shipping-001"
  }
}

পেমেন্ট মেথডডেটা

এই অবজেক্টটি একটি নির্বাচিত পেমেন্ট পদ্ধতির জন্য ডেটা সরবরাহ করে।

সম্পত্তি আদর্শ সর্বদা বিদ্যমান বিবরণ
type স্ট্রিং হাঁ PaymentMethod Google Pay পেমেন্ট শিটে নির্বাচিত type ।
description স্ট্রিং হাঁ

এই লেনদেনের অর্থ প্রদানের পদ্ধতি বর্ণনা করার জন্য ব্যবহারকারী-মুখী বার্তা।

info বস্তু হাঁ এই সম্পত্তির মূল্য ফেরত দেওয়া অর্থপ্রদানের পদ্ধতির type উপর নির্ভর করে। CARD এর জন্য, CardInfo দেখুন।
tokenizationData পেমেন্ট পদ্ধতিটোকেনাইজেশন ডেটা না নির্বাচিত পেমেন্ট পদ্ধতির জন্য পেমেন্ট টোকেনাইজেশন ডেটা।

উদাহরণ

এই উদাহরণের উত্তরটি দেখায় যে Google Pay পেমেন্ট শিটে নির্বাচিত একটি CARD পেমেন্ট পদ্ধতি কীভাবে example গেটওয়ের জন্য একটি পেমেন্ট পদ্ধতি টোকেন তৈরি করে।

{
  "type": "CARD",
  "description": "Visa •••• 1234",
  "info": {
    "cardNetwork": "VISA",
    "cardDetails": "1234"
  },
  "tokenizationData": {
    "type": "PAYMENT_GATEWAY",
    "token": "examplePaymentMethodToken"
  }
}

কার্ডইনফো

এই অবজেক্টটি নির্বাচিত পেমেন্ট কার্ড সম্পর্কে তথ্য প্রদান করে।

সম্পত্তি আদর্শ সর্বদা বিদ্যমান বিবরণ
cardDetails স্ট্রিং হাঁ কার্ড সম্পর্কে বিস্তারিত তথ্য। এই মানটি সাধারণত নির্বাচিত পেমেন্ট অ্যাকাউন্ট নম্বরের শেষ চারটি সংখ্যা।
assuranceDetails নিশ্চিতকরণবিস্তারিতস্পেসিফিকেশন হাঁ এই অবজেক্টটি ফেরত পেমেন্ট ডেটার উপর সম্পাদিত বৈধতা সম্পর্কে তথ্য প্রদান করে যদি assuranceDetailsRequired true হিসেবে সেট করা থাকে কার্ডপ্যারামিটার ।
cardNetwork স্ট্রিং হাঁ

নির্বাচিত পেমেন্টের পেমেন্ট কার্ড নেটওয়ার্ক। ফেরত দেওয়া মানগুলি allowedCardNetworks এর ফর্ম্যাটের সাথে মেলে কার্ডপ্যারামিটার ।

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

billingAddress জানুন না প্রদত্ত পেমেন্ট পদ্ধতির সাথে সম্পর্কিত বিলিং ঠিকানা, যদি billingAddressRequired true হিসাবে সেট করা থাকে কার্ডপ্যারামিটার ।
cardFundingSource স্ট্রিং হাঁ

নির্বাচিত পেমেন্ট পদ্ধতির জন্য কার্ডের তহবিলের উৎস।

  • UNKNOWN
  • CREDIT
  • DEBIT
  • PREPAID

উদাহরণ

এই উদাহরণে ভিসা নেটওয়ার্কে একটি কার্ড দেখানো হয়েছে।

{
  "cardNetwork": "VISA",
  "cardDetails": "1234",
  "cardFundingSource": "CREDIT",
  "assuranceDetails": {
    "cardHolderAuthenticated": false,
    "accountVerified": true
  }
}

নিশ্চিতকরণবিস্তারিতস্পেসিফিকেশন

এই অবজেক্টটি ফেরত দেওয়া অর্থপ্রদানের শংসাপত্রগুলিতে কী যাচাইকরণ করা হয়েছে সে সম্পর্কে তথ্য প্রদান করে যাতে উপযুক্ত উপকরণ ঝুঁকি পরীক্ষা প্রয়োগ করা যেতে পারে।

নাম আদর্শ বিবরণ
accountVerified বুলিয়ান যদি true , তাহলে বোঝায় যে ফেরত পেমেন্ট শংসাপত্রের উপর Cardholder দখল যাচাইকরণ সম্পন্ন হয়েছে।
cardHolderAuthenticated বুলিয়ান

যদি true , তাহলে বোঝায় যে ফেরত পাঠানো পেমেন্ট শংসাপত্রে সনাক্তকরণ এবং যাচাইকরণ (আইডি এবং ভি) করা হয়েছিল।

যদি false , তাহলে কার্ড লেনদেনের মতো একই ঝুঁকি-ভিত্তিক প্রমাণীকরণ করা যেতে পারে। এই ঝুঁকি-ভিত্তিক প্রমাণীকরণে প্রযোজ্য হলে 3D সিকিউর প্রোটোকলের সাথে ধাপে ধাপে অন্তর্ভুক্ত থাকতে পারে, তবে সীমাবদ্ধ নয়।

আপনি assuranceDetails ফিল্ড ব্যবহার না করলেও Object রিসিভ এবং প্রসেস করতে পারবেন। এই অবজেক্টটি পেতে, Request অবজেক্টের মধ্যে assuranceDetailsRequired: true অন্তর্ভুক্ত করুন। কার্ডপ্যারামিটার ।

পেমেন্ট পদ্ধতিটোকেনাইজেশন ডেটা

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

সম্পত্তি আদর্শ সর্বদা বিদ্যমান বিবরণ
type স্ট্রিং হাঁ নির্বাচিত পেমেন্ট পদ্ধতিতে যে ধরণের টোকেনাইজেশন প্রয়োগ করা হবে। এই মানটি সেট করা type সাথে মেলে PaymentMethodTokenizationSpecification স্পেসিফিকেশন।
token স্ট্রিং না

উৎপন্ন পেমেন্ট পদ্ধতির টোকেন।

উদাহরণ

এটি example গেটওয়ের জন্য প্রস্তুত একটি টোকেনাইজড প্রতিক্রিয়ার একটি উদাহরণ।

{
  "type": "PAYMENT_GATEWAY",
  "token": "examplePaymentMethodToken"
}

পেমেন্ট অনুমোদনের ফলাফল

এই অবজেক্টটি পেমেন্ট অনুমোদনের ফলাফল সম্পর্কে তথ্য প্রদান করে।

সম্পত্তি আদর্শ প্রয়োজনীয়তা বিবরণ
transactionState স্ট্রিং প্রয়োজনীয় লেনদেনের অবস্থা নিম্নলিখিত মার্চেন্ট ফলাফলগুলির মধ্যে একটি দ্বারা সমাধান করা হয়:
  • SUCCESS
  • ERROR
error পেমেন্ট ডেটা ত্রুটি ঐচ্ছিক ব্যবহারকারীর পেমেন্ট শিটে যে ত্রুটিটি দেখানো হবে, যখন পুনরায় পেমেন্ট করার প্রয়োজন হবে।

উদাহরণ

নিম্নলিখিত উদাহরণে পেমেন্ট প্রক্রিয়াকরণের পরে পেমেন্টের ফলাফল রিটার্ন দেখানো হয়েছে:

{
  "transactionState": "ERROR",
  "error": {
    "reason": "PAYMENT_DATA_INVALID",
    "message": "Cannot pay with payment credentials",
    "intent": "PAYMENT_AUTHORIZATION"
  }
}

পেমেন্ট ডেটা ত্রুটি

সম্পত্তি আদর্শ প্রয়োজনীয়তা বিবরণ
reason স্ট্রিং প্রয়োজনীয়

পূর্বনির্ধারিত ত্রুটির কারণগুলির তালিকা:

  • OFFER_INVALID
  • PAYMENT_DATA_INVALID
  • SHIPPING_ADDRESS_INVALID
  • SHIPPING_ADDRESS_UNSERVICEABLE
  • SHIPPING_OPTION_INVALID
  • OTHER_ERROR
message স্ট্রিং প্রয়োজনীয় ব্যবহারকারীর জন্য একটি ত্রুটি বার্তা যা একটি ডায়ালগে প্রদর্শিত হয়।
intent স্ট্রিং প্রয়োজনীয়

ত্রুটির উদ্দেশ্য। এটি অবশ্যই ফ্লো শুরু হওয়ার পর থেকেই PaymentDataRequest এ নিবন্ধিত হতে হবে।

  • OFFER
  • PAYMENT_AUTHORIZATION
  • SHIPPING_ADDRESS
  • SHIPPING_OPTION

উদাহরণ

এই উদাহরণটি পেমেন্ট শিটে রেন্ডার করা ত্রুটির উদ্দেশ্য এবং বার্তাটি দেখায়।

{
  "error": {
    "reason": "SHIPPING_OPTION_INVALID",
    "message": "This shipping option is invalid for the given address",
    "intent": "SHIPPING_OPTION"
  }
}

জানুন

এই অবজেক্টটি একটি অনুরোধকৃত ডাক ঠিকানা সম্পর্কে তথ্য প্রদান করে। সমস্ত বৈশিষ্ট্যই স্ট্রিং।

ঠিকানাগুলি MIN , FULL , এবং FULL-ISO3166 ফর্ম্যাটে ফেরত পাঠানো যেতে পারে। প্রতিটি ফর্ম্যাটের বৈশিষ্ট্যগুলি নিম্নলিখিত টেবিলে দেখা যাবে।

সম্পত্তি ঠিকানার ফর্ম্যাট বিবরণ
name MIN , FULL , FULL-ISO3166 ঠিকানাদাতার পুরো নাম।
postalCode MIN , FULL , FULL-ISO3166 ডাক বা জিপ কোড।
countryCode MIN , FULL , FULL-ISO3166 ISO 3166-1 আলফা-2 দেশের কোড।
phoneNumber MIN , FULL , FULL-ISO3166 একটি টেলিফোন নম্বর, যদি phoneNumberRequired true হিসেবে সেট করা থাকে পেমেন্ট ডেটা অনুরোধ ।
address1 FULL , FULL-ISO3166 ঠিকানার প্রথম লাইন।
address2 FULL , FULL-ISO3166 ঠিকানার দ্বিতীয় লাইন।
address3 FULL , FULL-ISO3166 ঠিকানার তৃতীয় লাইন।
locality FULL , FULL-ISO3166 শহর, শহর, পাড়া, অথবা শহরতলির।
administrativeArea FULL , FULL-ISO3166 একটি দেশের উপবিভাগ, যেমন একটি রাজ্য বা প্রদেশ।
sortingCode FULL , FULL-ISO3166 বাছাই কোড।
iso3166AdministrativeArea FULL-ISO3166 প্রশাসনিক এলাকার সাথে সম্পর্কিত ISO 3166-2 প্রশাসনিক এলাকা কোড।

উদাহরণ

এটি মার্কিন যুক্তরাষ্ট্রে একাধিক লাইনের রাস্তার ঠিকানা ডেটা সহ FULL-ISO3166 ফর্ম্যাট ঠিকানার একটি উদাহরণ। 

{
  "name": "John Doe",
  "address1": "c/o Google LLC",
  "address2": "1600 Amphitheatre Pkwy",
  "address3": "Building 40",
  "locality": "Mountain View",
  "administrativeArea": "CA",
  "countryCode": "US",
  "postalCode": "94043",
  "sortingCode": ""
  "iso3166AdministrativeArea": "US-CA"
}

মধ্যবর্তী ঠিকানা

সম্পত্তি আদর্শ প্রয়োজনীয়তা বিবরণ
administrativeArea স্ট্রিং প্রয়োজনীয় একটি দেশের উপবিভাগ, যেমন একটি রাজ্য বা প্রদেশ।
countryCode স্ট্রিং প্রয়োজনীয় ISO 3166-1 আলফা-2 দেশের কোড।
locality স্ট্রিং প্রয়োজনীয় শহর, শহর, পাড়া, অথবা শহরতলির।
postalCode স্ট্রিং প্রয়োজনীয় দেশের উপর ভিত্তি করে সংশোধিত পোস্টাল কোড। কানাডা এবং যুক্তরাজ্যের জন্য, এতে কেবল প্রথম তিনটি অক্ষর রয়েছে। মার্কিন যুক্তরাষ্ট্রের জন্য, এতে প্রথম পাঁচটি সংখ্যা রয়েছে।
iso3166AdministrativeArea স্ট্রিং ঐচ্ছিক administrativeArea-এর সাথে সম্পর্কিত ISO 3166-2 প্রশাসনিক এলাকা কোড। শিপিং ঠিকানার ফর্ম্যাট FULL-ISO3166 হলেই কেবল এটি উপস্থিত থাকবে।

উদাহরণ

এই উদাহরণটি আপনাকে পেমেন্ট শিটে নির্বাচিত ঠিকানাটি দেখায়। 

{
  "administrativeArea": "NY",
  "countryCode": "US",
  "locality": "New York",
  "postalCode": "10011"
  "iso3166AdministrativeArea": "US-NY"
}

নির্বাচন বিকল্প তথ্য

সম্পত্তি আদর্শ প্রয়োজনীয়তা বিবরণ
id স্ট্রিং প্রয়োজনীয় SelectionOption.id এর সাথে মিলছে

উদাহরণ

এই উদাহরণটি আপনাকে পেমেন্ট শিটে নির্বাচিত শিপিং বিকল্পটি দেখায়। 

{
  "id": "shipping-001"
}

অফারডেটা

এই অবজেক্টটি পেমেন্ট শিটে প্রবেশ করানো একটি অফার কোড সম্পর্কে তথ্য প্রদান করে।

সম্পত্তি আদর্শ প্রয়োজনীয়তা বিবরণ
redemptionCodes অ্যারে সর্বদা বিদ্যমান পেমেন্ট শিটে প্রবেশ করানো প্রচারমূলক কোডের সেট। ইতিমধ্যে অনুমোদিত কোডগুলি অন্তর্ভুক্ত।

উদাহরণ

নিচের উদাহরণে একটি OfferData অবজেক্ট দেখানো হয়েছে যার একটি redemptionCodes অ্যারে রয়েছে। 

"offerData": {
    "redemptionCodes": ["PROMOTIONALCODE"]
}