গুগল পে পেমেন্ট হ্যান্ডলারের স্পেসিফিকেশন

  • হ্যান্ডলারের নাম: com.google.pay
  • সংস্করণ: 2026-01-11

1. ভূমিকা

com.google.pay হ্যান্ডলার ব্যবসাগুলিকে UCP-সামঞ্জস্যপূর্ণ প্ল্যাটফর্মের মাধ্যমে Google Pay-কে একটি ত্বরিত চেকআউট বিকল্প হিসেবে অফার করতে সক্ষম করে। Google Pay API ব্যবহারকারীদের তাদের Google অ্যাকাউন্টে সংরক্ষিত পেমেন্ট পদ্ধতিতে অ্যাক্সেস দিয়ে দ্রুত চেকআউট সক্ষম করে।

এই হ্যান্ডলারটি একটি হেডলেস ইন্টিগ্রেশন মডেল সক্ষম করে যেখানে ব্যবসাগুলি তাদের Google Pay কনফিগারেশন (যেমন অনুমোদিত কার্ড নেটওয়ার্ক এবং গেটওয়ে প্যারামিটার) প্রদান করে এবং প্ল্যাটফর্মগুলি একটি নিরাপদ পেমেন্ট টোকেন তৈরি করতে Google Pay API এর সাথে ক্লায়েন্ট-সাইড ইন্টারঅ্যাকশন পরিচালনা করে।

১.১ মূল সুবিধা

  • ইউনিভার্সাল কনফিগারেশন: ব্যবসাগুলি স্ট্যান্ডার্ড JSON ব্যবহার করে একবার Google Pay কনফিগার করে, যা যেকোনো অনুমোদিত প্ল্যাটফর্মকে কাস্টম ফ্রন্টএন্ড কোড ছাড়াই পেমেন্ট ইন্টারফেস রেন্ডার করার অনুমতি দেয়।
  • ডিকাপল্ড ফ্রন্টএন্ড: প্ল্যাটফর্মগুলি Google Pay JavaScript API বা SDK ইন্টিগ্রেশনের জটিলতা পরিচালনা করে, যখন ব্যবসাগুলি ফলস্বরূপ টোকেন ব্যবহার করে।
  • নিরাপদ টোকেনাইজেশন: ব্যবসার পেমেন্ট সার্ভিস প্রোভাইডার (PSP) এর কাছে সরাসরি এনক্রিপ্ট করা শংসাপত্রগুলি প্রেরণের জন্য Google এর অন্তর্নির্মিত টোকেনাইজেশন ব্যবহার করে।

2. ব্যবসায়িক একীকরণ

২.১ প্রয়োজনীয়তা

UCP-এর মাধ্যমে Google Pay-এর বিজ্ঞাপন দেওয়ার আগে, ব্যবসাগুলিকে অবশ্যই:

  1. Google Pay মার্চেন্ট আইডি পান: PRODUCTION পরিবেশে প্রক্রিয়াকরণের জন্য প্রয়োজনীয় ( Google Pay & Wallet Console এ নিবন্ধন করুন)।
  2. PSP সাপোর্ট যাচাই করুন: নিশ্চিত করুন যে আপনার পেমেন্ট সার্ভিস প্রোভাইডার (PSP) Google Pay টোকেনাইজেশনের জন্য সমর্থিত প্রসেসর এবং গেটওয়ের তালিকায় রয়েছে।

২.২ হ্যান্ডলার কনফিগারেশন

ব্যবসা প্রতিষ্ঠানগুলি তাদের পেমেন্ট হ্যান্ডলার অ্যারেতে হ্যান্ডলার অন্তর্ভুক্ত করে Google Pay সাপোর্টের বিজ্ঞাপন দেয়। কনফিগারেশনটি Google Pay API শুরু করার জন্য প্রয়োজনীয় কাঠামোটি কঠোরভাবে অনুসরণ করে।

২.২.১ কনফিগারেশন স্কিমা

কনফিগারেশন অবজেক্ট পরিবেশ, ব্যবসায়িক পরিচয় এবং অনুমোদিত অর্থপ্রদানের পদ্ধতি সংজ্ঞায়িত করে।

গুগল পে পেমেন্ট পদ্ধতি

গুগল পে এর পেমেন্ট পদ্ধতির উপর ভিত্তি করে।

টোকেনাইজেশন স্পেসিফিকেশন

গুগল পে-এর টোকেনাইজেশন স্পেসিফিকেশনের উপর ভিত্তি করে।

২.২.২ হ্যান্ডলার ঘোষণার উদাহরণ 

{
  "payment": {
    "handlers": [
      {
        "id": "8c9202bd-63cc-4241-8d24-d57ce69ea31c",
        "name": "com.google.pay",
        "version": "2026-01-11",
        "spec": "https://pay.google.com/gp/p/ucp/2026-01-11/",
        "config_schema": "https://pay.google.com/gp/p/ucp/2026-01-11/schemas/config.json",
        "instrument_schemas": [
          "https://pay.google.com/gp/p/ucp/2026-01-11/schemas/card_payment_instrument.json"
        ],
        "config": {
          "api_version": 2,
          "api_version_minor": 0,
          "environment": "TEST",
          "merchant_info": {
            "merchant_name": "Example Merchant",
            "merchant_id": "01234567890123456789",
            "merchant_origin": "checkout.merchant.com"
          },
          "allowed_payment_methods": [
            {
              "type": "CARD",
              "parameters": {
                "allowed_auth_methods": ["PAN_ONLY"],
                "allowed_card_networks": ["VISA", "MASTERCARD"]
              },
              "tokenization_specification": {
                "type": "PAYMENT_GATEWAY",
                "parameters": {
                  "gateway": "example",
                  "gatewayMerchantId": "exampleGatewayMerchantId"
                }
              }
            }
          ]
        }
      }
    ]
  }
}

২.৩ সত্তা

২.৩.১ যন্ত্র স্কিমা

গুগল পে ইন্সট্রুমেন্ট ( card_payment_instrument ) বেস কার্ড পেমেন্ট ইন্সট্রুমেন্টকে প্রসারিত করে। এটি স্ট্যান্ডার্ড ডিসপ্লে ফিল্ড (যেমন brand এবং last_digits ) উত্তরাধিকারসূত্রে পায় যাতে ধারাবাহিক রসিদ রেন্ডারিং নিশ্চিত করা যায়, একই সাথে নির্দিষ্ট গুগল পে টোকেনাইজেশন পেলোড বহন করার জন্য credential ফিল্ডকে পরিমার্জন করা হয়।

প্ল্যাটফর্ম আচরণ: প্ল্যাটফর্মটি Google Pay PaymentMethodData প্রতিক্রিয়া থেকে ব্যবসায় পাঠানোর আগে এই কাঠামোতে ম্যাপিংয়ের জন্য দায়ী।

নাম আদর্শ প্রয়োজনীয় বিবরণ
আইডি স্ট্রিং হাঁ এই পেমেন্ট ইন্সট্রুমেন্টের জন্য একটি অনন্য শনাক্তকারী, যা প্ল্যাটফর্ম দ্বারা নির্ধারিত।
হ্যান্ডলার_আইডি স্ট্রিং হাঁ Google Pay হ্যান্ডলারের জন্য শনাক্তকারী।
টাইপ করুন স্ট্রিং হাঁ ধ্রুবক = card । নির্দেশ করে যে এই যন্ত্রটি একটি কার্ডের মতো আচরণ করে (কার্ড প্রদর্শন ক্ষেত্রগুলি উত্তরাধিকার সূত্রে পায়)।
ব্র্যান্ড স্ট্রিং হাঁ কার্ড নেটওয়ার্ক (যেমন, visa , mastercard )। Google Pay এর info.cardNetwork থেকে ম্যাপ করা।
শেষ_অঙ্ক স্ট্রিং হাঁ কার্ডের শেষ ৪টি সংখ্যা। Google Pay-এর info.cardDetails থেকে ম্যাপ করা।
সমৃদ্ধ_পাঠ্য_বর্ণনা স্ট্রিং না কার্ডের একটি ঐচ্ছিক রিচ টেক্সট বর্ণনা (যেমন, "১২৩৪ তারিখে শেষ হওয়া ভিসা, ২০২৫ সালের ১২ তারিখে শেষ হবে")।
রিচ_কার্ড_আর্ট স্ট্রিং (ইউরি) না কার্ডের প্রতিনিধিত্বকারী একটি সমৃদ্ধ চিত্রের জন্য একটি ঐচ্ছিক URI (যেমন, ইস্যুকারী কার্ড আর্ট)।
বিলিং ঠিকানা ডাক ঠিকানা না কার্ডের সাথে সম্পর্কিত বিলিং ঠিকানা।
শংসাপত্র ক্রেডেনশিয়াল পেলোড না Google Pay দ্বারা ফেরত পাঠানো নিরাপদ টোকেনাইজেশন ডেটা।

ক্রেডেনশিয়াল পেলোড

এই অবজেক্টটি যন্ত্রটির credential হিসেবে কাজ করে। এটি সরাসরি Google Pay টোকেনাইজেশন ডেটার সাথে ম্যাপ করে।

ডাক ঠিকানা

এই অবজেক্টটি address ক্ষেত্র হিসেবে কাজ করে। এটি সরাসরি PostalAddress এ ম্যাপ করে।

3. প্ল্যাটফর্ম ইন্টিগ্রেশন

৩.১ প্রয়োজনীয়তা

com.google.pay পেমেন্ট পরিচালনা করার আগে, প্ল্যাটফর্মগুলিকে অবশ্যই:

  1. ওয়েবের জন্য Google Pay API (অথবা Android সমতুল্য) লোড করতে সক্ষম হতে হবে।
  2. পেমেন্ট বোতামটি রেন্ডার করার সময় Google Pay ব্র্যান্ড নির্দেশিকা মেনে চলুন।

৩.২ পেমেন্ট প্রোটোকল

হ্যান্ডলার প্রক্রিয়া করার জন্য প্ল্যাটফর্মগুলিকে এই প্রবাহ অনুসরণ করতে হবে:

ধাপ ১: আবিষ্কার এবং কনফিগার করুন

প্ল্যাটফর্মটি API জীবনচক্র পরিচালনা করার জন্য ক্লায়েন্টকে আরম্ভ করে।

ধাপ ২: অর্থ প্রদানের প্রস্তুতি পরীক্ষা করুন

বোতামটি প্রদর্শনের আগে প্ল্যাটফর্মটি ব্যবহারকারীর নির্দিষ্ট পেমেন্ট পদ্ধতি ব্যবহার করে পেমেন্ট করার ক্ষমতা আছে কিনা তা পরীক্ষা করে।

ধাপ ৩: পেমেন্ট অনুরোধ তৈরি করুন

প্ল্যাটফর্মটি পেমেন্ট ডেটা অনুরোধের বস্তুটি একত্রিত করে, যার মধ্যে মার্চেন্ট কনফিগারেশন, পেমেন্ট পদ্ধতি এবং লেনদেনের বিবরণ (মূল্য এবং মুদ্রা) অন্তর্ভুক্ত থাকে।

ধাপ ৪: ব্যবহারকারীর মিথস্ক্রিয়া শুরু করুন

ব্যবহারকারী যখন পেমেন্ট বোতামের সাথে ইন্টারঅ্যাক্ট করেন তখন প্ল্যাটফর্মটি পেমেন্ট শিট প্রদর্শন ট্রিগার করে।

ধাপ ৫: চেকআউট সম্পূর্ণ করুন

সফল ব্যবহারকারীর ইন্টারঅ্যাকশনের পরে, Google Pay API payment_data কী-এর অধীনে একটি PaymentInstrument অবজেক্ট ফেরত পাঠায়। প্ল্যাটফর্মটি card_payment_instrument স্কিমার সাথে এই প্রতিক্রিয়াটি ম্যাপ করে এবং চেকআউট সম্পূর্ণ করার অনুরোধ জমা দেয়।

POST /checkout-sessions/{checkout_id}/complete

{
  "payment_data": {
    "id": "pm_1234567890abc",
    "handler_id": "8c9202bd-63cc-4241-8d24-d57ce69ea31c",
    "type": "card",
    "brand": "visa",
    "last_digits": "4242",
    "billing_address": {
      "street_address": "123 Main Street",
      "extended_address": "Suite 400",
      "address_locality": "Charleston",
      "address_region": "SC",
      "postal_code": "29401",
      "address_country": "US",
      "first_name": "Jane",
      "last_name": "Smith"
    },
    "credential": {
      "type": "PAYMENT_GATEWAY",
      "token": "{\"signature\":\"...\",\"protocolVersion\":\"ECv2\"...}"
    }
  },
  "risk_signals": {
      ...
  }
}

৪. ব্যবসা প্রক্রিয়াকরণ

Google Pay পেমেন্ট ইন্সট্রুমেন্ট পাওয়ার পর, ব্যবসাগুলিকে অবশ্যই:

  1. হ্যান্ডলার যাচাই করুন: নিশ্চিত করুন যে handler_id Google Pay হ্যান্ডলারের সাথে সঙ্গতিপূর্ণ।
  2. টোকেন এক্সট্র্যাক্ট করুন: payment_data.credential.token থেকে টোকেন স্ট্রিংটি পুনরুদ্ধার করুন।
  3. পেমেন্ট প্রক্রিয়া: টোকেন স্ট্রিং এবং লেনদেনের বিবরণ PSP এর এন্ডপয়েন্টে পাঠান।
    • দ্রষ্টব্য: বেশিরভাগ PSP-এর "Google Pay Payload" অথবা "Network Token"-এর জন্য একটি নির্দিষ্ট ক্ষেত্র থাকে।
  4. রিটার্ন রেসপন্স: চূড়ান্ত চেকআউট অবস্থা (সফল/ব্যর্থতা) দিয়ে রিসপন্স করুন।

৫. নিরাপত্তা বিবেচ্য বিষয়

৫.১ টোকেন নিরাপত্তা

  • PAYMENT_GATEWAY: এই টোকেনাইজেশন টাইপ ব্যবহার করার সময়, টোকেনটি বিশেষভাবে টোকেনাইজেশন পার্টির জন্য এনক্রিপ্ট করা হয়। পাস-থ্রু পার্টি এই টোকেনটি ডিক্রিপ্ট করতে পারে না এবং এটিকে টোকেনাইজেশন পার্টির কাছে যেমন আছে তেমনই প্রেরণ করা উচিত।
  • DIRECT: DIRECT টোকেনাইজেশন ব্যবহার করলে, ব্যবসাটি এনক্রিপ্ট করা কার্ড ডেটা পাবে যা তাদের ডিক্রিপ্ট করতে হবে। এটি PCI DSS সম্মতির পরিধি উল্লেখযোগ্যভাবে বৃদ্ধি করে এবং সাধারণত এটি সুপারিশ করা হয় না যদি না ব্যবসাটি একটি লেভেল 1 PCI সম্মতিপ্রাপ্ত পরিষেবা প্রদানকারী হয়।

৫.২ পরিবেশ বিচ্ছিন্নতা

  • পরীক্ষা মোড: TEST পরিবেশে, Google Pay ডামি টোকেন ফেরত দেয়। এগুলির জন্য চার্জ করা যাবে না।
  • উৎপাদন মোড: আসল কার্ড ব্যবহার করা হয়। ব্যবসাগুলিকে নিশ্চিত করতে হবে যে config.allowed_payment_methods এ তাদের PSP শংসাপত্রগুলি পরিবেশের সাথে মেলে।
পূর্ববর্তী
এমবেডেড চেকআউট (ঐচ্ছিক)
পরবর্তী
পরিচয় লিঙ্কিং (ঐচ্ছিক)