기본 요건
이 가이드를 완료하려면 다음을 완료해야 합니다.
이 부가기능에 지원되는 결제 유형은 다음과 같습니다.
- 선불
- 예약 불이행 수수료 / 취소 수수료
- 입금
- 신용카드 필요
결제의 모든 사용 사례는 결제 없음/도착 시 지불 사용 사례 (결제 구성이 필요하지 않음)의 확장이므로 이 튜토리얼에서는 먼저 해당 구성을 설명하고 다른 구성을 확장 프로그램으로 취급합니다.
선불
이 구성은 예약 시 서비스 금액을 전액 지불해야 함을 지정하는 데 사용됩니다. 선불 결제는 Avaibility 피드의 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"
}
}
}
}]
}
예약 불이행 수수료
예약 불이행 수수료는 사용자가 예약에 참석하지 않거나 취소 기간 후에 취소하는 경우 사용자에게 청구될 수 있습니다. 취소 기간을 지정하지 않으면 시간대의 시작 시간으로 기본 설정됩니다.
예약 불이행 수수료를 지정하려면 서비스 피드에 다음 예와 같이
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달러의 고정 요금을 청구할 권한이 있습니다. scheduling_rules.min_advance_online_canceling 필드에 지정된 대로 사용자가 예약 시간 4시간 (14,400초) 전에 취소하는 경우에도 이 수수료가 청구될 수 있습니다.
이용 가능 여부 피드에 예약 불이행 수수료를 정의하는 방법을 알아보려면 이용 가능 여부 수준에서 가격 재정의를 참고하세요.
예약 불이행 수수료는 예약 요금이 1인당 청구되도록 선택적으로 구성할 수 있습니다. 이 경우 no_show_fee.fee.fee_type를 PER_PERSON로 설정할 수 있습니다.
입금
보증금은 예약 요구사항으로 초기 청구액을 청구하는 데 사용됩니다. 보증금은 예약 시 또는 그 이후에 청구할 수 있습니다. 보증금을 환불할 수 있는 약관과 온라인에서 예약을 취소할 수 있는 시점을 정의해야 할 수도 있습니다.
입금을 지정하려면 다음 예와 같이 서비스 피드에 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시간 (86, 400초) 전에 온라인에서 서비스를 취소할 수 있습니다. 이렇게 하면 취소 지연을 판매자에게 직접 알릴 수 있습니다. 하지만 사용자는 예약 4시간 전 (14,400초) 전까지 (판매자 또는 판매자에게 연락하여
취소를 위해 문의) 보증금을 환불받을 수 있습니다.
이 내용은 결제 시 약관 및 확인 이메일에
표시됩니다.
가용성 수준에서 보증금을 정의하는 방법을 알아보려면 가용성 수준에서 가격 재정의를 참조하세요.
예약 불이행 수수료와 마찬가지로 보증금은 고정 요금 또는 1인당 요금으로
청구될 수 있습니다. 이 경우 입금은 "deposit_type": "FIXED_RATE_DEFAULT"에 지정된 대로 $25의 고정 금리입니다. 예약에 인원수가
포함되어 있는 경우 "deposit_type": "PER_PERSON"를 설정하여 이 보증금을
1인당 보증금으로 지정할 수 있습니다.
신용카드 필요
서비스에서 신원을 확인하기 위한 추가적인 방법으로 신용카드가 필요할 수 있습니다. 하지만 선불, 보증금 또는 예약 불이행 수수료로는 사용할 수 없습니다. 이러한 사용 사례가 필요한 경우 명시적으로 구성해야 합니다. 신용카드를 사용하게 되면 이 서비스의 예약이 크게 감소할 수 있습니다.
결제 시 신용카드를 제공하도록 요구하려면
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시부터 오후 7시까지 이용 가능 여부에는 예약 불이행 수수료가 적용됩니다.
- 인원수가 6명 이상인 경우 보증금이 필요합니다.
- 특정 객실을 예약하려면 신용카드가 필요합니다.
결제 유형 표에는 각 결제 / 수수료 수단에 대해 서비스 수준 정의를 재정의하기 위해 이용 가능 여부 피드에서 사용할 필드가 나열됩니다.
| 결제 유형 | 피드 정의 | 재정의할 수 있나요? |
|---|---|---|
| 선불 | Availability.prepayment | 초과 불가능 |
| 예약 불이행 수수료 | Service.no_show_fee | Availability.no_show_fee |
| 입금 | Service.deposit | Availability.deposit |