Tổng quan

Trong quá trình tích hợp liên tục về yêu cầu đặt chỗ trong Trung tâm hành động, bạn có thể chọn cho phép người bán nhận khoản thanh toán từ người dùng khi họ đặt chỗ, đặ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 quá trình mã hoá. Sau đó, công ty xử lý thanh toán sẽ dùng nhữ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 vé được đảm bảo thanh toán, chúng tôi sẽ hiển thị mô-đun Thông tin thanh toán trong quy trình thanh toán. Điều này cho phép người dùng nhập thông tin thẻ tín dụng của mình.

Có 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 có thể nhận tiề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ề những đơn vị xử lý được hỗ trợ trên trang web của Google Pay.
  2. Chấp nhận khoản thanh toán được mã hoá theo quy định của đơn vị xử lý của bạn.
  3. Hoàn tất quy trình xác minh danh tính và quy trình xác minh doanh nghiệp nêu tại đây.
  4. Bạn không thể bật tính năng thanh toán cho những lượt đặt phòng yêu cầu xác nhận không đồng bộ .

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

Các khoản thanh toán được thực hiện 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 những người bán cần nhận khoả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 điều chỉnh 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 của 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 bạn chọn. Bộ này chính là bộ paymentMethodTokenizationParameters.parameters sẽ được chuyển đến Google Pay nếu bạn tích hợp với nó.
  • Dịch vụ/Nguồn cấp dữ liệu về khả năng thanh toán: Chỉ định các yêu cầu về thanh toán dựa trên trường hợp sử dụng thích 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

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ả các chính sách có liên quan.

Có các trường hợp sử dụng phương thức thanh toán sau:

Để 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ề cách Định cấu hình thanh toán.

Hoàn tất yêu cầu đặt trướ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ự lượt đặt trước trả trước
Hình 1: Sơ đồ trình tự lượt đặt trước
  • Khoản thanh toán phải là 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ộ phí 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ụ đó.

Đặt cọc tiền và phí vắng mặt

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

Hình 2: Biểu đồ trình tự đặt trước phí hoặc vắng mặt
Hình 2: Sơ đồ trình tự đặt khoản tiền gửi hoặc phí vắng mặt

Bạn có thể sử dụng tiền đặt cọc và phí vắng mặt để đảm bảo người dùng có mặt để đặt phòng.

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

Bạn có thể chỉ định tiền đặt cọc và phí vắng mặt ở cấp Dịch vụ hoặc ở cấp vùng Khả năng lập chỉ mục cho người bán. Nếu bạn chỉ định các giá trị này ở cấp vùng tình trạng còn hàng, thì giá trị này sẽ ghi đè các định nghĩa cấp dịch vụ.

  • Để cho phép gửi tiền, hãy đặt trường deposit ở cấp độ dịch vụ hoặc thời gian trống.
  • Để bật phí vắng mặt, hãy đặt trường no_show_fee ở cấp dịch vụ hoặc thời gian rảnh.
  • Đặt trường require_credit_card thành REQUIRE_CREDIT_CARD_CONDITIONAL ở cấp độ dịch vụ hoặc khả năng sử dụ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 phải có thẻ tín dụng tại thời điểm đặt trước.

Huỷ và hoàn tiền

Hành động huỷ và hoàn tiền là 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 tôn trọng CancellationPolicy được đặt ở Cấp dịch vụ và thông báo cho người dùng khi thanh toán đặt trước.

Nếu bạn không cung cấp CancellationPolicy, thì hệ thống giả định rằng mọi lượt huỷ trong thời hạn huỷ do min_advance_online_canceling xác định và được đặt ở Cấp dịch vụ đều có thể được hoàn tiền. Nếu bạn 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ỷ trong trung tâm Hành động, vui lòng thảo luận với đầu mối liên hệ của Google.

Các thay đổi đối với RTU
  • Sau khi hoàn tiền cho người dùng, bạn phải gửi cập nhật RTU đặt phòng để 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 rồi đặt payment_information.prepayment_status = PREPAYMENT_REFUNDED và status = CANCELED.
    • Hãy sử dụng BookingStatus = CANCELED và PrepaymentStatus = PREPAYMENT_REFUNDED mới. Ngừng sử dụng giá trị enum CANCELED_AUTOMATIC_REFUND cho cả API đặt phòng của Maps và mẫu gRPC.
Thay đổi đối với máy chủ đặt phòng
  • Khi Trung tâm hành động gửi một UpdateBookingRequest và thao tác này sẽ 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.