İçeriğe geç

Kanal Yöneticinizi Ekleyin

Bu rehber, kanal yöneticisi ve PMS geliştiricilerini Wink ile entegrasyon sürecinin tamamında yönlendirir — hesap oluşturma, envanter eşleme ve ilk uçtan uca testi çalıştırmaya kadar.

Kanal Yöneticisi (Entegrasyonlar) API’si iki ortamda mevcuttur. Tüm geliştirme ve sertifikasyon için staging ortamını kullanın; canlı yayına geçerken yalnızca üretim ortamına geçin.

OrtamTemel URL
Üretimhttps://integrations.wink.travel
Staginghttps://staging-integrations.wink.travel

Kanal Yöneticisi API’si, mevcut konaklama sistemleriyle uyumluluk için OTA protokol standartlarını (SOAP/XML) takip eder. Ortak uç nokta dokümantasyonunu inceleyerek başlayın:

Kanal Yöneticisi API — Ortak uç noktalar

  1. Bir Wink kullanıcı hesabı oluşturun

    staging-app.wink.travel adresinden kayıt olun. Aşağıdaki tüm adımlar staging ortamında yapılır — canlı yayına geçmeden önce üretimde tüm süreci tekrar edeceksiniz.

  2. Affiliate / Kanal Yöneticisi hesabınızı oluşturun

    Yeni kullanıcı altında bir hesap oluşturun ve Affiliate / Kanal Yöneticisi hesap türünü seçin. Entegrasyonunuz bu hesapla kimlik doğrulaması yapacaktır.

  3. Bir uygulama kaydedin ve ilk tokenınızı oluşturun

    Bir Uygulama oluşturun ve bunu adım 2’deki kanal yöneticisi hesabına bağlayın. İstemci türü olarak MACHINE_2_MACHINE seçin — bu, son kullanıcı yönlendirmesi olmayan sunucu-sunucu entegrasyonudur. Client ID ve Secret Key’i hemen kopyalayın; gizli anahtar yalnızca bir kez gösterilir ve tekrar alınamaz.

    Uygulama, bu rehberdeki her çağrının Authorization: Bearer <access_token> olarak taşıdığı bearer tokenı oluşturur. client_credentials grant türü ile https://staging-iam.wink.travel/oauth2/token adresinden integrations.read integrations.write kapsamlarını isteyerek token alın. Devam etmeden önce bunu yapın — token olmadan hesap kimlik bilgilerini sorgulayamaz veya Kanal Yöneticisi uç noktalarına erişemezsiniz. Tam akış, üretim hostu ve kapsam kataloğu için Kimlik Doğrulama sayfasına bakın.

  4. Bir Otel hesabı oluşturun

    Aynı kullanıcı altında ikinci bir hesap oluşturun ve Otel hesap türünü seçin. Bu, gerçek bir otel kullanmadan test yapabileceğiniz bir mülk sağlar.

  5. Her iki hesabın da onaylandığını doğrulayın

    Hiçbir hesap onaylanmadan kullanılamaz: onaylanmamış bir kanal yöneticisi hesabı hiçbir otelin kanal yöneticisi listesinde görünmez ve onaylanmamış bir otel API tarafından döndürülmez.

    • Staging — onay otomatik yapılır. Hesapları oluşturur oluşturmaz kullanabilirsiniz, ayrıca talep etmeniz gereken bir şey yoktur.
    • Üretim — onay manuel yapılır. Wink entegrasyon kontakınıza her iki hesabın isimlerini ve bağlı oldukları kullanıcıyı gönderin, onay gelene kadar bekleyin.
  6. İki hesabı bağlayın

    Otel hesabına giriş yapın ve Kanallar → Kanal yöneticisi bölümüne gidin. Kanal yöneticisi hesabınızı listeden seçin — bu, mülkü entegrasyonunuza bağlar. Hesabınız listede yoksa henüz onaylanmamıştır; 5. adıma bakın.

  7. Temel bir oda tipi ve fiyat planı oluşturun

    Otel hesabı içinde en az bir oda tipi ve bir fiyat planı oluşturun. Bunlar, entegrasyonunuzun fiyat ve müsaitlik gönderebilmesi veya rezervasyon çekebilmesi için gereklidir.

  8. Eşleyin ve test edin

    Kendi sisteminizde API tarafından döndürülen oda tipi ve fiyat planı kimliklerini eşleyin. Bir fiyat güncellemesi ve bir müsaitlik güncellemesi gönderin, ardından test rezervasyonu yapın ve rezervasyon çekme uç noktasının doğru şekilde döndürdüğünü doğrulayın.

Her Kanal Yöneticisi API yolu kendi hesabınıza özgüdür:

/api/managing-entity/{managingEntityIdentifier}/channel-manager/...

{managingEntityIdentifier}, kanal yöneticisi hesabınızın hesap kimliğidir (UUID) — otelin değil. Kullanıcınızın sahip olduğu diğer tüm hesapların kimliği ve mevcut durumu ile birlikte Platform API’den alın:

Terminal window
curl -s -X GET \
"https://staging-api.wink.travel/api/managing-entity/list" \
-H "Authorization: Bearer <access_token>" \
-H "Wink-Version: 2.0" \
-H "Accept: application/json"

Yanıt, sahip olduğunuz hesapların bir dizisidir:

[
{
"id": "3f1c8e42-7b90-4d55-a1e2-6c8d09b4f731",
"type": "CHANNEL_MANAGER",
"name": "Kanal Yöneticiniz",
"status": "ACTIVE"
},
{
"id": "d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69",
"type": "HOTEL",
"name": "Test Mülkünüz",
"urlName": "your-test-property",
"status": "ACTIVE"
}
]
  • Kanal yöneticisi girdisinin id değeri sizin {managingEntityIdentifier}’dır.
  • HOTEL girdisinin id değeri sizin {propertyIdentifier}’dır.
  • status, her hesabın onay durumunu doğrulamak için kullanılır — özellikle üretimde, onay manuel olduğunda faydalıdır. Otel ACTIVE olmalıdır ki rezervasyon yapılabilsin veya Kanal Yöneticisi API tarafından görünür olsun. Kanal yöneticisi hesabınız, Sertifikasyon geçene kadar PENDING_APPROVAL olarak kalır; bu beklenen bir durumdur ve geliştirmeyi engellemez.

Sertifikasyon, entegrasyonunuzun envanteri doğru eşlediğini, fiyat ve müsaitlik gönderdiğini ve rezervasyonları uçtan uca aldığını kanıtlamanızı ve Wink’in bunu doğrulamasını sağlar. Kendi sisteminizden her adımı sürdürdüğünüz, sonunda tek bir kanıt paketi sunduğunuz kendi kendine hizmet eden bir süreçtir. Wink paketi inceleyip onaylarsa, Affiliate / Kanal Yöneticisi hesabınızı PENDING_APPROVAL’dan ACTIVE’ye geçirir.

Sertifikasyon tamamen staging ortamında (https://staging-integrations.wink.travel) yapılır. Bu bölümde üretime dokunulmaz.

  1. Kimlik doğrulama. OAuth2 istemciniz erişim tokenı alabilir ve Affiliate / Kanal Yöneticisi hesabınıza karşı /ping uç noktasını başarıyla çağırabilir.

  2. Envanter eşleme. Hesabınıza bağlı otelleri listeleyebilir, yapılandırdığınız ana fiyatı (oda tipi × fiyat planı) alabilir ve sisteminizin hedefleyeceği masterRateIdentifier’ı doğru şekilde belirleyebilirsiniz.

  3. Fiyat ve müsaitlik gönderimi. Sertifikasyon haftasının yedi gününü bağımsız olarak güncelleyebilirsiniz — her gün farklı miktar, adet, varışta kapanış / çıkışta kapanış bayrakları ve minimum/maksimum kalış süresi kombinasyonları — ve Wink’ten tam olarak aynı değerleri okuyabilirsiniz.

  4. Rezervasyon çekme. Test mülkünüze yapılan gerçek bir staging rezervasyonunu çekebilir, kendi PMS/CM arayüzünüzde doğru oda konaklaması, misafir ve toplam ile görüntüleyebilir, ardından Wink rezervasyonu iptal ettiğinde iptali yansıtabilirsiniz.

Sertifikasyona başlamadan önce Entegrasyon adımları 1–7’yi tamamlayın; böylece:

  • Staging ortamında bir Wink kullanıcınız ve ona bağlı bir Affiliate / Kanal Yöneticisi ile bir Otel hesabınız (Kanallar → Kanal yöneticisi) olur. Staging hesapları otomatik onaylanır, bu yüzden talep etmeniz gerekmez.
  • Otel hesabı içinde en az bir oda tipi ve bir fiyat planı oluşturulmuş olur. Oteli https://staging-book.wink.travel/hotel/<your-slug> adresinde rezervasyona açın.
  • Affiliate / Kanal Yöneticisi hesabınız altında kayıtlı bir uygulamanız olur; Client ID, Secret Key ve integrations.read integrations.write kapsamları vardır (bkz. Kimlik Doğrulama).
  • Affiliate / Kanal Yöneticisi hesabınızın managingEntityIdentifier ve Otel hesabınızın propertyIdentifier (her ikisi de UUID) elinizde olur (Hesap kimlik bilgilerinizi bulma).

Bu bölümdeki her istek aşağıdaki başlıkları kullanır:

Authorization: Bearer <access_token>
Wink-Version: 2.0
Accept: application/json
  • <access_token>, https://staging-iam.wink.travel/oauth2/token adresinden client_credentials grant ile alınır — bkz. Kimlik Doğrulama.
  • Wink-Version başlığı zorunludur; atlanırsa v2 JSON API’ye yönlendirme olmaz.
  • PUT isteklerinde gövde varsa Content-Type: application/json eklenir.

Aşağıdaki örneklerde yer tutucular, Önkoşullar bölümünde topladığınız değerlere karşılık gelir:

Yer TutucuAnlamı
{managingEntityIdentifier}Affiliate / Kanal Yöneticisi hesap ID’niz (UUID) — bkz. Hesap kimlik bilgilerinizi bulma.
{propertyIdentifier}Kanal yöneticisi hesabınıza bağladığınız Otel hesabı (mülk) ID’si.
{masterRateIdentifier}Sertifikasyon yapacağınız ana fiyat (oda tipi × fiyat planı).
{bookingIdentifier}Rezervasyon listesi çağrısından dönen staging rezervasyon ID’si.

Kimlik bilgilerinizin beklediğiniz Affiliate / Kanal Yöneticisi hesabına ait olduğunu doğrulayın.

Terminal window
curl -s -X GET \
"https://staging-integrations.wink.travel/api/managing-entity/{managingEntityIdentifier}/channel-manager/ping" \
-H "Authorization: Bearer <access_token>" \
-H "Wink-Version: 2.0" \
-H "Accept: application/json"

Beklenen yanıt:

{
"apiVersion": "2.0",
"name": "Kanal Yöneticisi Hesap Adınız",
"status": "PENDING_APPROVAL"
}

Eşleşen name ile 200 yanıtı, kimlik doğrulama ve hesap çözümlemenin doğru olduğunu gösterir. status, Wink sertifikasyon yapana kadar PENDING_APPROVAL olarak kalır.

Hesabınıza bağlı otellerin sayfalı listesini alın ve test mülkünüzün listede olduğunu doğrulayın.

Terminal window
curl -s -X GET \
"https://staging-integrations.wink.travel/api/managing-entity/{managingEntityIdentifier}/channel-manager/property/list?page=0&size=25" \
-H "Authorization: Bearer <access_token>" \
-H "Wink-Version: 2.0" \
-H "Accept: application/json"

Yanıt, ChannelManagerProperty girdilerinden oluşan bir Spring Page’idir. {propertyIdentifier} ile eşleşen girdiyi bulun ve currencyCode değerini not edin — bu, Adım D fiyat güncellemelerinin yorumlanması için gereklidir.

Mülkü ve yayınladığı tüm ana fiyatları (oda tipi × fiyat planı kombinasyonları) alın. Sertifikasyon yapacağınız fiyatı seçin ve identifier değerini {masterRateIdentifier} olarak kaydedin.

Terminal window
curl -s -X GET \
"https://staging-integrations.wink.travel/api/managing-entity/{managingEntityIdentifier}/channel-manager/property/{propertyIdentifier}" \
-H "Authorization: Bearer <access_token>" \
-H "Wink-Version: 2.0" \
-H "Accept: application/json"

Yanıt, PropertyWithRoomRateList yapısında; bir property bloğu ve PropertyRoomRate girdilerinden oluşan rooms dizisi içerir. Her girdi oda tipi, fiyat planı, doluluk sınırları, temel fiyat ve günlük fiyat gönderirken koruyacağınız fiyat değiştiricileri sunar.

Sertifikasyona başladığınız ayı takip eden ayın ilk yedi takvim gününü kapsayan yedi günlük fiyat takvimi yükleyin. Örneğin, sertifikasyona 21 Ağustos’ta başlıyorsanız, 1 Eylül’den 7 Eylül’e kadar olan günleri hedefleyin.

Her gün için startDate == endDate olacak şekilde yedi ayrı PUT çağrısı yapacaksınız. Her gün, miktar, adet, varışta kapanış / çıkışta kapanış bayrakları ve kalış süresi sınırlarının farklı bir kombinasyonunu taşır; böylece yazılabilir tüm alanlar en az bir kez test edilmiş olur. Değerler mülkün para birimindedir (Adım B’de kaydedilen); currencyCode atlanırsa doğru şekilde varsayılır.

GünMiktarAdetclosedOnArrivalclosedOnDepartureminLengthOfStaymaxLengthOfStayKanıtladığı şey
1100.005falsefalse130Temel gün.
2125.004falsefalse114Miktar + adet + maxLengthOfStay değişikliği.
3150.003truefalse130closedOnArrival değişimi.
4175.002falsetrue27closedOnDeparture değişimi + daha sıkı kalış süresi aralığı.
5200.000falsefalse130Tükendi adeti.
6225.005falsefalse35Kısıtlayıcı kalış süresi aralığı.
7250.001falsefalse130Son oda müsaitliği.
  1. Gün için istek gövdesi aşağıdaki gibidir. 2’den 7’ye kadar her gün için startDate / endDate / değerleri tablodaki gibi değiştirerek tekrarlayın.
Terminal window
curl -s -X PUT \
"https://staging-integrations.wink.travel/api/managing-entity/{managingEntityIdentifier}/channel-manager/property/{propertyIdentifier}/master-rate/{masterRateIdentifier}" \
-H "Authorization: Bearer <access_token>" \
-H "Wink-Version: 2.0" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
"startDate": "2026-09-01",
"endDate": "2026-09-01",
"amount": 100.00,
"master": true,
"closedOnArrival": false,
"closedOnDeparture": false,
"quantity": 5,
"minLengthOfStay": 1,
"maxLengthOfStay": 30
}'

Her PUT isteği, gönderdiğiniz aralık için güncellenmiş PropertyRate girdilerinin dizisini içeren 200 yanıtı döner (tek gün için tek girdi). Bu yanıtı kaydedin — kanıtınızın parçası olacaktır.

Tüm haftayı tek çağrıda alın ve her günün saklanan değerlerinin Adım D’de gönderdiğiniz satırla eşleştiğini doğrulayın — boolean bayraklar ve kalış süresi aralığı dahil.

Terminal window
curl -s -X GET \
"https://staging-integrations.wink.travel/api/managing-entity/{managingEntityIdentifier}/channel-manager/property/{propertyIdentifier}/master-rate/{masterRateIdentifier}?startDate=2026-09-01&endDate=2026-09-07" \
-H "Authorization: Bearer <access_token>" \
-H "Wink-Version: 2.0" \
-H "Accept: application/json"

Yanıt PropertyRoomRateWithRateList tipindedir. rates dizisi yedi girdi içermelidir, her biri gönderdiğiniz amount, quantity, closedOnArrival, closedOnDeparture, minLengthOfStay ve maxLengthOfStay değerlerine uygun olmalıdır. Herhangi bir alanda uyumsuzluk varsa, Adım D’deki ilgili PUT beklenen sonucu vermemiştir — düzeltip tekrar doğrulayın.

Aşağıdaki URL’yi tarayıcıda açın, <your-slug> yerine Önkoşullar’da yayınladığınız Otel hesabının slug’ını koyun:

https://staging-book.wink.travel/hotel/<your-slug>

Sertifikasyon haftası içinde kalan bir varış ve çıkış tarihi seçin, sertifikasyon yaptığınız oda tipi + fiyat planı kombinasyonunu seçin ve rezervasyonu tamamlayın. Staging test ödeme yolunu kullanır — gerçek karttan ücret alınmaz.

Onay sayfası görüntülendiğinde, misafire gösterilen rezervasyon kodunu (format WNKxxxxx) kaydedin.

Rezervasyon zaman damgasını kapsayan bir zaman aralığında test mülkünüze yapılan tüm rezervasyonları alın.

Terminal window
curl -s -X GET \
"https://staging-integrations.wink.travel/api/managing-entity/{managingEntityIdentifier}/channel-manager/property/{propertyIdentifier}/booking/list?startDate=2026-09-01T00:00:00&endDate=2026-09-08T00:00:00" \
-H "Authorization: Bearer <access_token>" \
-H "Wink-Version: 2.0" \
-H "Accept: application/json"

Adım F’de kaydettiğiniz bookingCode ile eşleşen girdiyi bulun. bookingIdentifier değerini kaydedin. Ardından o tek rezervasyonu çekin:

Terminal window
curl -s -X GET \
"https://staging-integrations.wink.travel/api/managing-entity/{managingEntityIdentifier}/channel-manager/property/{propertyIdentifier}/booking/{bookingIdentifier}" \
-H "Authorization: Bearer <access_token>" \
-H "Wink-Version: 2.0" \
-H "Accept: application/json"

Yanıt PropertyBooking tipindedir. Kendi PMS / kanal yöneticisi arayüzünüze aktarın ve aşağıdakilerin operatöre doğru şekilde göründüğünü doğrulayın:

  • bookingCode, bookingIdentifier, createdDate
  • Misafir: firstName, lastName, email
  • totalAmount + currencyCode (otel tarafından tüm odalar için alınan net tutar)
  • paymentMethodType, paymentMethodStatus, salesChannelName
  • roomStays içindeki her giriş: guestRoomName, ratePlanName, adults, children, startDate, endDate ve oda başına amount

Rezervasyonun kendi arayüzünüzde göründüğü ekran görüntüsünü alın — bu, gerekli kanıt belgelerinden biridir.

Wink ekibinden sertifikasyon rezervasyonunu sizin adınıza iptal etmesini isteyin (veya yetkiniz varsa Otel hesabının Extranet’inden kendiniz iptal edin). Ardından Adım G’deki çağrıyla aynı rezervasyonu tekrar çekin.

Yanıtın artık şunları gösterdiğini doğrulayın:

  • cancelled: true
  • Dolu bir cancelDate zaman damgası
  • İptal yaşam döngüsünü yansıtan paymentMethodStatus (CANCELLED, PARTIALLY_REFUNDED veya FULLY_REFUNDED geri ödeme politikasına bağlı olarak)

Güncellenmiş rezervasyonu kendi arayüzünüze aktarın ve iptalin operatöre görünür olduğunu doğrulayın — durum, iptal zamanı ve arayüzünüzün desteklediği geri ödeme göstergeleri dahil. İptal edilmiş rezervasyonun ikinci bir ekran görüntüsünü alın. Bu son kanıt belgesidir.

Aşağıdakileri tek bir arşiv (.zip) içinde paketleyin; dosya adı formatı:

wink-cert-<kanal-yöneticisi-adınız>-<yyyy-aa-gg>.zip

  1. API dökümü. Adım A’dan H’ye kadar yaptığınız her isteğin tam HTTP isteği (metot, URL, Authorization değeri gizlenmiş istek başlıkları ve PUT çağrılarının JSON gövdesi) ve tam HTTP yanıtı (durum kodu, yanıt başlıkları ve JSON gövdesi). Her istek/yanıt çifti, ait olduğu adımla açıkça etiketlenmiş olmalı (step-a-ping.json, step-d-day-3-put.json, step-g-list-bookings.json vb.). Düz metin .http dosyaları veya tek .har dışa aktarımı kabul edilir.

  2. Arayüz ekran görüntüsü: aktif rezervasyon. Adım G’de sertifikasyon rezervasyonunun kendi PMS / kanal yöneticisi arayüzünüzde misafir, tarihler, oda tipi, fiyat planı ve toplam tutar açıkça okunabilir şekilde görüntülendiği ekran görüntüsü.

  3. Arayüz ekran görüntüsü: iptal edilmiş rezervasyon. Adım H’de aynı rezervasyonun iptal sonrası arayüzünüzde durumu ve zaman damgası açıkça okunabilir şekilde görüntülendiği ekran görüntüsü.

  4. Sertifikasyon özeti. Arşiv içinde kısa bir README.md dosyası; içinde:

    • Kanal yöneticisi / PMS adı ve sürümü.
    • Kullandığınız managingEntityIdentifier, propertyIdentifier, masterRateIdentifier ve bookingIdentifier.
    • Staging otel slug’ı (https://staging-book.wink.travel/hotel/<your-slug> içindeki <your-slug>).
    • Sertifikasyon haftası tarih aralığı (Gün 1 → Gün 7 ISO-8601 formatında).
    • Sertifikasyonu yapan mühendisin adı ve e-posta adresi.

Arşivi Wink entegrasyon kontakınıza gönderin. Wink inceleyecek, varsa tutarsızlıkları takip edecek ve onaylanırsa Affiliate / Kanal Yöneticisi hesabınızın durumunu PENDING_APPROVAL’dan ACTIVE’ye çevirecektir. Entegrasyonunuz üretim onboarding için uygun hale gelir.

Kanal yöneticisi webhook etkinliklerine abone olarak gerçek zamanlı bildirimler alabilirsiniz:

  • channel-manager.update.rate — Fiyat güncellemesi alındı.
  • channel-manager.update.availability — Müsaitlik güncellemesi alındı.
  • channel-manager.update — Genel kanal yöneticisi güncellemesi.

Detaylar için Webhook Etkinlikleri Kataloğu sayfasına bakın.