Cho phép thanh toán

Trong quá trình tích hợp Đặt chỗ với Google, bạn có thể chọn cho phép người bán nhận tiền thanh toán từ người dùng khi họ đặt trước, đặ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 hoạt động mã hoá. Sau đó, công ty xử lý thanh toán sẽ sử dụng các mã thông báo riêng biệ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ó bảo mật thanh toán, chúng tôi sẽ hiển thị một 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 họ.

Hiện tại, chúng tôi đã cung cấp chức năng hỗ trợ cho 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 các khoản thanh toán thông qua tính năng Đặt chỗ bằng Google, 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 bộ xử lý được hỗ trợ trên trang web của Google Pay.
  2. Chấp nhận khoản thanh toán bằng mã thông báo theo quy trình của công ty xử lý.
  3. Không thể bật chế độ thanh toán cho các yêu cầu đặ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 để 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 bất kỳ người bán nào cần nhận tiền thanh toán cho bất kỳ dịch vụ nào của họ. Để bật chế độ thanh toán, các thay đổi phải được thực hiện đối vớ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 cũng là tập hợp của paymentMethodTokenizationParameters.parameters sẽ được chuyển đến Google Pay nếu bạn muốn tích hợp với nó.
  • Dịch vụ/Nguồn cấp dữ liệu về tình trạng còn hàng: 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 dịch vụ thanh toán.

Máy chủ đặt phòng

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

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

Các trường hợp sử dụng 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ề cách Định cấu hình thanh toán.

Hoàn tất việc đặt 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ập lịch), Google và công ty xử lý thanh toán.

Hình 1: Biểu đồ trình tự cho lượt đặt trước trả trước
Hình 1: Sơ đồ trình tự đặt trước 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, các dịch vụ phải được thanh toán đầy đủ tại thời điểm đặt phòng.
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ụ đó.

Tiền đặt cọc và phí không đến

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

Hình 2: Biểu đồ trình tự các khoản tiền gửi hoặc không đặt cọc
Hình 2: Gửi tiền hoặc không có phí đặt chỗ sơ đồ trình tự

Khách có thể sử dụng khoản tiền đặt cọc và phí không đến để đảm bảo người dùng có thể đặt phòng.

  • Tiền đặt cọ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 đó.
  • Người dùng có thể tính phí không đến nếu không đến xem yêu cầu đặt phòng.
  • Nếu cần, bạn có thể gửi cả tiền đặt cọc và phí không đến cùng nhau cho một lượt đặt phòng.
  • Ngay cả khi không cần thanh toán trước, máy chủ đặt phòng phải phản hồi yêu cầu Create Booking bằng PaymentInformation chứa payment_transaction_id. Đây phải là riêng biệt. payment_transaction_id không cần phải do công ty xử lý thanh toán cung cấp, mà thay vào đó có thể do máy chủ đặt phòng tạo ra.
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

Bạn có thể chỉ định tiền đặt cọc và phí không đến hiển thị ở cấp Dịch vụ hoặc ở cấp Phạm vi cung cấp cho người bán. Nếu bạn chỉ định các dữ liệu này ở cấp vùng quảng cáo, thì sẽ thay thế 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 độ vị trí dịch vụ hoặc phạm vi cung cấp.
  • Để bật phí không đến, hãy thiết lập trường no_show_fee ở cấp dịch vụ hoặc khung giờ rảnh.
  • Đặt trường require_credit_card thành REQUIRE_CREDIT_CARD_CONDITIONAL ở cấp vùng dịch vụ hoặc phạm vi cung cấp.
  • (không bắt buộc) Đặt prepayment_type thành REQUIRED hoặc OPTIONAL.

Bạn cần có thẻ tín dụng

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

Hủy và hoàn tiền

Thông tin về 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 tính năng Đặt chỗ bằng Google. 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 khi thanh toán khi đặt phòng.

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

Nếu bạn phải vô hiệu hóa tính năng huỷ đăng ký khỏi tính năng Đặt chỗ bằng Google, vui lòng thảo luận với đầu mối liên hệ 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 cập nhật 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 dùng nữa cho cả API Đặt chỗ trên Maps và mẫu gRPC.
Thay đổi thành máy chủ đặt trước
  • Khi tính năng Đặt chỗ bằng Google gửi UpdateBookingRequest và việc này sẽ kích hoạt việc hoàn tiền cho người dùng, đặt booking.payment_information.prepayment_status = PREPAYMENT_REFUNDED trong UpdateBookingResponse.