Trang này được dịch bởi Cloud Translation API.

Chỉ định hình thức thanh toán

Điều kiện tiên quyết

Để xem hướng dẫn này, bạn phải hoàn thành các bước sau:

Hiểu rõ Chính sách thanh toán của chúng tôi.
Đã hoàn tất phần Xuất nguồn cấp dữ liệu của tính năng Tích hợp E2E.

Sau đây là những hình thức thanh toán được hỗ trợ cho tiện ích bổ sung này:

Trả Tiền Trước
Phí vắng mặt / Phí huỷ
Ký quỹ
Cần có thẻ tín dụng

Mọi trường hợp sử dụng dịch vụ thanh toán đều là phần mở rộng của trường hợp sử dụng không thanh toán/trả tiền khi đến nơi (không yêu cầu cấu hình thanh toán). Vì vậy, hướng dẫn này sẽ bắt đầu bằng cách mô tả cấu hình đó và coi các cấu hình khác là tiện ích.

Trả Tiền Trước

Cấu hình này dùng để chỉ định rằng bạn phải thanh toán toàn bộ số tiền cho dịch vụ tại thời điểm đặt trước. Khoản thanh toán trước được chỉ định ở cấp độ còn hàng thông qua trường payment của nguồn cấp dữ liệu Avaibility.

{
  "availability": [{
    "merchant_id": "dining-A",
    "service_id": "reservation",
    "start_sec": 1535853600,
    "duration_sec": 2700,
    "spots_total": 2,
    "spots_open": 2,
    "resources": {
    "room_id": "A-dining-room",
    "room_name": "Wine Tasting Room",
    "party_size": 2,
    "prepayment": {
      "price_info": {
        "price": {
          "price_micros": 200000000,
          "currency_code": "USD",
          },
        "price_type": "PER_PERSON"
        }
      }
    }
  }]
}

Phí vắng mặt

Người dùng có thể phải trả phí vắng mặt nếu họ không tham dự lượt đặt chỗ hoặc nếu họ huỷ sau thời hạn huỷ. Nếu bạn không chỉ định khung thời gian huỷ, thời gian bắt đầu sẽ được đặt mặc định theo mặc định.

Để chỉ định phí vắng mặt, trong nguồn cấp dữ liệu dịch vụ, bạn cần thêm trường no_show_fee như trong ví dụ sau:

{
    "merchant_id": "merchant-1",
    "service_id": "service-2-b",
    "name": "Reservation",
    "description": "A dining reservation",
    "price": {
        "price_micros": 200000000,
        "currency_code": "USD"
    },
    "scheduling_rules": {
        "min_advance_online_canceling": 14400,
    },
    "no_show_fee": {
        "fee": {
            "price_micros": 25000000,
            "currency_code": "USD"
        },
        "fee_type": "FIXED_RATE_DEFAULT"
    }
}

Trong ví dụ này, đối tác hoặc người bán được uỷ quyền tính một khoản phí cố định là 25 USD như đã chỉ định trong trường no_show_fee.fee.price_micros nếu chủ cuộc hẹn không tham gia cuộc hẹn. Phí này cũng có thể được tính nếu người dùng huỷ trong vòng 4 giờ (14400 giây) trước cuộc hẹn, như được chỉ định trong trường scheduling_rules.min_advance_online_canceling.

Để biết cách bạn không thể xác định phí hiển thị trong nguồn cấp dữ liệu về tình trạng phòng, hãy xem phần Ghi đè giá ở cấp độ phòng trống.

Bạn có thể tuỳ ý thiết lập phương thức không tính phí cho mỗi người để đặt trước. Trong trường hợp này, bạn có thể đặt no_show_fee.fee.fee_type thành PER_PERSON.

Ký quỹ

Tiền đặt cọc được dùng để thu khoản phí ban đầu theo yêu cầu khi đặt phòng. Bạn có thể trả tiền đặt cọc tại thời điểm đặt phòng hoặc tại thời điểm sau này. Bạn có thể cần phải xác định điều khoản mà một khoản đặt cọc có thể được hoàn lại cũng như thời điểm có thể huỷ lượt đặt phòng trực tuyến.

Để chỉ định một khoản tiền gửi, trong nguồn cấp dữ liệu dịch vụ, bạn nên bao gồm trường deposit như minh hoạ trong ví dụ sau:

{
    "merchant_id": "merchant-1",
    "service_id": "service-2-b",
    "name": "Reservation",
    "description": "A dining reservation",
    "price": {
        "price_micros": 200000000,
        "currency_code": "USD"
    },
    "scheduling_rules": {
        "min_advance_online_canceling": 86400,
    },
    "deposit": {
        "deposit": {
            "price_micros": 25000000,
            "currency_code": "USD",
            "min_advance_cancellation_sec": 14400,
        },
        "deposit_type": "FIXED_RATE_DEFAULT"
    }
}

Trong ví dụ này, min_advance_online_canceling xác định thời hạn huỷ, còn deposit.min_advance_cancellation_sec xác định thời điểm có thể hoàn lại khoản tiền đặt cọc. Xin lưu ý rằng trong ví dụ này, khoản tiền đặt cọc có thể chỉ định thời gian huỷ riêng biệt với điều khoản hoàn tiền. Trong trường hợp này, người dùng có thể huỷ dịch vụ trực tuyến trước tối đa 24 giờ (86400 giây). Điều này đảm bảo rằng người bán được thông báo trực tiếp về mọi yêu cầu huỷ trễ. Tuy nhiên, người dùng có thể vẫn đủ điều kiện được hoàn tiền cho khoản đặt cọc của họ cho đến 4 giờ trước (14.400 giây) trước khi đặt phòng (bằng cách liên hệ với bạn hoặc người bán để huỷ). Khoản tiền này sẽ được hiển thị trong điều khoản ở bước thanh toán và trong email xác nhận.

Để xem cách xác định khoản tiền đặt cọc ở cấp độ sẵn có, hãy xem phần Ghi đè giá ở cấp độ sẵn có.

Ngoài ra, xin lưu ý rằng, giống như phí vắng mặt, tiền đặt cọc có thể được tính theo tỷ lệ cố định hoặc theo mức giá mỗi người. Trong trường hợp này, khoản tiền gửi là mức giá cố định là 25 USD, do "deposit_type": "FIXED_RATE_DEFAULT" chỉ định. Nếu lượt đặt phòng có bao gồm một nhóm người, thì bạn có thể chỉ định khoản tiền đặt cọc này là khoản tiền đặt cọc cho mỗi người bằng cách đặt "deposit_type": "PER_PERSON".

Yêu cầu thẻ tín dụng

Một dịch vụ có thể yêu cầu thẻ tín dụng như một cách bổ sung để xác minh danh tính. Tuy nhiên, bạn không nên sử dụng hình thức thanh toán này cho các khoản thanh toán trước, tiền đặt cọc hoặc phí không hiển thị. Nếu bắt buộc, bạn phải định cấu hình các trường hợp sử dụng đó một cách rõ ràng. Việc yêu cầu thẻ tín dụng thường sẽ làm giảm đáng kể số lượt đặt trước cho dịch vụ này.

Để yêu cầu cung cấp thẻ tín dụng trong quá trình thanh toán, bạn phải đặt trường require_credit_card thành REQUIRE_CREDIT_CARD_ALWAYS.

{
    "merchant_id": "merchant-1",
    "service_id": "reservation",
    "name": "reservation",
    "description": "Food reservation",
    "require_credit_card": "REQUIRE_CREDIT_CARD_ALWAYS"
}

Ghi đè giá ở cấp độ khả dụng

Cấu trúc giá và phí được chỉ định ở cấp Dịch vụ. Trong hầu hết các trường hợp, bạn nên sử dụng mức giá cấp dịch vụ này. Tuy nhiên, bạn nên thay đổi cấu trúc thanh toán cho một số vị trí còn trống nhất định. Ví dụ: các tình huống sau có thể được xử lý bằng cách ghi đè giá hoặc phí ở cấp độ tình trạng phòng:

Giá giảm vào thứ Ba và tăng vào thứ Bảy.
Phí chương trình không áp dụng cho phòng trống trong khoảng thời gian từ 17:00 đến 19:00.
Yêu cầu đặt cọc cho quy mô bên lớn hơn 6 người.
Bạn phải có thẻ tín dụng để đặt phòng trong một phòng nhất định.

Đối với mỗi phương thức thanh toán / phí, bảng loại thanh toán sẽ liệt kê trường nào cần sử dụng trong nguồn cấp dữ liệu tình trạng còn hàng để ghi đè định nghĩa cấp dịch vụ.

Hình thức thanh toán	Định nghĩa nguồn cấp dữ liệu	Có thể ghi đè?
Trả Tiền Trước	Availability.prepayment	Không vượt quá
Phí vắng mặt	Service.no_show_fee	Availability.no_show_fee
Ký quỹ	Service.deposit	Availability.deposit