Method: notification.partners.bookings.patch

বিদ্যমান Booking আপডেট করে।

HTTP অনুরোধ

PATCH https://mapsbooking.googleapis.com/v1alpha/notification/{booking.name=partners/*/bookings/*}

URL-টিতে gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করা হয়েছে।

পথের পরামিতি

প্যারামিটার
booking.name

string

বুকিং-এর রিসোর্স নাম: partners/{partner ID}/bookings/{booking ID}

কোয়েরি প্যারামিটার

প্যারামিটার
updateMask

string ( FieldMask format)

সমস্ত বুকিং ফিল্ডের ফিল্ড মাস্ক আপডেট করা হবে

এটি ফিল্ডগুলোর পূর্ণাঙ্গ নামের একটি কমা-দ্বারা-বিভক্ত তালিকা। উদাহরণ: "user.displayName,photo" ।

bookingFailure

object ( BookingFailure )

যদি অ্যাসিঙ্ক্রোনাসভাবে নিশ্চিত করা কোনো বুকিং অনুরোধের প্রক্রিয়াকরণ ব্যর্থ হয় এবং বুকিংটির স্ট্যাটাস 'ব্যর্থ' (FAILED) হিসেবে আপডেট করা হয়, তাহলে এই ফিল্ডটিতে ব্যবসায়িক যুক্তির ত্রুটিটি প্রতিফলিত হওয়া উচিত (যেমন, ব্যবহারকারীর এই সময়ের খুব কাছাকাছি একটি বিদ্যমান রিজার্ভেশন রয়েছে)। এই ফিল্ডটি শুধুমাত্র বুকিং স্ট্যাটাস 'ব্যর্থ' (FAILED) হিসেবে আপডেট করার সময়ই সেট করা উচিত এবং অন্যথায় এটি উপেক্ষা করা হবে।

অনুরোধকারী শরীর

অনুরোধের বডিতে Booking এর একটি ইনস্ট্যান্স থাকে।

প্রতিক্রিয়া সংস্থা

সফল হলে, রেসপন্স বডিতে Booking এর একটি ইনস্ট্যান্স থাকে।

অনুমোদনের পরিধি

নিম্নলিখিত OAuth স্কোপ প্রয়োজন:

  • https://www.googleapis.com/auth/mapsbooking

বুকিং ব্যর্থতা

স্ট্যাটাস ডেটা যা জানায় কেন একটি বুকিং প্রক্রিয়াকরণ অ্যাসিঙ্ক্রোনাসভাবে ব্যর্থ হয়েছে। BookingFailure-এর প্রধান উদ্দেশ্য হলো বিজনেস লজিক ত্রুটিগুলো নথিভুক্ত করা।

JSON উপস্থাপনা 
{
  "cause": enum (Cause),
  "rejectedCardType": enum (CreditCardType),
  "description": string,
  "paymentFailure": {
    object (PaymentFailureInformation)
  }
}
ক্ষেত্র
cause

enum ( Cause )

বুকিং ব্যর্থ হওয়ার কারণ। (প্রয়োজনীয়)

rejectedCardType

enum ( CreditCardType )

(শুধুমাত্র PAYMENT_ERROR_CARD_TYPE_REJECTED কারণের ক্ষেত্রেই প্রয়োজন)

description

string

এই ঐচ্ছিক ক্ষেত্রটি শুধুমাত্র ডিবাগিংয়ের উদ্দেশ্যে অংশীদারের অতিরিক্ত তথ্য অন্তর্ভুক্ত করার জন্য ব্যবহৃত হয়। (ঐচ্ছিক)

paymentFailure

object ( PaymentFailureInformation )

পেমেন্ট ব্যর্থতা সম্পর্কিত তথ্য।

কারণ

ব্যর্থতার কারণসমূহের তালিকা।

এনাম
CAUSE_UNSPECIFIED ডিফল্ট মান: ব্যবহার করবেন না; এটি একটি "অজানা ত্রুটি" হিসেবে গণ্য হবে।
SLOT_UNAVAILABLE উল্লেখিত উপলব্ধ স্লটটি আর পাওয়া যাচ্ছে না।
SLOT_ALREADY_BOOKED_BY_USER ব্যবহারকারী উল্লেখিত উপলব্ধ স্লটটির জন্য ইতিমধ্যেই একটি অ্যাপয়েন্টমেন্ট বুক করেছেন।
LEASE_EXPIRED ইজারাপত্রটির (যদি দেওয়া হয়ে থাকে) মেয়াদ শেষ হয়ে গেছে এবং অনুরোধকৃত বুকিংটি সম্পন্ন করার জন্য এটি আর ব্যবহার করা যাবে না।
OUTSIDE_CANCELLATION_WINDOW বিক্রেতার বাতিলকরণ নীতিতে সময়সীমা থাকার কারণে অনুরোধকৃত বাতিলকরণটি এই মুহূর্তে সম্পন্ন করা সম্ভব নয়।
PAYMENT_ERROR_CARD_TYPE_REJECTED পেমেন্ট প্রক্রিয়া করার সময় একটি ত্রুটি দেখা দিয়েছে, কারণ প্রদত্ত ক্রেডিট কার্ডের ধরনটি মার্চেন্ট গ্রহণ করেনি। rejectedCardType-এ ক্রেডিট কার্ডের ধরন অবশ্যই সরবরাহ করতে হবে।
PAYMENT_ERROR_CARD_DECLINED প্রদত্ত ক্রেডিট কার্ডটি প্রত্যাখ্যাত হওয়ায় পেমেন্ট প্রক্রিয়াকরণে একটি ত্রুটি দেখা দিয়েছে।
PAYMENT_OPTION_NOT_VALID বুকিংয়ের অর্থ পরিশোধের জন্য ব্যবহৃত প্যাক/সদস্যপদটিতে একটি ত্রুটি দেখা দিয়েছে। এটির আর কোনো বৈধ ব্যবহার অবশিষ্ট নাও থাকতে পারে, অথবা এর মেয়াদ শেষ হয়ে গিয়ে থাকতে পারে, ইত্যাদি।
PAYMENT_ERROR এই বুকিংটির পেমেন্ট প্রক্রিয়া করার সময় একটি ত্রুটি দেখা দিয়েছে। এই মানটি একটি সাধারণ পেমেন্ট-সম্পর্কিত ত্রুটি নির্দেশ করতে ব্যবহার করুন, শুধুমাত্র যদি ত্রুটিটি উপরের কোনো নির্দিষ্ট পেমেন্ট ত্রুটির সাথে না মেলে।
USER_CANNOT_USE_PAYMENT_OPTION ব্যবহারকারী প্রদত্ত অর্থপ্রদানের বিকল্পটি ব্যবহার করতে পারবেন না (যেমন, ব্যবহারকারী দ্বিতীয়বারের জন্য প্রথমবারের মূল্য ব্যবহার করার চেষ্টা করছেন)।
BOOKING_ALREADY_CANCELLED ব্যবহারকারী যে বুকিংটি বাতিল করার চেষ্টা করেছিলেন, সেটি ইতিমধ্যেই বাতিল করা হয়েছে।
BOOKING_NOT_CANCELLABLE যে বুকিংটি ব্যবহারকারী বাতিল করার চেষ্টা করেছেন, সেটি বাতিলযোগ্য নয়।
OVERLAPPING_RESERVATION ব্যবহারকারীর এই সময়ের খুব কাছাকাছি সময়ে একটি বিদ্যমান রিজার্ভেশন রয়েছে।
USER_OVER_BOOKING_LIMIT ব্যবহারকারী অ্যাগ্রিগেটরের প্রতি-ব্যবহারকারী বুকিং সীমা অতিক্রম করায় বুকিংটি ব্যর্থ হয়েছে।
PAYMENT_REQUIRES_3DS1

যখন পেমেন্ট প্রত্যাখ্যাত হয়, তখন এটি সেট করা হয়, কারণ আপনি লেনদেনটি পুনরায় চেষ্টা করার অনুরোধ করছেন, কিন্তু এবার 3DS1 চ্যালেঞ্জ/রেসপন্স প্রক্রিয়ার পর। মনে রাখবেন যে, বর্তমান লেনদেনের ব্যর্থ অবস্থা ব্যর্থই থাকবে। পুনরায় চেষ্টার প্রক্রিয়াটি সম্পূর্ণ আলাদা হবে।

ব্যর্থতার কারণ এটি হলে, paymentFailure.3DS1_parameters অবশ্যই সেট করতে হবে। তা না করা হলে, বর্তমান কারণটিকে PAYMENT_ERROR হিসেবে গণ্য করা হবে।

পেমেন্ট ব্যর্থতার তথ্য

পেমেন্ট ব্যর্থতা সম্পর্কিত তথ্য।

JSON উপস্থাপনা 
{
  "threeds1Parameters": {
    object (ThreeDS1Parameters)
  }
}
ক্ষেত্র
threeds1Parameters

object ( ThreeDS1Parameters )

ব্যবহারকারীর সাথে একটি 3DS1 প্রমাণীকরণ প্রোটোকল শুরু করার জন্য RwG অ্যাগ্রিগেটর দ্বারা ব্যবহৃত প্যারামিটারসমূহ। BookingFailure.cause-কে PAYMENT_REQUIRES_3DS1-এ সেট করা না থাকলে এগুলি উপেক্ষা করা হবে।

থ্রিডিএস১প্যারামিটার

RwG-কে একটি 3DS1 চ্যালেঞ্জ সম্পাদন করার অনুরোধ জানিয়ে প্যারামিটারসমূহ।

EMVCo-এর 3DS1 প্রোটোকলের বর্ণনা অনুযায়ী প্যারামিটারগুলো নির্ধারণ করা হয়।

JSON উপস্থাপনা 
{
  "acsUrl": string,
  "paReq": string,
  "transactionId": string,
  "mdMerchantData": string
}
ক্ষেত্র
acsUrl

string

প্রমাণীকরণের জন্য ব্যবহারকারীকে দেখানোর উদ্দেশ্যে ফর্মটি লোড করার URL।

paReq

string

একটি পেমেন্ট প্রমাণীকরণ অনুরোধ। সরবরাহ করা হলে এটি ACSUrl ফর্মে পোস্ট করতে হবে।

transactionId

string

ACS প্রদানকারী কর্তৃক ব্যবহৃত একটি শনাক্তকারী। সরবরাহ করা হলে এটি ACSUrl ফর্মে পোস্ট করতে হবে।

mdMerchantData

string

ব্যবসায়ীর তথ্য। সরবরাহ করা হলে ACSUrl ফর্মে পোস্ট করতে হবে।