| Amacı | Booking Engine Plus'ta özel bir ödeme ağ geçidi veya hediye kartı iş akışı kurmak ve desteklenen uygulama ile destek yolunu anlamak. |
| En uygun olanlar | PMS Yöneticileri, Tesis Yöneticileri, Sahipler ve özel ödeme akışı üzerinde çalışan web geliştiricileri veya entegrasyon iş ortakları. |
| Ne zaman kullanılır | Booking Engine Plus üzerinden özel bir ödeme seçeneği kaydetmek, özel alanlarla hediye kartı girişini desteklemek, üçüncü taraf bir ağ geçidini test etmek veya Immersive Experience ile desteklenenleri anlamak istediğinde. |
| Gereksinimler | Booking Engine Plus, Booking Engine için etkinleştirilmiş Banka Havalesi, Booking Engine Özelleştir sekmesine erişim ve özel JavaScript için deneyimli bir web geliştiricisi veya entegrasyon iş ortağı. Hediye kartı iş akışları ayrıca özel bir misafir alanı gerektirir. |
| Beklenen sonuç | Özel ödeme seçeneği Booking Engine EventSystem üzerinden kaydedilir, barındırılan çıkış sırasında görünür ve sağlayıcının özel mantığı, rezervasyon oluşturulduktan sonra misafiri ödemeyi tamamlaması için yönlendirebilir. |
| Sınırlamalar | Yalnızca bir özel ödeme ağ geçidi yapılandırılabilir. Özel ödeme yöntemleri yalnızca barındırılan Booking Engine'de desteklenir, tam Immersive Experience'de değil. Cloudbeds özel ağ geçidi mantığını geliştirmez veya sürdürmez. |
Giriş
Cloudbeds Rezervasyon Motoru Plus, özel JavaScript aracılığıyla özel bir ödeme ağ geçidi veya hediye kartı iş akışını destekleyebilir. Özel ödeme seçeneği, özel akış için Rezervasyon Motoru EventSystem ve Banka Havalesi ödeme seçeneğini temel alır.
Barındırılan Rezervasyon Motoru, özel ödeme yöntemleri için desteklenen çıkış ortamı olmaya devam eder. Bu makale, kurulum gereksinimlerini, Cloudbeds Destek'in nasıl yardımcı olabileceğini, ödeme sağlayıcısı veya geliştiricinin sorumluluğunda kalanları ve bir tesisin daha etkileyici bir web sitesi giriş deneyimi istediğinde premium yerleştirmelerin nasıl kullanılacağını açıklar.
İçindekiler
- Bu kimin için ve nasıl etkiler
- Gereksinimler ve destek sınırları
- Özel ödeme yöntemlerini Etkileyici Deneyim ile kullan
- Üçüncü taraf ödeme ağ geçidi veya hediye kartı iş akışını kur
- Özel ödeme ağ geçidini test et ve sorun gider
Bu kimin için ve nasıl etkiler
Özel ödeme iş akışları hem Cloudbeds yapılandırmasını hem de üçüncü taraf geliştirmeyi içerir. Sürecin hangi kısmının sana uygulandığını belirlemek için bu tabloyu kullan.
| Rol | Bilmen gerekenler |
|---|---|
| PMS Yönetici veya Tesis Yöneticisi | Gerekli Rezervasyon Motoru ödeme ayarını etkinleştir, Sağlayıcı tarafından verilen kodu Özelleştir sekmesine ekle ve desteklenen test kurulumunu tamamla. Betiği uygulamadan önce Gereksinimler ve destek sınırları bölümünü incele. |
| Web geliştiricisi veya ödeme ağ geçidi sağlayıcısı | Özel JavaScript, ağ geçidi yönlendirmesi ve sağlayıcı tarafı mantığını oluştur, sürdür ve sorun gider. Daha derin entegrasyon soruları için ödeme sağlayıcısı Cloudbeds Entegrasyon ekibiyle çalışmalı. Özel ödeme ağ geçidini test et ve sorun gider bölümünü incele. |
| Sahip veya Genel Müdür | Özel ödeme çıkışı için barındırılan Rezervasyon Motorunu kullan. Daha markalı bir web sitesi giriş deneyimi istiyorsan, desteklenen premium yerleştirme yaklaşımını Özel ödeme yöntemlerini Etkileyici Deneyim ile kullan bölümünde incele. |
Gereksinimler ve destek sınırları
Özel bir ödeme ağ geçidi veya hediye kartı iş akışı uygulamadan önce, gerekli Rezervasyon Motoru ayarlarını ve uygulamanın her bölümünün sahibini doğrula.
- Cloudbeds PMS’de Rezervasyon Motoru için Banka Havalesini bir ödeme seçeneği olarak etkinleştir.
- Özel ödeme seçeneğini kaydetmek için Rezervasyon Motoru EventSystem ile özel JavaScript kullan.
- Sadece bir özel ödeme ağ geçidi entegre edilebilir. Tesis aynı anda hem Banka Havalesi hem de özel ödeme ağ geçidini ayrı seçenekler olarak sunamaz.
- Hediye kartı desteği için misafirin hediye kartı numarasını girmesi amacıyla özel bir misafir alanı gerekir.
- Özel ödeme yöntemleri yalnızca barındırılan Rezervasyon Motoru ortamlarında desteklenir. Tam Cloudbeds Rezervasyon Motoru Kapsayıcı Deneyim 2.0’da desteklenmezler.
- Bu makaledeki uygulama adımları yalnızca Rezervasyon Motoru Plus için geçerlidir.
Cloudbeds özel ödeme ağ geçitleri geliştirme veya bakım yapmaz. Özel ağ geçidi mantığını oluşturmak, değiştirmek veya sorun gidermek Cloudbeds Destek ve Cloudbeds Payments kapsamı dışındadır. Özel kod ve sağlayıcı tarafı davranışı senin web geliştiricin, ödeme ağ geçidi sağlayıcın, bayi veya entegrasyon iş ortağın tarafından yönetilmelidir.
Cloudbeds Destek nasıl yardımcı olabilir
Cloudbeds Destek, sağlayıcının uygulamasını test etmesi için gereken Cloudbeds tarafı kurulumu konusunda yardımcı olabilir. Destek şunları yapabilir:
- Ödeme sağlayıcısının tarayıcı konsolunu inceleyebilmesi için promosyon kodlu bir fiyat planı oluşturman konusunda rehberlik et. Özel fiyat olarak 0,50 USD kullan ve test fiyat planını yalnızca Rezervasyon Motoru kaynağı için müsait yap.
- Ödeme ağ geçidi sağlayıcının verdiği özel betikleri Rezervasyon Motoru Özelleştir paneline eklemene yardımcı olur.
Gelişmiş sorun giderme veya entegrasyon soruları için ödeme ağ geçidi sağlayıcısı doğrudan Cloudbeds Entegrasyon ekibiyle çalışmalıdır. Sağlayıcı henüz Cloudbeds iş ortağı değilse, Cloudbeds ile İş Ortağı Ol sayfasından başvurmalarını iste.
Kapsayıcı Deneyim ile özel ödeme yöntemlerini kullan
Özel ödeme yöntemleri, tam Cloudbeds Rezervasyon Motoru Kapsayıcı Deneyim 2.0 içinde desteklenmemektedir. Rezervasyon yolculuğunun başlangıcını tesisinizin web sitesinde tutmak istiyorsanız, giriş noktası olarak premium yerleştirmeleri kullanabilir ve rezervasyonu barındırılan Rezervasyon Motorunda tamamlayabilirsiniz.
Web sitenizde çoklu tesis, tarih seçici ve konaklama seçici bileşenleri gibi premium yerleştirmeleri kullanabilirsiniz. Misafirler, sitenizde desteklenen bileşen deneyimiyle etkileşime geçebilir, ardından rezervasyonu tamamlamak ve özel ödeme yönlendirmesini kullanmak için Cloudbeds tarafından barındırılan Rezervasyon Motoruna devam edebilirler.
Mevcut kısıtlama: Misafirler, rezervasyon ve ödeme için barındırılan sayfaya yönlendirilmeden önce tesis web sitesinde tam Rezervasyon Motoru arama sonuçlarını yerel olarak görüntüleyemezler.
Üçüncü taraf ödeme ağ geçidi veya hediye kartı iş akışını kur
Özel ödeme seçeneği, Rezervasyon Motoru EventSystem üzerinden kaydedilmelidir. Aşağıdaki kurulum, Cloudbeds tarafındaki etkinlik kaydını ve sağlayıcının yönlendirme mantığında kullanılan rezervasyon oluşturuldu etkinliğini kapsar.
Adım 1: Özelleştir sekmesine özel JavaScript ekle
-
Hesap Menüsü
öğesini aç ve Ayarlar > Rezervasyon Motoru bölümüne git.
- Özelleştir seçeneğine tıkla.
- Kaydet butonuna tıkla.
Özel JavaScript, Rezervasyon Motoru tetiklenmeye ve etkinlikleri dinlemeye hazır olduğunda gönderilen on-booking-engine-ready etkinliğine abone olmalıdır. Ayrıca, Rezervasyon Motorunun özel ödeme seçeneğini kaydedebilmesi için custom-payment-option-change etkinliğini de göndermelidir.
<script>
window.addEventListener('on-booking-engine-ready', (e) => {
const { eventSystem } = e.detail;
eventSystem.dispatchEvent("custom-payment-option-change", {
id: "%PAYMENT_OPTION_ID%",
instructions: "Talimatlar için varsayılan metniniz buraya gelir.",
name: "Etiket için varsayılan metniniz buraya gelir.",
});
});
</script>JavaScript alanındaki değişiklikleri kaydettiğinde, Cloudbeds senden çok faktörlü kimlik doğrulama (MFA) adımını tamamlamanı isteyebilir. Doğrulama süreci için Rezervasyon Motoru Özel HTML ve JavaScript Alanları için MFA Adımı makalesini incele.
Adım 2: Özel ödeme seçeneğini EventSystem ile kaydet
eventSystem.dispatchEvent() kullanarak gerekli ödeme seçeneği detaylarıyla custom-payment-option-change etkinliğini gönderin:
-
id [string]: Zorunlu. Değerin uzunluğu 0'dan büyük olmalı ve CSS id olarak kullanılmaya uygun olmalıdır. Boşluk, noktalı virgül veya CSS seçicilerinde geçersiz özel karakterler kullanmayın. Önerilen format kebab-case'dir.%PAYMENT_OPTION_ID%yerine özel ödeme ağ geçidi için id'yi koyun. -
instructions [string]: İsteğe bağlı. Misafir özel ödeme seçeneğini genişlettiğinde talimatlar veya açıklama gösterir. Bu değeri, dil bazlı metin CSS ile özelleştirilmediğinde varsayılan metin olarak kullan. -
name [string]: Zorunlu. Değerin uzunluğu 0'dan büyük olmalıdır.
Eğer etkinlik veri yükü gerekli koşulları karşılamazsa, özel ödeme seçeneği kaydedilmez ve Banka Havalesi seçeneği görüntülenmeye devam eder.
Değişiklikleri kaydettikten sonra, barındırılan Rezervasyon Motorunu aç ve çıkış işlemini test et. Ödeme adımı, rezervasyon sayfasında satır içi görünmek yerine ayrı bir açılır pencere veya modal pencerede açılabilir. Özel ödeme seçeneği yine de Rezervasyon Motoru EventSystem üzerinden kaydedilmelidir.
Aşağıdaki görsel, misafir çıkış işlemini tamamladıktan sonra mevcut ödeme yöntemleriyle birlikte barındırılan ödeme penceresini gösterir.
Adım 3: reservation-created etkinliğini ve sağlayıcı yönlendirmesini yönet
Misafir özel ödeme seçeneğini kullanarak rezervasyon yaptığında, rezervasyon Cloudbeds PMS'de e-bankacılık ödeme yöntemiyle oluşturulur ve Cloudbeds tarafından ödeme alınmaz. Sağlayıcının özel betiği reservation-created etkinliğini dinleyebilir, rezervasyon verilerini kullanabilir ve misafiri üçüncü taraf ödeme ağ geçidine yönlendirerek ödemeyi tamamlamasını sağlayabilir.
eventSystem.addEventListener('reservation-created', (data) = {
// Rezervasyon oluşturulduktan sonra çalışacak kodunuz...
})Kayıt ve reservation-created etkinlikleri için Rezervasyon Motoru EventSystem'ı kullanın. Özel ödeme seçeneğinin seçilip seçilmediğini belirlemek için yalnızca sayfa özelindeki tıklama dinleyicilerine, akordeon düğmesi tıklamalarına veya kullanıcı arayüzü seçicilerine güvenmeyin.
İsteğe bağlı etiket, talimat, simge veya rezervasyon verisi detaylarına ihtiyacınız varsa aşağıdaki gelişmiş referans bölümlerini genişletin.
İsteğe bağlı etiket, talimat ve simge özelleştirmeleri
Özel ödeme seçeneği etiketi için dil bazlı metin belirtebilirsin:
html[lang="%LANG%"] [data-id="%PAYMENT_OPTION_ID%-name"]::before {
content: "Etiket için diline özel metnin buraya gelir.";
}
Ayrıca dil bazlı talimatları da yapılandırabilirsin:
html[lang="%LANG%"] [data-id="%PAYMENT_OPTION_ID%-instructions"]::before {
content: "Talimatlar için diline özel metnin buraya gelir.";
}
Varsayılan simgeyi gizleyebilir ve özel bir logo veya simge ekleyebilirsin:
// Varsayılan SVG simgesini gizlemek için
[data-id="%PAYMENT_OPTION_ID%-icon"] svg {
display: none;
}
// Simgeyi arka plan resmi olarak ayarlayarak özelleştirmek için
[data-id="%PAYMENT_OPTION_ID%-icon"] {
background-image: url(PAYMENT_OPTION_ICON_URL);
background-size: cover;
background-position: center;
width: 40px;
height: 40px;
}
reservation-created veri referansı
reservation-created olayı tarafından açığa çıkarılan veri aşağıdaki yapıya sahiptir:
interface CreatedReservation {
booking_id?: `${number}`;
booking_total?: number;
checkin_date?: string;
checkout_date?: string;
city?: string;
currency_code?: string;
hotel_name?: string;
real_booking_total?: number;
resRooms?: {
adults: `${number}`;
id: `${number}`;
kids: `${number}`;
package: `${number}`;
package_name: string | null;
rate_id: `${number}`;
room_total: `${number}`;
room_type_id: `${number}`;
room_type_name: string;
room_type_photos: ({
TYPE?: string;
alt: string;
cropParam: string | null;
croppedImage: string;
fullPath: string;
galleryPath?: string | null;
id: string;
imageHeight: string;
imageWidth: string;
mime?: string;
originalName: string;
ownerId?: string;
ownerType?: string;
parentId: string;
path: string;
section?: string;
size?: string;
thumbPath: string;
uploadedAt?: string;
utype?: string;
} & {
featured: number;
featuredPath: string | null;
})[];
}[];
rooms?: Record<string, {="{" adults:="adults:" number;="number;" amount:="amount:" bookedid:="bookedId:" string[];="string[];" kids:="kids:" name:="name:" string;="string;" packageid?:="packageId?:" packagename?:="packageName?:" picture?:="picture?:" price?:="price?:" rateid:="rateId:" roomid:="roomId:" unit?:="unit?:" }="}">;
state?: string;
total_tax?: number;
widget_property?: number;
};</string,>
Özel ödeme ağ geçidini test et ve sorun gider
Ödeme sağlayıcının tarayıcı konsolu davranışını incelemesi veya yönlendirme mantığını doğrulaması gerektiğinde kontrollü bir Rezervasyon Motoru test akışı kullan. Cloudbeds destek, Cloudbeds tarafındaki test kurulumunda yardımcı olabilir, ancak özel ağ geçidi kodu ve sağlayıcı tarafı sorun giderme sorumluluğu ödeme sağlayıcıya aittir.
Sağlayıcı sorun giderme için test fiyat planı oluştur
Cloudbeds destek ekibi, test amaçlı geçici bir fiyat planı ve promosyon kodu oluşturman konusunda rehberlik edebilir. Ödeme sağlayıcının çıkış akışını yeniden oluşturup tarayıcı konsolunu inceleyebilmesi için özel fiyat olarak 0,50 USD belirle ve fiyat planını sadece Rezervasyon Motoru kaynağı için müsait yap.
Gördüğün davranışa uyan sorunu genişlet.
Özel ödeme seçeneği görünmüyor
Aşağıdakileri kontrol et:
- Cloudbeds PMS’de Rezervasyon Motoru için Banka Havalesinin etkin olduğundan emin ol.
- Özel JavaScript’in Rezervasyon Motoru Özelleştir sekmesine eklendiğini doğrula.
-
custom-payment-option-changeetkinlik veri yükünün geçerli biridvenameiçerdiğini onayla. -
idiçinde boşluk, noktalı virgül veya geçersiz CSS seçici karakterleri olmadığını doğrula. - Yalnızca bir özel ödeme ağ geçidinin yapılandırıldığından emin ol.
Etkinlik veri yükü tüm gereksinimleri karşılamazsa, özel ödeme seçeneği kaydedilmez ve Banka Havalesi görünmeye devam eder.
Özel ödeme yönlendirmesi çalışmıyor
Aşağıdakileri kontrol et:
- Özel betiğin
reservation-createdetkinliğini dinlediğini doğrula. - Betiğin yalnızca sayfa özel tıklama dinleyicilerine, akordeon düğmesi tıklamalarına veya kullanıcı arayüzü seçicilerine bağlı olmadığını onayla.
- Üçüncü taraf ödeme ağ geçidi URL’si ve yönlendirme parametrelerinin geçerli olduğunu doğrula.
Cloudbeds tarafındaki kurulum onaylandıktan sonra yönlendirme hâlâ başarısız oluyorsa, ödeme ağ geçidi sağlayıcısı veya geliştiricisi özel mantığı çözümlemelidir. Daha derin entegrasyon soruları için sağlayıcı, doğrudan Cloudbeds Entegrasyon ekibiyle çalışmalıdır. Sağlayıcı henüz bir Cloudbeds iş ortağı değilse, Cloudbeds ile İş Ortağı Ol sayfasından başvurmalarını iste.
İlgili makaleler
Desteklenen özel ödeme kurulumu ve sahiplik sınırlarını anladığınıza göre, daha geniş Rezervasyon Motoru Plus özellikleri ve desteklenen Immersive Experience yapılandırması için bu kaynakları inceleyin:
Yorumlar
Yorum yazmak için lütfen oturum açın: oturum aç.