JSON প্রতিক্রিয়া অবজেক্ট

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

পেমেন্ট ডেটা

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

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

উদাহরণ

গুগল পে এপিআই সংস্করণ ২.০-এর এই উদাহরণ প্রতিক্রিয়াটিতে দেখা যাচ্ছে যে গুগল পে পেমেন্ট শীটে একটি 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"
    }
  }
}

পেমেন্ট পদ্ধতির ডেটা

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

সম্পত্তি প্রকার সর্বদা বিদ্যমান বর্ণনা
type স্ট্রিং হ্যাঁ PaymentMethod গুগল পে পেমেন্ট শীটে নির্বাচিত type ।
description স্ট্রিং হ্যাঁ

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

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

উদাহরণ

এই উদাহরণ প্রতিক্রিয়াটি দেখায় যে, গুগল পে পেমেন্ট শীটে নির্বাচিত একটি 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 , তবে এটি নির্দেশ করে যে ফেরত দেওয়া পেমেন্ট ক্রেডেনশিয়ালটির শনাক্তকরণ ও যাচাইকরণ (ID&V) সম্পন্ন করা হয়েছে।

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

আপনি assuranceDetails ফিল্ডটি ব্যবহার না করলেও রেসপন্স অবজেক্টটি গ্রহণ ও প্রসেস করতে পারেন। এই অবজেক্টটি গ্রহণ করার জন্য, 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 স্ট্রিং প্রয়োজনীয়

পূর্বনির্ধারিত ত্রুটির কারণসমূহের তালিকা:

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

ভুলের উদ্দেশ্য।

  • 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"
}

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

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

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

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

  • INITIALIZE
  • SHIPPING_ADDRESS
  • SHIPPING_OPTION
shippingAddress মধ্যবর্তী ঠিকানা ঐচ্ছিক পেমেন্ট শিটে নির্বাচিত ঠিকানা।
shippingOptionData নির্বাচন বিকল্প ডেটা ঐচ্ছিক পেমেন্ট শীটে নির্বাচিত শিপিং অপশন।

উদাহরণ

এই উদাহরণটি গুগল পে এপিআই থেকে প্রাপ্ত অন্তর্বর্তী পেলোড প্রদর্শন করে। 

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

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

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

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

উদাহরণ

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

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

নির্বাচন বিকল্প ডেটা

সম্পত্তি প্রকার প্রয়োজনীয়তা বর্ণনা
id স্ট্রিং প্রয়োজনীয় SelectionOption.id সাথে মেলে।

উদাহরণ

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

{
  "id": "shipping-001"
}