Ön koşullar
Bu kılavuzu tamamlamak için aşağıdaki adımları tamamlamış olmanız gerekir:
- Ödeme Politikalarımızın anlaşılması.
- E2E entegrasyonunuzun Feed'leri dışa aktarma bölümünü tamamlayın.
Bu eklenti için desteklenen ödeme türleri şunlardır:
- Ön Ödeme
- Rezervasyonu Kullanmama Ücreti / İptal Ücreti
- Ödeme
- Kredi Kartı Gerekli
Ödemelerle ilgili tüm kullanım alanları, ödeme yok / varışta ödeme kullanım alanının uzantılarıdır (ödeme yapılandırması gerektirmez). Bu nedenle bu eğitim, bu yapılandırmayı açıklayarak ve diğer yapılandırmaları uzantı olarak ele alarak başlayacaktır.
Ön Ödeme
Bu yapılandırma, hizmet tutarının rezervasyon sırasında tam olarak ödenmesi gerektiğini belirtmek için kullanılır. Ön ödeme, kullanılabilirlik düzeyinde Avaibility feed'inin payment alanı aracılığıyla belirtilir.
{
"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"
}
}
}
}]
}
Rezervasyonu Kullanmama Ücreti
Rezervasyonuna katılmayan veya iptal süresinden sonra iptal eden kullanıcılardan rezervasyona kullanmama ücreti alınabilir. İptal aralığı belirtilmezse varsayılan olarak slotun başlangıç zamanı kullanılır.
Kullanmama ücreti belirtmek için hizmet feed'ine no_show_fee alanını aşağıdaki örnekte gösterildiği gibi eklemeniz gerekir:
{
"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"
}
}
Bu örnekte, iş ortağı veya satıcı randevu sahibi randevuya katılmazsa no_show_fee.fee.price_micros alanında belirtildiği gibi 25 ABD doları sabit ücret alma yetkisine sahiptir. Bu ücret, scheduling_rules.min_advance_online_canceling alanında belirtildiği şekilde kullanıcı randevuyu 4 saat (14.400 saniye) içinde iptal ederse de alınabilir.
Müsaitlik durumu feed'inde hiçbir gösterim ücretinin nasıl tanımlanamadığını görmek için Kullanılabilirlik Düzeyinde Fiyatlandırmayı Geçersiz Kılma bölümünü inceleyin.
İsteğe bağlı olarak kullanılmayan rezervasyonlar, kişi başına rezervasyon için alınacak şekilde yapılandırılabilir. Bu durumda no_show_fee.fee.fee_type, PER_PERSON olarak ayarlanabilir.
Ödeme
Depozitolar, rezervasyonun ilk ödemesini tahsil etmek için kullanılır. Depozitolar, rezervasyon sırasında veya daha sonra tahsil edilebilir. Ödemenin hangi şartlar kapsamında geri ödenebileceğini ve rezervasyonun internet üzerinden ne zaman iptal edilebileceğini tanımlamanız gerekebilir.
Ödeme belirtmek için hizmet feed'ine deposit alanını aşağıdaki örnekte gösterildiği gibi eklemeniz gerekir:
{
"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"
}
}
Bu örnekte min_advance_online_canceling iptal aralığını, deposit.min_advance_cancellation_sec ise depozitonun ne zaman geri ödenebileceğini tanımlar. Bu örnekte depozitonun geri ödeme şartlarından ayrı bir iptal zamanı belirtebileceğini unutmayın. Bu durumda kullanıcı, hizmeti 24 saate kadar (86.400 saniye) online olarak iptal edebilir. Bu sayede satıcı, geciken iptaller konusunda doğrudan bilgilendirilir. Ancak kullanıcı, rezervasyondan 4 saat öncesine (14.400 saniye) kadar (iptal için sizinle veya satıcıyla iletişime geçerek) ödemesi için geri ödeme alabilir. Bu tutar ödeme sırasında ve onay e-postasında gösterilir.
Ödemelerin kullanılabilirlik düzeyinde nasıl tanımlanabileceğini görmek için Kullanılabilirlik Düzeyinde Fiyatlandırmayı Geçersiz Kılma bölümünü inceleyin.
Ayrıca, rezervasyonu kullanmama ücretinde olduğu gibi depozito ya sabit ücret ya da kişi başı ücret alınabilir. Bu durumda ödeme, "deposit_type": "FIXED_RATE_DEFAULT" tarafından belirtildiği gibi 25 ABD doları sabit ücrettir. Rezervasyonda kişi sayısı belirtiliyorsa ödeme, "deposit_type": "PER_PERSON" ayarlanarak kişi başına ödeme olarak belirtilebilir.
Kredi Kartı İsteyin
Hizmetler için ek bir kimlik doğrulama yöntemi olarak kredi kartı gerekebilir. Ancak ön ödeme ve para yatırma işlemleri için kullanılmamalıdır. Bu kullanım alanları gerekliyse açıkça yapılandırılmalıdır. Kredi kartı talep etmek, genellikle bu hizmet için yapılan rezervasyonlarda önemli bir düşüşe neden olur.
Ödeme sırasında kredi kartı sağlanmasını zorunlu kılmak için require_credit_card alanını REQUIRE_CREDIT_CARD_ALWAYS olarak ayarlamalısınız.
{
"merchant_id": "merchant-1",
"service_id": "reservation",
"name": "reservation",
"description": "Food reservation",
"require_credit_card": "REQUIRE_CREDIT_CARD_ALWAYS"
}
Kullanılabilirlik Düzeyinde Fiyatlandırmayı Geçersiz Kıl
Fiyat ve ücret yapısı, Hizmet düzeyinde belirlenir. Çoğu durumda bu hizmet düzeyindeki fiyatlandırma kullanılmalıdır. Ancak belirli kullanılabilirlik slotları için ödeme yapısını değiştirmek mantıklıdır. Örneğin, aşağıdaki durumlar, stok durumu düzeyinde fiyatların veya ücretlerin geçersiz kılınmasıyla ele alınabilir:
- Fiyatlar salı günleri düşürülür, cumartesi günleri artar.
- 17:00-19:00 saatleri arasındaki müsaitlik durumu için gösterim ücreti uygulanmaz.
- 6'dan büyük gruplar için ödeme istenir.
- Belirli odalardaki rezervasyonlar için kredi kartı gerekir.
Ödeme türü tablosunda, her ödeme / ücret yöntemi için hizmet düzeyi tanımını geçersiz kılmak için müsaitlik durumu feed'inde kullanılacak alan listelenir.
| Ödeme Türü | Feed Tanımı | Geçersiz kılınabilir mi? |
|---|---|---|
| Ön Ödeme | Availability.prepayment | Geçersiz kılınamaz |
| Rezervasyonu Kullanmama Ücreti | Service.no_show_fee | Availability.no_show_fee |
| Ödeme | Service.deposit | Availability.deposit |