前提条件
要完成本指南,您必须完成以下操作:
以下是此插件支持的付款方式:
- 预付款
- 违约金 / 取消费
- 押金
- 需要提供信用卡
所有付款用例都是无付款/到货即付用例(无需付款配置)的扩展,因此本教程首先介绍该配置,并将其他配置视为扩展。
预付款
此配置用于指定必须在预订时全额支付服务费用。预付款通过 Avaibility
Feed 的 payment
字段在可用性级别指定。
{
"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"
}
}
}
}]
}
违约金
如果用户未参加预订,或在取消期限后取消预订,系统可能会收取违约金。如果未指定取消时间范围,则默认为空档的开始时间。
如需指定违约金,您应在服务 Feed 中添加 no_show_fee
字段,如以下示例所示:
{
"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"
}
}
在此示例中,如果预约持有人未出席预约,合作伙伴或商家有权收取 no_show_fee.fee.price_micros
字段中指定的 25 美元的固定费率费用。如果用户在预约前的 4 小时(14400 秒)内取消预约,可能也会收取这项费用(如 scheduling_rules.min_advance_online_canceling
字段中所指定)。
如需了解如何在可用性 Feed 中定义违约金,请参阅替换可用性级别的价格。
您可以视情况将违约金配置为按人均价支付预订费用。在这种情况下,可以将 no_show_fee.fee.fee_type
设为 PER_PERSON
。
押金
押金用于收取初步费用,以作为预订要求。 可能会在预订时或之后收取押金。您可能需要指定根据哪些条款可退还押金以及何时可以在线取消预订。
如需指定存款,您应在服务 Feed 中添加 deposit
字段,如以下示例所示:
{
"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"
}
}
在此示例中,min_advance_online_canceling
定义了取消时间范围,deposit.min_advance_cancellation_sec
定义了押金何时可退款。请注意,在示例中,存款可以在退款期限之外单独指定取消时间。在这种情况下,用户最多可以提前 24 小时(86400 秒)在线取消服务。这样可以确保商家能够直接获悉任何延迟取消的情况。不过,在预订前至少提前 4 小时(14400 秒)(通过联系您或商家取消预订),用户仍可能获得押金退款,具体内容会在结账时的条款和确认电子邮件中显示。
如需了解如何在可用性级别定义押金,请参阅替换可用性级别的价格。
另请注意,与违约金一样,押金可能会按固定费率或人均费率收取。在本示例中,这笔存款是 25 美元的固定利率,具体由 "deposit_type": "FIXED_RATE_DEFAULT"
指定。如果预订包含人数,可以通过设置 "deposit_type": "PER_PERSON"
将押金指定为每人押金。
需要提供信用卡
服务可能会要求提供信用卡作为验证身份的额外方式。 但不能用于支付预付款、押金或违约金。如果需要这些用例,应明确配置。要求提供信用卡通常会导致此服务的预订量大幅下降。
如需要求在结账时提供信用卡,您必须将字段 require_credit_card
设置为 REQUIRE_CREDIT_CARD_ALWAYS
。
{
"merchant_id": "merchant-1",
"service_id": "reservation",
"name": "reservation",
"description": "Food reservation",
"require_credit_card": "REQUIRE_CREDIT_CARD_ALWAYS"
}
替换可用性级别的价格
价格和费用结构在服务级别指定。在大多数情况下,应使用此服务级价格。但是,更改某些可用性空档的付款结构是合理的。例如,可以通过在可用性级别替换价格或费用来处理以下情况:
- 周二降价,周六上调。
- 下午 5:00 至晚上 7:00 之间的空房需支付违约金。
- 要求存入的人数超过 6 人。
- 特定客房的预订需要使用信用卡。
付款方式表格针对每种付款 / 费用方式列出了要在可用性 Feed 中使用哪个字段来替换服务等级定义。
付款方式 | Feed 定义 | 可替换? |
---|---|---|
预付款 | Availability.prepayment | 无法超额 |
违约金 | Service.no_show_fee | Availability.no_show_fee |
押金 | Service.deposit | Availability.deposit |