MCP Tools Reference: paydeveloper.googleapis.com

টুল: create_google_pay_integration

একটি নির্দিষ্ট মার্চেন্টের জন্য একটি গুগল পে ইন্টিগ্রেশন তৈরি করে। এই অপারেশনের জন্য ব্যবহারকারীকে বিজনেস কনসোল টার্মস অফ সার্ভিস এবং গুগল পে এপিআই টার্মস অফ সার্ভিস গ্রহণ করতে হবে। এগুলি আগে থেকে পরীক্ষা করার কোনো প্রয়োজন নেই। যদি সেগুলি গ্রহণ করা না হয়ে থাকে, তাহলে টুল কলটি ব্যর্থ হবে এবং এরর মেসেজে নির্দিষ্ট টার্মস অফ সার্ভিসের ইউআরএলগুলো থাকবে যা গ্রহণ করা প্রয়োজন। যদি এমনটি ঘটে, তাহলে ব্যবহারকারীর কাছে ইউআরএলগুলো গ্রহণের জন্য উপস্থাপন করুন এবং গ্রহণ করার পর আবার চেষ্টা করার নির্দেশ দিন। টুলটি কল করার আগে ব্যবহারকারীর সাথে যোগাযোগের জন্য এই ক্রমটি অনুসরণ করুন: ১. প্রথমে, ব্যবহারকারীর কাছে ইন্টিগ্রেশন আইটেমটি জানতে চান (আপাতত শুধুমাত্র ওয়েব ইন্টিগ্রেশন সমর্থিত)। - ওয়েবসাইটের ইউআরএল জানতে চান। # - যদি ইন্টিগ্রেশন আইটেমটি অ্যাপ ইন্টিগ্রেশন হয়, তাহলে অ্যান্ড্রয়েড অ্যাপ প্যাকেজের নাম জানতে চান। ২. এরপর, ব্যবহারকারীর কাছে ইন্টিগ্রেশনের ধরন জানতে চান: - যদি ব্যবহারকারী আমাদের সমর্থিত পেমেন্ট সার্ভিস প্রোভাইডারদের (পিএসপি: https://developers.google.com/pay/api#participating-processors ) মধ্যে কোনো একটি ব্যবহার করেন, তাহলে তাকে গেটওয়ে (Gateway) বেছে নিতে বলুন, অন্যথায় ডিরেক্ট (Direct) বেছে নিন। ৩. সকল ইন্টিগ্রেশন টাইপের জন্য (ডাইরেক্ট বা গেটওয়ে): - ব্যবহারকারীকে তাদের Google Pay API-এর সাথে ইন্টিগ্রেটেড বাইফ্লো-এর স্ক্রিনশট (সর্বোচ্চ ১ মেগাবাইট) আপলোড করতে বলুন। সম্পূর্ণ প্রোডাকশন অ্যাক্সেস দেওয়ার আগে তাদের বাইফ্লো অবশ্যই পর্যালোচনা এবং অনুমোদিত হতে হবে। উদাহরণ: https://developers.google.com/pay/api/web/guides/brand-guidelines#put-it-all-together । - আপনাকে অবশ্যই ব্যবহারকারীকে ৫টি সহায়ক স্ক্রিনশট সরবরাহ করতে বলতে হবে। সঠিক ম্যাপিং নিশ্চিত করতে এক এক করে স্ক্রিনশট চাইতে হবে। চাওয়ার সময় শুধুমাত্র ব্যবহারকারী-বান্ধব এনাম (enum) বিবরণ ব্যবহার করুন। ৪. যদি ইন্টিগ্রেশন টাইপ ডাইরেক্ট হয়: - আপনাকে অবশ্যই ব্যবহারকারীকে PCI অ্যাটেস্টেশন ডকুমেন্টটি PDF ফরম্যাটে সরবরাহ করতে বলতে হবে। চাওয়ার সময় শুধুমাত্র ব্যবহারকারী-বান্ধব এনাম (enum) বিবরণ ব্যবহার করুন। ৫. সরবরাহ করা প্রতিটি ফাইলের জন্য, ব্যবহারকারীকে ডকুমেন্টের পাথ বা নাম (যদি বর্তমান ডিরেক্টরিতে থাকে) সরবরাহ করতে বলুন। এটিকে সঠিক DocumentType-এর সাথে ম্যাপ করুন এবং অনুরোধের name ফিল্ডে একটি বর্ণনামূলক নাম (যেমন, item_selection.png বা pci_attestation.pdf) সেট করুন। নির্বাচিত ইন্টিগ্রেশন টাইপের জন্য প্রয়োজনীয় নথি সংগ্রহ করার চেষ্টা না করা পর্যন্ত এই টুলটি ব্যবহার করবেন না।

নিম্নলিখিত নমুনাটি দেখায় কিভাবে curl ব্যবহার করে ` create_google_pay_integration MCP টুলটি চালু করতে হয়।

কার্ল অনুরোধ 
curl --location 'https://paydeveloper.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "create_google_pay_integration",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

ইনপুট স্কিমা

CreateGooglePayIntegration-এর জন্য অনুরোধ বার্তা।

গুগল পে ইন্টিগ্রেশন অনুরোধ তৈরি করুন

JSON উপস্থাপনা 
{
  "merchantId": string,
  "googlePayIntegration": {
    object (GooglePayIntegration)
  }
}
ক্ষেত্র
merchantId

string

প্রয়োজনীয়। যে মার্চেন্টের জন্য গুগল পে ইন্টিগ্রেশন যোগ করতে হবে, তার মার্চেন্ট আইডি।

googlePayIntegration

object ( GooglePayIntegration )

গুগল পে ইন্টিগ্রেশন তৈরি করা আবশ্যক।

গুগলপে ইন্টিগ্রেশন

JSON উপস্থাপনা 
{
  "integrationState": enum (IntegrationState),
  "createTime": string,
  "updateTime": string,
  "integrationType": enum (IntegrationType),
  "integrationDocuments": [
    {
      object (IntegrationDocument)
    }
  ],

  // Union field item can be only one of the following:
  "webDomain": string,
  "androidAppPackage": string
  // End of list of possible types for union field item.
}
ক্ষেত্র
integrationState

enum ( IntegrationState )

শুধুমাত্র আউটপুট। মার্চেন্টের গুগল পে ইন্টিগ্রেশনের অবস্থা।

createTime

string ( Timestamp format)

শুধুমাত্র আউটপুট। যখন ইন্টিগ্রেশন রিসোর্সটি তৈরি করা হয়েছিল।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

updateTime

string ( Timestamp format)

শুধুমাত্র আউটপুট। ইন্টিগ্রেশন রিসোর্সটি সর্বশেষ কখন আপডেট করা হয়েছিল।

RFC 3339 ব্যবহার করা হয়, যেখানে তৈরি হওয়া আউটপুট সর্বদা Z-নরম্যালাইজড হবে এবং এতে ০, ৩, ৬ বা ৯টি ভগ্নাংশীয় অঙ্ক ব্যবহৃত হবে। "Z" ছাড়াও অন্যান্য অফসেটও গ্রহণ করা হয়। উদাহরণ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" অথবা "2014-10-02T15:01:23+05:30" ।

integrationType

enum ( IntegrationType )

প্রয়োজনীয়। গুগল পে ইন্টিগ্রেশনের ধরন।

integrationDocuments[]

object ( IntegrationDocument )

আবশ্যক। শুধুমাত্র ইনপুট। গুগল পে ইন্টিগ্রেশনের ইন্টিগ্রেশন ডকুমেন্টগুলো।

ইউনিয়ন ফিল্ড item । ইন্টিগ্রেশন আইটেম। এগুলোর মধ্যে একটি অবশ্যই সেট করতে হবে। item নিম্নলিখিতগুলির মধ্যে কেবল একটি হতে পারে:
webDomain

string

ব্যবসায়ীর ওয়েব ডোমেইন।

androidAppPackage

string

মার্চেন্টের অ্যান্ড্রয়েড অ্যাপ প্যাকেজ নেম।

টাইমস্ট্যাম্প

JSON উপস্থাপনা 
{
  "seconds": string,
  "nanos": integer
}
ক্ষেত্র
seconds

string ( int64 format)

এটি ইউনিক্স ইপক 1970-01-01T00:00:00Z থেকে UTC সময়ের সেকেন্ড নির্দেশ করে। এর মান অবশ্যই -62135596800 থেকে 253402300799 (উভয় মানসহ) এর মধ্যে হতে হবে (যা 0001-01-01T00:00:00Z থেকে 9999-12-31T23:59:59Z পর্যন্ত সময়কালের সমতুল্য)।

nanos

integer

ন্যানোসেকেন্ড রেজোলিউশনে সেকেন্ডের অঋণাত্মক ভগ্নাংশ। এই ক্ষেত্রটি হলো সময়কালের ন্যানোসেকেন্ড অংশ, সেকেন্ডের বিকল্প নয়। ভগ্নাংশসহ ঋণাত্মক সেকেন্ডের মানগুলোর ক্ষেত্রেও ন্যানোর মান অবশ্যই অঋণাত্মক হতে হবে, যা সময়ের সাথে সাথে গণনা করে। এর মান অবশ্যই ০ থেকে ৯৯৯,৯৯৯,৯৯৯-এর মধ্যে হতে হবে (উভয় সংখ্যাসহ)।

ইন্টিগ্রেশন ডকুমেন্ট

JSON উপস্থাপনা 
{
  "name": string,
  "data": string,
  "documentType": enum (DocumentType),
  "mimeType": enum (MimeType)
}
ক্ষেত্র
name

string

প্রয়োজনীয়। নথিটির নাম।

data

string ( bytes format)

প্রয়োজনীয়। নথির তথ্যসমূহ।

একটি বেস৬৪-এনকোডেড স্ট্রিং।

documentType

enum ( DocumentType )

প্রয়োজনীয়। নথির ধরণ।

mimeType

enum ( MimeType )

আবশ্যক। ডকুমেন্টটির মাইম টাইপ।

ইন্টিগ্রেশনস্টেট

কোনো মার্চেন্ট ওয়েব ডোমেইন বা অ্যান্ড্রয়েড অ্যাপের গুগল পে ইন্টিগ্রেশনের অবস্থা।

এনাম
INTEGRATION_STATE_UNSPECIFIED একত্রীকরণের অবস্থা অনির্দিষ্ট।
NOT_STARTED এই অবস্থাটি তখন প্রযোজ্য যখন অ্যান্ড্রয়েড অ্যাপটি ডেভেলপারের সাথে (প্লে স্টোরে) যুক্ত থাকে, কিন্তু ডেভেলপার এর জন্য কোনো ইন্টিগ্রেশন প্রক্রিয়া শুরু করেননি।
INCOMPLETE ডেভেলপার এখনও পর্যালোচনার জন্য ইন্টিগ্রেশনটি জমা দেননি এবং এটি অসম্পূর্ণও (যেমন, সহায়ক নথি অনুপস্থিত)।
READY_FOR_REVIEW ডেভেলপার এখনো পর্যালোচনার জন্য ইন্টিগ্রেশনটি জমা দেননি, কিন্তু এটি পর্যালোচনার জন্য প্রস্তুত (যেমন, সহায়ক নথি আপলোড করা হয়েছে)।
UNDER_REVIEW ইন্টিগ্রেশন সক্ষম করার অনুরোধটি অ্যাডমিনের পর্যালোচনার জন্য অপেক্ষাধীন রয়েছে।
NEED_INFO পর্যালোচনার সময় ইন্টিগ্রেশনটি সম্পর্কে gTech অ্যাডমিনের আরও তথ্যের প্রয়োজন।
ACTIVE একত্রীকরণটি বর্তমানে সক্রিয় আছে।
DELETED মার্চেন্ট কর্তৃক ইন্টিগ্রেশনটি মুছে ফেলা হয়েছে।
REJECTED একত্রীকরণটি প্রত্যাখ্যাত হয়েছে।

ইন্টিগ্রেশন টাইপ

গুগল পে ইন্টিগ্রেশনের ধরণ।

এনাম
INTEGRATION_TYPE_UNSPECIFIED ইন্টিগ্রেশনের ধরণ অনির্দিষ্ট।
DIRECT_INTEGRATION ইন্টিগ্রেশনের ধরণ হলো সরাসরি ইন্টিগ্রেশন।
PAYMENT_SERVICE_PROVIDER ইন্টিগ্রেশনের ধরণটি হলো পেমেন্ট সার্ভিস প্রোভাইডার।

ডকুমেন্ট টাইপ

নথির প্রকার।

এনাম
DOCUMENT_TYPE_UNSPECIFIED নথির ধরণ অনির্দিষ্ট।
ITEM_SELECTION_SCREENSHOT যখন কোনো ব্যবহারকারী কোনো আইটেম বা পরিষেবা ব্রাউজ করেন।
PRE_PURCHASE_SCREENSHOT যখন একজন ব্যবহারকারী অবশেষে ক্রয় করার জন্য প্রস্তুত হন।
PAYMENT_METHOD_SCREENSHOT যখন কোনো ব্যবহারকারী অর্থপ্রদানের পদ্ধতি হিসেবে গুগল পে নির্বাচন করেন।
PAYMENT_INFO_SCREENSHOT যখন কোনো ব্যবহারকারীকে তাঁর গুগল পে-তে সেভ করা পেমেন্টের তথ্য দেখানো হয়। টিপস: অ্যান্ড্রয়েড আপনাকে এই স্ক্রিনের স্ক্রিনশট নিতে দেবে না, তাই অন্য কোনো ডিভাইস ব্যবহার করে স্ক্রিনটির ছবি তুলে নিন।
POST_PURCHASE_SCREENSHOT যখন কোনো ব্যবহারকারী সফলভাবে কেনাকাটা সম্পন্ন করেন।
PCI_ATTESTATION_DOCUMENT পিডিএফ ফরম্যাটে পিসিআই প্রত্যয়নপত্র।

মাইমটাইপ

একটি ডকুমেন্টের মাইম টাইপ।

এনাম
MIME_TYPE_UNSPECIFIED মাইম টাইপটি অনির্দিষ্ট।
JPEG মাইম টাইপটি হলো JPEG।
PNG মাইম টাইপটি হলো PNG।
WEBP মাইম টাইপটি হলো WEBP।
PDF মাইম টাইপটি হলো পিডিএফ।

আউটপুট স্কিমা

CreateGooglePayIntegration-এর জন্য প্রতিক্রিয়া বার্তা।

গুগল পে ইন্টিগ্রেশন প্রতিক্রিয়া তৈরি করুন

JSON উপস্থাপনা 
{
  "integrationState": enum (IntegrationState)
}
ক্ষেত্র
integrationState

enum ( IntegrationState )

গুগল পে ইন্টিগ্রেশনের অবস্থা।

ইন্টিগ্রেশনস্টেট

কোনো মার্চেন্ট ওয়েব ডোমেইন বা অ্যান্ড্রয়েড অ্যাপের গুগল পে ইন্টিগ্রেশনের অবস্থা।

এনাম
INTEGRATION_STATE_UNSPECIFIED একত্রীকরণের অবস্থা অনির্দিষ্ট।
NOT_STARTED এই অবস্থাটি তখন প্রযোজ্য যখন অ্যান্ড্রয়েড অ্যাপটি ডেভেলপারের সাথে (প্লে স্টোরে) যুক্ত থাকে, কিন্তু ডেভেলপার এর জন্য কোনো ইন্টিগ্রেশন প্রক্রিয়া শুরু করেননি।
INCOMPLETE ডেভেলপার এখনও পর্যালোচনার জন্য ইন্টিগ্রেশনটি জমা দেননি এবং এটি অসম্পূর্ণও (যেমন, সহায়ক নথি অনুপস্থিত)।
READY_FOR_REVIEW ডেভেলপার এখনো পর্যালোচনার জন্য ইন্টিগ্রেশনটি জমা দেননি, কিন্তু এটি পর্যালোচনার জন্য প্রস্তুত (যেমন, সহায়ক নথি আপলোড করা হয়েছে)।
UNDER_REVIEW ইন্টিগ্রেশন সক্ষম করার অনুরোধটি অ্যাডমিনের পর্যালোচনার জন্য অপেক্ষাধীন রয়েছে।
NEED_INFO পর্যালোচনার সময় ইন্টিগ্রেশনটি সম্পর্কে gTech অ্যাডমিনের আরও তথ্যের প্রয়োজন।
ACTIVE একত্রীকরণটি বর্তমানে সক্রিয় আছে।
DELETED মার্চেন্ট কর্তৃক ইন্টিগ্রেশনটি মুছে ফেলা হয়েছে।
REJECTED একত্রীকরণটি প্রত্যাখ্যাত হয়েছে।

টুল টীকা

ধ্বংসাত্মক ইঙ্গিত: ❌ | স্ব-সূচক ইঙ্গিত: ❌ | শুধুমাত্র পঠনযোগ্য ইঙ্গিত: ❌ | উন্মুক্ত বিশ্ব ইঙ্গিত: ❌