ในการผสานรวมการจองกับ Google แบบครบวงจร คุณสามารถเลือกใช้ผู้ขายเพื่อรับการชําระเงินจากผู้ใช้เมื่อทําการจอง การนัดหมาย หรือการจอง Google ทํางานร่วมกับผู้ประมวลผลการชําระเงินเพื่อตั้งค่าโทเค็น ผู้ประมวลผลการชําระเงินจะใช้โทเค็นที่ไม่ซ้ํากันเพื่อให้ผู้ขายชําระเงินได้อย่างปลอดภัย
สําหรับการจองที่ปลอดภัยด้วยการชําระเงิน เราจะแสดงผลโมดูลข้อมูลการชําระเงินในขั้นตอนการชําระเงิน ซึ่งจะช่วยให้ผู้ใช้ป้อนข้อมูลบัตรเครดิตได้
ดูการสนับสนุนเกี่ยวกับ 3DS1 และ 3DS2 ได้ในบทแนะนํานี้เกี่ยวกับการใช้งาน
การมีสิทธิ์
คุณต้องปฏิบัติตามข้อกําหนดต่อไปนี้เพื่อให้ผู้ขายรับการชําระเงินผ่าน "จองกับ Google" ได้
- ใช้ผู้ประมวลผลการชําระเงินที่รองรับ ดูรายชื่อผู้ประมวลผลข้อมูลล่าสุดที่รองรับได้ในเว็บไซต์ Google Pay
- ยอมรับการชําระเงินด้วยโทเค็นที่สอดคล้องกับผู้ประมวลผลข้อมูล
- เปิดใช้การชําระเงินสําหรับการจองที่ต้องมีการยืนยันแบบไม่พร้อมกันไม่ได้
การเปลี่ยนแปลงของฟีดและเซิร์ฟเวอร์การจองสําหรับการชําระเงิน
การชําระเงินจะดําเนินการผ่านการเลือกใช้ในระดับผู้ขาย คุณต้องเปิดใช้การชําระเงินสําหรับผู้ขายที่ต้องการรับการชําระเงินสําหรับบริการใดก็ตาม หากต้องการเปิดใช้การชําระเงิน คุณต้องทําการเปลี่ยนแปลงฟีดและเซิร์ฟเวอร์การจอง
ฟีด
- ฟีดผู้ขาย: ระบุข้อมูลการชําระเงินผ่าน
tokenization_parameter
ที่ตั้งค่าไว้ในช่องtokenization_config
ชุดจะขึ้นอยู่กับผู้ประมวลผลการชําระเงินที่เลือก ชุดดังกล่าวคือชุดของpaymentMethodTokenizationParameters.parameters
ชุดเดียวกับที่จะส่งไปยัง Google Pay หากคุณผสานรวมกับชุดดังกล่าว - ฟีดบริการ/ฟีดความพร้อมใช้งาน: ระบุข้อกําหนดการชําระเงินตามกรณีการใช้งานที่เหมาะสม โปรดดูรายละเอียดเพิ่มเติมที่หัวข้อกรณีการใช้งานสําหรับการชําระเงิน
เซิร์ฟเวอร์การจอง
- ใช้วิธีการ
CreateBooking
ตามประเภทการชําระเงินที่ผู้ใช้ดําเนินการ - Google จะส่งโทเค็นการชําระเงินในช่อง
payment_processing_parameters.unparsed_payment_method_token
ซึ่งเป็นส่วนหนึ่งของCreateBookingRequest
นี่คือpaymentData
เดียวกันกับที่ติดต่อกลับในการผสานรวม Google Pay - ใน
CreateBookingResponse
มีข้อความ PaymentInfo ซึ่งระบุรูปแบบการชําระเงิน, สถานะ, รหัสธุรกรรม และโครงสร้างราคา / ค่าธรรมเนียม - ตั้งค่าช่อง
payment_information.payment_processed_by
เป็นPROCESSED_BY_PARTNER
ในCreateBookingResponse
กรณีการใช้งานสําหรับการชําระเงิน
เมื่อตัดสินใจว่าจะชําระเงินสําหรับกรณีการใช้งานแต่ละรายการเหล่านี้หรือไม่ โปรดอ่านนโยบายการชําระเงินของเราและตรวจสอบว่าคุณปฏิบัติตามนโยบายที่เกี่ยวข้องทั้งหมด
กรณีการใช้งานสําหรับการชําระเงินมีดังนี้
- ทําการจองล่วงหน้าให้เสร็จสมบูรณ์
- ต้องมีค่ามัดจําสําหรับการจอง
- ค่าธรรมเนียมการไม่แสดงตัวในกรณีที่ผู้ใช้ไม่แสดงการจอง
- ต้องใช้บัตรเครดิตสําหรับการจอง
ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีใช้งานกรณีการใช้งานแต่ละรายการเหล่านี้ได้ที่บทแนะนําเกี่ยวกับการกําหนดค่าการชําระเงิน
เสร็จสิ้นการจองล่วงหน้า
รูปที่ 1 แสดงขั้นตอนการดําเนินการระหว่างผู้ใช้ คุณ (พาร์ทเนอร์การกําหนดเวลา) Google และผู้ประมวลผลการชําระเงิน
- การชําระเงินต้องเป็น 100% ของค่าใช้จ่ายบริการ กล่าวคือ คุณต้องชําระค่าบริการเต็มจํานวนเมื่อจอง
-
ตั้งค่าช่อง
prepayment_type
เป็นREQUIRED
สําหรับบริการนั้น - ตั้งค่าช่อง
require_credit_card
เป็นREQUIRE_CREDIT_CARD_CONDITIONAL
สําหรับบริการนั้น
เงินมัดจําและค่าธรรมเนียมที่ไม่แสดง
ค่าธรรมเนียมมัดจําและค่าธรรมเนียมสําหรับการไม่แสดงตัวนั้นตั้งค่าในลักษณะเดียวกัน รูปที่ 2 แสดงโฟลว์กิจกรรมเหล่านี้ระหว่างผู้ใช้ คุณ (พาร์ทเนอร์การกําหนดเวลา) Google และผู้ประมวลผลการชําระเงิน
สามารถใช้ค่าธรรมเนียมมัดจําและค่าธรรมเนียมแบบไม่แสดงตัวเพื่อให้ผู้ใช้จองห้องพักได้
- เงินมัดจําดังกล่าวสามารถเรียกเก็บจากบัตรเครดิตของผู้ใช้ล่วงหน้าหรือในภายหลัง
- มีการเรียกเก็บค่าธรรมเนียมการไม่แสดงตัวแก่ผู้ใช้หากไม่แสดงกับการจอง
- หากจําเป็น ทั้งจํานวนมัดจําและค่าธรรมเนียมไม่แสดงตัว จะใช้ร่วมกับการจองได้
- แม้ว่าไม่จําเป็นต้องชําระเงินล่วงหน้า แต่เซิร์ฟเวอร์การจองต้องตอบกลับคําขอ CreateBooking ด้วย
PaymentInformation
ที่มีpayment_transaction_id
ซึ่งต้องไม่ซ้ํากัน ผู้ประมวลผลการชําระเงินไม่จําเป็นต้องใช้payment_transaction_id
แต่เซิร์ฟเวอร์การจองอาจสร้างค่านี้แทนได้
คุณระบุค่าธรรมเนียมและค่าธรรมเนียมการไม่แสดงตัวได้ที่ระดับบริการหรือที่ระดับช่องความพร้อมให้บริการสําหรับผู้ขาย หากคุณระบุที่ระดับช่องความพร้อมใช้งาน การลบล้างดังกล่าวจะลบล้างคําจํากัดความระดับบริการ
- หากต้องการเปิดใช้เงินฝากทดสอบ ให้ตั้งค่าช่อง
deposit
ที่ระดับช่องบริการหรือความพร้อมให้บริการ - หากต้องการเปิดใช้ค่าธรรมเนียมที่ไม่แสดง ให้กําหนดค่าช่อง
no_show_fee
ที่ระดับช่องบริการหรือความพร้อมให้บริการ - ตั้งค่าช่อง
require_credit_card
เป็นREQUIRE_CREDIT_CARD_CONDITIONAL
ที่ระดับช่องบริการหรือเวลาว่าง - (ไม่บังคับ) ตั้งค่า
prepayment_type
เป็นREQUIRED
หรือOPTIONAL
ต้องใช้บัตรเครดิต
กรณีการใช้งานอื่นๆ ที่ต้องใช้บัตรเครดิต ณ เวลาที่จอง
- ตั้งค่าช่อง
require_credit_card
เป็นREQUIRE_CREDIT_CARD_ALWAYS
ที่ระดับ Service หรือที่ระดับช่อง availability สําหรับผู้ขาย
การยกเลิกและการคืนเงิน
การยกเลิกและการคืนเงินอาจเริ่มต้นโดยพาร์ทเนอร์ (คุณ) หรือโดยผู้ใช้ผ่าน "จองกับ Google" ในทั้ง 2 กรณี คุณต้องเคารพ
CancellationPolicy
ซึ่งกําหนดไว้ที่ระดับบริการและสื่อสารกับผู้ใช้ที่จุดชําระเงินของการจอง
หากคุณไม่ได้ระบุ CancellationPolicy
ระบบจะถือว่ามีการยกเลิกภายในกรอบเวลาการยกเลิกที่กําหนดโดย min_advance_online_canceling
ซึ่งกําหนดไว้ที่ระดับบริการ
หากไม่มีการระบุ min_advance_online_canceling
เป็น 0 (หมายถึงยกเลิกได้ทุกเมื่อ)
หากคุณจําเป็นต้องปิดใช้การยกเลิกจากฝั่ง "จองกับ Google" โปรดปรึกษา POC ของ Google
การเปลี่ยนแปลง RTU- หลังจากคืนเงินให้ผู้ใช้แล้ว คุณต้องอัปเดต RTU การจองเพื่อเปลี่ยนสถานะการชําระเงินของการจอง ตั้งค่า
update_mask
เป็นstatus,payment_information.prepayment_status
และตั้งค่าpayment_information.prepayment_status = PREPAYMENT_REFUNDED
และstatus = CANCELED
- ใช้
BookingStatus = CANCELED
และPrepaymentStatus = PREPAYMENT_REFUNDED
ใหม่ ค่า EnumCANCELED_AUTOMATIC_REFUND
เลิกใช้งานแล้วสําหรับเทมเพลต Maps Booking API และ gRPC
- ใช้
- เมื่อ "จองกับ Google" ส่ง
UpdateBookingRequest
และ การดําเนินการนี้จะขอเงินคืนสําหรับผู้ใช้ ให้ตั้งค่าbooking.payment_information.prepayment_status = PREPAYMENT_REFUNDED
ในUpdateBookingResponse