การเปิดใช้การชําระเงิน

ในการผสานรวมการจองกับ Google แบบครบวงจร คุณสามารถเลือกใช้ผู้ขายเพื่อรับการชําระเงินจากผู้ใช้เมื่อทําการจอง การนัดหมาย หรือการจอง Google ทํางานร่วมกับผู้ประมวลผลการชําระเงินเพื่อตั้งค่าโทเค็น ผู้ประมวลผลการชําระเงินจะใช้โทเค็นที่ไม่ซ้ํากันเพื่อให้ผู้ขายชําระเงินได้อย่างปลอดภัย

สําหรับการจองที่ปลอดภัยด้วยการชําระเงิน เราจะแสดงผลโมดูลข้อมูลการชําระเงินในขั้นตอนการชําระเงิน ซึ่งจะช่วยให้ผู้ใช้ป้อนข้อมูลบัตรเครดิตได้

ดูการสนับสนุนเกี่ยวกับ 3DS1 และ 3DS2 ได้ในบทแนะนํานี้เกี่ยวกับการใช้งาน

การมีสิทธิ์

คุณต้องปฏิบัติตามข้อกําหนดต่อไปนี้เพื่อให้ผู้ขายรับการชําระเงินผ่าน "จองกับ Google" ได้

  1. ใช้ผู้ประมวลผลการชําระเงินที่รองรับ ดูรายชื่อผู้ประมวลผลข้อมูลล่าสุดที่รองรับได้ในเว็บไซต์ Google Pay
  2. ยอมรับการชําระเงินด้วยโทเค็นที่สอดคล้องกับผู้ประมวลผลข้อมูล
  3. เปิดใช้การชําระเงินสําหรับการจองที่ต้องมีการยืนยันแบบไม่พร้อมกันไม่ได้

การเปลี่ยนแปลงของฟีดและเซิร์ฟเวอร์การจองสําหรับการชําระเงิน

การชําระเงินจะดําเนินการผ่านการเลือกใช้ในระดับผู้ขาย คุณต้องเปิดใช้การชําระเงินสําหรับผู้ขายที่ต้องการรับการชําระเงินสําหรับบริการใดก็ตาม หากต้องการเปิดใช้การชําระเงิน คุณต้องทําการเปลี่ยนแปลงฟีดและเซิร์ฟเวอร์การจอง

ฟีด

  • ฟีดผู้ขาย: ระบุข้อมูลการชําระเงินผ่าน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 และผู้ประมวลผลการชําระเงิน

รูปที่ 1: แผนภาพลําดับการจองแบบชําระล่วงหน้า
รูปที่ 1: แผนภาพลําดับการจองแบบชําระล่วงหน้า
  • การชําระเงินต้องเป็น 100% ของค่าใช้จ่ายบริการ กล่าวคือ คุณต้องชําระค่าบริการเต็มจํานวนเมื่อจอง
การเปลี่ยนแปลงเกี่ยวกับฟีดบริการ
  • ตั้งค่าช่อง prepayment_type เป็น REQUIRED สําหรับบริการนั้น
  • ตั้งค่าช่อง require_credit_card เป็น REQUIRE_CREDIT_CARD_CONDITIONAL สําหรับบริการนั้น

เงินมัดจําและค่าธรรมเนียมที่ไม่แสดง

ค่าธรรมเนียมมัดจําและค่าธรรมเนียมสําหรับการไม่แสดงตัวนั้นตั้งค่าในลักษณะเดียวกัน รูปที่ 2 แสดงโฟลว์กิจกรรมเหล่านี้ระหว่างผู้ใช้ คุณ (พาร์ทเนอร์การกําหนดเวลา) Google และผู้ประมวลผลการชําระเงิน

รูปที่ 2: แผนภาพลําดับการฝากหรือค่าธรรมเนียมการไม่แสดงตัว
รูปที่ 2: เงินมัดจําหรือค่าธรรมเนียมการไม่แสดงตัว แผนภาพลําดับการจอง

สามารถใช้ค่าธรรมเนียมมัดจําและค่าธรรมเนียมแบบไม่แสดงตัวเพื่อให้ผู้ใช้จองห้องพักได้

  • เงินมัดจําดังกล่าวสามารถเรียกเก็บจากบัตรเครดิตของผู้ใช้ล่วงหน้าหรือในภายหลัง
  • มีการเรียกเก็บค่าธรรมเนียมการไม่แสดงตัวแก่ผู้ใช้หากไม่แสดงกับการจอง
  • หากจําเป็น ทั้งจํานวนมัดจําและค่าธรรมเนียมไม่แสดงตัว จะใช้ร่วมกับการจองได้
  • แม้ว่าไม่จําเป็นต้องชําระเงินล่วงหน้า แต่เซิร์ฟเวอร์การจองต้องตอบกลับคําขอ 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 ใหม่ ค่า Enum CANCELED_AUTOMATIC_REFUND เลิกใช้งานแล้วสําหรับเทมเพลต Maps Booking API และ gRPC
การเปลี่ยนแปลงไปยังเซิร์ฟเวอร์การจอง
  • เมื่อ "จองกับ Google" ส่ง UpdateBookingRequest และ การดําเนินการนี้จะขอเงินคืนสําหรับผู้ใช้ ให้ตั้งค่า booking.payment_information.prepayment_status = PREPAYMENT_REFUNDED ใน UpdateBookingResponse