Tổng quan

Trong quá trình tích hợp toàn diện tính năng Đặt chỗ của Trung tâm hành động, bạn có thể chọn cho phép người bán nhận thanh toán từ người dùng khi họ đặt phòng, đặt lịch hẹn hoặc đặt chỗ. Google hợp tác với các công ty xử lý thanh toán để thiết lập tính năng mã hoá. Sau đó, trình xử lý thanh toán sẽ sử dụng mã thông báo duy nhất để thanh toán cho người bán một cách an toàn.

Đối với các lượt đặt phòng có phương thức thanh toán bảo mật, chúng tôi sẽ hiển thị mô-đun Thông tin thanh toán trong quy trình thanh toán. Thao tác này cho phép người dùng nhập thông tin thẻ tín dụng.

Chúng tôi hỗ trợ 3DS1 và 3DS2, vui lòng tham khảo hướng dẫn này về cách triển khai.

Điều kiện sử dụng

Để người bán nhận được khoản thanh toán thông qua Trung tâm hành động, bạn phải đáp ứng các yêu cầu sau:

  1. Sử dụng một công ty xử lý thanh toán được hỗ trợ. Bạn có thể xem danh sách mới nhất về các công ty xử lý được hỗ trợ trên trang web của Google Pay.
  2. Chấp nhận thanh toán bằng mã thông báo theo công ty xử lý thanh toán của bạn.
  3. Hoàn tất quy trình xác minh danh tính và hoạt động kinh doanh được nêu tại đây.
  4. Bạn không thể bật tính năng thanh toán cho những yêu cầu đặt phòng yêu cầu xác nhận không đồng bộ .

Thay đổi đối với nguồn cấp dữ liệu và máy chủ đặt phòng cho các khoản thanh toán

Các khoản thanh toán được thực hiện thông qua quy trình chọn tham gia ở cấp người bán. Bạn phải bật tính năng thanh toán cho mọi người bán cần nhận thanh toán cho bất kỳ dịch vụ nào của họ. Để bật tính năng thanh toán, bạn phải thay đổi nguồn cấp dữ liệu và máy chủ đặt phòng.

Nguồn cấp dữ liệu

  • Nguồn cấp dữ liệu người bán: Chỉ định thông tin thanh toán thông qua tokenization_parameter được đặt trong trường tokenization_config. Tập hợp này phụ thuộc vào công ty xử lý thanh toán đã chọn. Tập hợp này là cùng một tập hợp paymentMethodTokenizationParameters.parameters sẽ được truyền đến Google Pay nếu bạn tích hợp với Google Pay.
  • Nguồn cấp dữ liệu về dịch vụ/khả năng cung cấp: Chỉ định các yêu cầu thanh toán dựa trên trường hợp sử dụng phù hợp của bạn. Để biết thêm thông tin, hãy xem phần Các trường hợp sử dụng thanh toán.

Máy chủ đặt phòng

Các trường hợp sử dụng thanh toán

Khi quyết định có nhận thanh toán cho từng trường hợp sử dụng này hay không, vui lòng xem lại Chính sách thanh toán của chúng tôi và đảm bảo rằng bạn có thể tuân thủ tất cả chính sách có liên quan.

Dưới đây là các trường hợp sử dụng cho khoản thanh toán:

Để biết thêm thông tin về cách triển khai từng trường hợp sử dụng này, hãy xem hướng dẫn về Định cấu hình thanh toán.

Hoàn tất các lượt đặt trước có trả trước

Hình 1 cho thấy luồng hoạt động giữa người dùng, bạn (đối tác lên lịch), Google và đơn vị xử lý thanh toán.

Hình 1: Sơ đồ trình tự đặt phòng trả trước
Hình 1: Sơ đồ trình tự đặt phòng trả trước
  • Khoản thanh toán phải bằng 100% số tiền chi phí dịch vụ. Nói cách khác, bạn phải thanh toán toàn bộ cho các dịch vụ tại thời điểm đặt trước.
Thay đổi đối với nguồn cấp dữ liệu dịch vụ
  • Đặt trường prepayment_type thành REQUIRED cho dịch vụ đó.
  • Đặt trường require_credit_card thành REQUIRE_CREDIT_CARD_CONDITIONAL cho dịch vụ đó.

Khoản đặt cọc và phí không đến

Bạn có thể thiết lập khoản đặt cọc và phí không đến nhận phòng theo cách tương tự. Hình 2 cho thấy luồng của các hoạt động này giữa người dùng, bạn (đối tác lên lịch), Google và đơn vị xử lý thanh toán.

Hình 2: Sơ đồ trình tự đặt phòng có đặt cọc hoặc tính phí khách không đến
Hình 2: Sơ đồ trình tự đặt phòng có đặt cọc hoặc phí không đến

Bạn có thể sử dụng khoản tiền đặt cọc và phí không đến để đảm bảo người dùng sẽ đến nhận phòng theo yêu cầu đặt phòng.

  • Khoản tiền đặt trước có thể được tính vào thẻ tín dụng của người dùng ngay lập tức hoặc sau này.
  • Người dùng có thể bị tính phí không đến nếu họ không đến dự buổi đặt phòng.
  • Nếu cần, bạn có thể áp dụng cả khoản đặt cọc và phí vắng mặt cho một lượt đặt phòng.
  • Ngay cả khi không yêu cầu thanh toán trước, máy chủ đặt phòng phải phản hồi yêu cầu CreateBooking bằng một PaymentInformation chứa một payment_transaction_id duy nhất. payment_transaction_id không cần phải do công ty xử lý thanh toán cung cấp, mà có thể do máy chủ đặt phòng tạo.
Thay đổi đối với dịch vụ hoặc nguồn cấp dữ liệu về tình trạng còn hàng

Người bán có thể chỉ định khoản đặt cọc và phí không đến của khách hàng ở cấp Dịch vụ hoặc ở cấp khung giờ Khả năng cung cấp. Nếu bạn chỉ định các giá trị này ở cấp khung giờ, thì các giá trị đó sẽ ghi đè các định nghĩa ở cấp dịch vụ.

  • Để bật khoản đặt cọc, hãy đặt trường deposit ở cấp dịch vụ hoặc cấp khung giờ trống.
  • Để bật phí không đến, hãy đặt trường no_show_fee ở cấp dịch vụ hoặc khung giờ trống.
  • Đặt trường require_credit_card thành REQUIRE_CREDIT_CARD_CONDITIONAL ở cấp dịch vụ hoặc vị trí trống.
  • (không bắt buộc) Đặt prepayment_type thành REQUIRED hoặc OPTIONAL.

Cần có thẻ tín dụng

Có thể có các trường hợp sử dụng khác yêu cầu thẻ tín dụng tại thời điểm đặt phòng.

Huỷ và hoàn tiền

Việc huỷ và hoàn tiền do đối tác (bạn) hoặc người dùng thực hiện thông qua Trung tâm hành động. Trong cả hai trường hợp, bạn phải tuân thủ CancellationPolicy được đặt ở Cấp dịch vụ và thông báo cho người dùng tại bước thanh toán khi đặt phòng.

Nếu bạn không cung cấp CancellationPolicy, thì mọi yêu cầu huỷ trong khoảng thời gian huỷ do min_advance_online_canceling xác định và được đặt ở Mức dịch vụ đều được hoàn tiền. Nếu không xác định min_advance_online_canceling, giá trị sẽ là 0 (có nghĩa là có thể huỷ bất cứ lúc nào).

Nếu bạn phải tắt tính năng huỷ từ phía Trung tâm hành động, vui lòng thảo luận với Người liên hệ chính của Google.

Thay đổi đối với RTU
  • Sau khi hoàn tiền cho người dùng, bạn phải gửi một yêu cầu cập nhật thông tin đặt phòng RTU để thay đổi trạng thái thanh toán của yêu cầu đặt phòng. Đặt update_mask thành status,payment_information.prepayment_status và đặt payment_information.prepayment_status = PREPAYMENT_REFUNDED và status = CANCELED.
    • Sử dụng BookingStatus = CANCELED và PrepaymentStatus = PREPAYMENT_REFUNDED mới. Giá trị enum CANCELED_AUTOMATIC_REFUND không còn được dùng nữa cho cả API Đặt phòng của Maps và các mẫu gRPC.
Thay đổi thành Máy chủ đặt phòng
  • Khi Trung tâm hành động gửi một UpdateBookingRequest và điều này kích hoạt việc hoàn tiền cho người dùng, hãy đặt booking.payment_information.prepayment_status = PREPAYMENT_REFUNDED trong UpdateBookingResponse.