AccountService রিসোর্স তৈরি, আপডেট বা ডিলিট করা হলে রিয়েল-টাইম অ্যালার্ট পেতে আপনি ACCOUNT_SERVICE_CHANGE নোটিফিকেশনে সাবস্ক্রাইব করতে পারেন। এটি বিশেষ করে থার্ড-পার্টি প্রোভাইডার এবং একাধিক অ্যাকাউন্ট পরিষেবা সম্পর্ক পরিচালনাকারী ব্যবসাগুলোর জন্য অত্যন্ত মূল্যবান।
অ্যাকাউন্ট পরিষেবা পরিবর্তনের জন্য সাবস্ক্রাইব করলে, এপিআই পোলিং ছাড়াই আপনি তাৎক্ষণিকভাবে জানতে পারবেন কখন কোনো অ্যাকাউন্ট পরিষেবা প্রস্তাবিত, অনুমোদিত, আপডেট বা অপসারণ করা হয়েছে।
শুরু করার আগে, নিশ্চিত করুন যে আপনার কলব্যাক ইউআরআই (URI) নোটিফিকেশন সাব-এপিআই ওভারভিউ (Notifications sub-API Overview )-তে বর্ণিত প্রয়োজনীয়তা অনুসারে কনফিগার করা আছে।
অ্যাকাউন্ট পরিষেবা পরিবর্তনে সাবস্ক্রাইব করুন
অ্যাকাউন্ট পরিষেবার পরিবর্তনগুলিতে সাবস্ক্রাইব করতে, notificationsubscriptions রিসোর্সে একটি POST অনুরোধ পাঠান এবং registeredEvent ACCOUNT_SERVICE_CHANGE এ সেট করুন।
একটি নির্দিষ্ট টার্গেট অ্যাকাউন্টের জন্য সাবস্ক্রাইব করুন
নিম্নলিখিত নমুনা অনুরোধটি একটি নির্দিষ্ট মার্চেন্ট অ্যাকাউন্টের জন্য অ্যাকাউন্ট পরিষেবা পরিবর্তনগুলিতে সাবস্ক্রাইব করে:
POST https://merchantapi.googleapis.com/notifications/v1/accounts/{ACCOUNT_ID}/notificationsubscriptions/
{
"registeredEvent": "ACCOUNT_SERVICE_CHANGE",
"targetAccount": "accounts/{TARGETACCOUNT_ID}",
"callBackUri": "https://example.com/callback"
}
নিম্নলিখিতগুলি প্রতিস্থাপন করুন:
- ACCOUNT_ID : যে অ্যাকাউন্টটি সাবস্ক্রিপশনের মালিক এবং নোটিফিকেশন গ্রহণ করে, তার শনাক্তকারী।
- TARGETACCOUNT_ID : যে অ্যাকাউন্টটির বিষয়ে আপনি বিজ্ঞপ্তি পেতে চান, তার শনাক্তকারী।
সমস্ত পরিচালিত অ্যাকাউন্টের জন্য সাবস্ক্রাইব করুন
যেসব প্রোভাইডার ও ব্যবসা একাধিক মার্চেন্ট অ্যাকাউন্ট পরিচালনা করে, তারা allManagedAccounts: true সেট করার মাধ্যমে সমস্ত পরিচালিত অ্যাকাউন্টে অ্যাকাউন্ট পরিষেবা পরিবর্তনের জন্য সাবস্ক্রাইব করতে পারে।
POST https://merchantapi.googleapis.com/notifications/v1/accounts/{ACCOUNT_ID}/notificationsubscriptions/
{
"registeredEvent": "ACCOUNT_SERVICE_CHANGE",
"allManagedAccounts": true,
"callBackUri": "https://example.com/callback"
}
সফল কলগুলো আপনার সাবস্ক্রিপশনের জন্য একটি name শনাক্তকারী ফেরত দেয়, যার মধ্যে একটি অনন্য সাবস্ক্রিপশন আইডি অন্তর্ভুক্ত থাকে:
{
"name":"accounts/{ACCOUNT_ID}/notificationsubscriptions/{SUBSCRIPTION_ID}",
"registeredEvent": "ACCOUNT_SERVICE_CHANGE",
"allManagedAccounts": true,
"callBackUri": "https://example.com/callback"
}
অ্যাকাউন্ট পরিষেবা পরিবর্তনের পেলোডগুলি ডিকোড করুন
যখন কোনো অ্যাকাউন্ট পরিষেবা পরিবর্তন হয়, তখন আপনার কলব্যাক URI একটি বেস৬৪-এনকোডেড বার্তা গ্রহণ করে। ডিকোড করা হলে, পেলোডটি ResourceChangeMessage ফরম্যাট অনুসরণ করে:
{
"account": "accounts/{TARGETACCOUNT_ID}",
"managingAccount": "accounts/{ACCOUNT_ID}",
"resourceType": "ACCOUNT_SERVICE",
"resource": "accounts/{TARGETACCOUNT_ID}/services/{SERVICE_ID}",
"operation": "CREATE",
"eventTime": "2026-08-25T10:00:00Z"
}
পেলোড ক্ষেত্র এবং নিয়মাবলী
-
account: পরিবর্তিত পরিষেবা সত্তাটির (accounts/{merchant_id}) মালিকানাধীন লক্ষ্য অ্যাকাউন্ট। -
managingAccount: যে অ্যাকাউন্টটি মার্চেন্টের অ্যাকাউন্ট (accounts/{service_provider_id}) পরিচালনা করে। -
resourceType: যে রিসোর্স টাইপটি পরিবর্তিত হয়েছে (ACCOUNT_SERVICE)। -
resource: অ্যাকাউন্ট সার্ভিসের সম্পূর্ণ রিসোর্স নাম (উদাহরণস্বরূপ,accounts/{account}/services/{service})। -
operation: রিসোর্সের উপর সম্পাদিত অপারেশন:-
CREATE: একটি নতুন অ্যাকাউন্ট পরিষেবা সম্পর্ক তৈরি করা হয়েছে। -
UPDATE: বিদ্যমান অ্যাকাউন্টের পরিষেবা কনফিগারেশন বা অনুমতি পরিবর্তন করা হয়েছে। -
DELETE: একটি অ্যাকাউন্ট পরিষেবা সম্পর্ক মুছে ফেলা হয়েছে।
-
-
eventTime: ইভেন্টটি তৈরি হওয়ার সময়কার টাইমস্ট্যাম্প। ইভেন্টগুলোর সঠিক ক্রম নিশ্চিত করতে এই টাইমস্ট্যাম্পটি ব্যবহার করুন।
টেস্ট অ্যাকাউন্ট পরিষেবা পরিবর্তনের বিজ্ঞপ্তি
আপনার কলব্যাক এন্ডপয়েন্ট অ্যাকাউন্ট সার্ভিস পরিবর্তনের মেসেজগুলো সঠিকভাবে গ্রহণ, স্বীকার এবং ডিকোড করে কিনা, তা পরীক্ষা করতে নিম্নলিখিত নমুনা অনুরোধটি ব্যবহার করুন:
curl --request POST \
'https://{YOUR_CALLBACK_URI}' \
--header 'Content-Type: application/json' \
--header 'Accept: text/plain' \
--data '{"message":{"data": "ewogICJhY2NvdW50IjogImFjY291bnRzLzEyMzQiLAogICJtYW5hZ2luZ0FjY291bnQiOiAiYWNjb3VudHMvNTY3OCIsCiAgInJlc291cmNlVHlwZSI6ICJBQ0NPVU5UX1NFUlZJQ0UiLAogICJyZXNvdXJjZSI6ICJhY2NvdW50cy8xMjM0L3NlcnZpY2VzLzEyMyIsCiAgIm9wZXJhdGlvbiI6ICJDUkVBVEUiLAogICJldmVudFRpbWUiOiAiMjAyNi0wOC0yNVQxMDowMDowMFoiCn0="}}' এই কলের জবাবে, আপনার কলব্যাক URI-কে একটি গ্রহণযোগ্য HTTP স্ট্যাটাস কোড (যেমন 200 OK ) ফেরত দিতে হবে। ডিকোড করা বার্তাটির বিষয়বস্তু নিম্নরূপ:
{
"account": "accounts/1234",
"managingAccount": "accounts/5678",
"resourceType": "ACCOUNT_SERVICE",
"resource": "accounts/1234/services/123",
"operation": "CREATE",
"eventTime": "2026-08-25T10:00:00Z"
}