Resvisor Acente Paneli — Adım Adım Kullanım Kılavuzu

Resvisor Acente API, otel · tur · cruise envanterimizi kendi sisteminizden aramanızı ve rezervasyon yapmanızı sağlar. Yani müşterinize kendi sitenizde/programınızda arama sonucu gösterir, satışı doğrudan bizden yaparsınız — her satışta otomatik komisyonunuz işler.

Bunu kullanabilmek için bir API anahtarına ihtiyacınız var. Bu anahtarı extranet.resvisor.com adresindeki acente panelinden alırsınız. Bu kılavuz, o paneli sıfırdan nasıl kullanacağınızı gösterir.

Şu anda neler satabilirsiniz?

Otel · Tur · Cruise hemen kullanıma açıktır. Uçak Bileti ve Transfer henüz satışa açık değildir.

Portala ilk kez geliyorsunuz — önce iş ortaklığı başvurusu yapmanız gerekir.

1. Tarayıcınızdan resvisor.com adresini açın.
2. Sağ üstteki İş Ortağı Ol butonuna tıklayın.
3. Başvuru formu extranet.resvisor.com adresinde açılır. Formu doldurun: Firma adı, Vergi numarası, Yetkili kişi ve E-posta zorunludur. Vergi dairesi, telefon ve kullanım amacı isteğe bağlıdır.
4. Başvuruyu gönder deyin. Ekipimiz başvurunuzu inceler.

Başvurunuz onaylanınca size bir e-posta gelir — şifrenizi bu e-postadan oluşturursunuz.

1. Başvuruda verdiğiniz e-posta kutusunu kontrol edin. (Gelmezse spam/gereksiz klasörüne bakın.)
2. E-postadaki “Şifre belirle” bağlantısına tıklayın.
3. Açılan ekranda yeni şifrenizi iki kez yazıp Şifreyi kaydet deyin.
4. Şifreniz kaydedilir; artık giriş yapabilirsiniz.

Artık hesabınız hazır — panele girmek için giriş yapın.

1. Tarayıcınızdan extranet.resvisor.com adresini açın (resvisor.com’da sağ üstteki Giriş de buraya götürür).
2. E-posta ve belirlediğiniz şifreyi girin.
3. Giriş yap deyin. Ana Sayfa açılır; API anahtarlarınız soldaki menüde API Erişimi altındadır.

Giriş yaptığınızda karşınıza API Erişimi paneli çıkar. Tüm anahtar işleriniz buradadır.

Panelde üç şey görürsünüz:

• Sandbox anahtarı üret — anında test anahtarı üretir.
• Canlı anahtar talep et — gerçek satış anahtarı talep eder.
• API Anahtarlarınız tablosu — sahip olduğunuz tüm anahtarları listeler.

Tablodaki sütunlar: Anahtar (kimliği), Ortam (sandbox/live), Durum (active/revoked…), Oluşturma tarihi ve İşlem (iptal). Durum anlamları için Anahtar durumları bölümüne bakın.

Gerçek satışa geçmeden önce her şeyi test anahtarıyla denersiniz. İşte en önemli adım.

1. Panelde Sandbox anahtarı üret butonuna tıklayın; isterseniz anahtara bir ad verip Üret deyin.
2. Sayfanın üstünde turuncu bir kutu açılır: içinde Anahtar (API Key) ve Gizli anahtar (Secret) vardır.
3. İkisini de kopyalayıp güvenli bir yere kaydedin. (Her satırdaki Kopyala butonu işinizi görür.)
4. Kaydettim, kapat deyin. Anahtarınız tabloda görünmeye başlar.

Testleriniz bittiğinde, gerçek satış için canlı anahtar talep edersiniz.

1. Panelde Canlı anahtar talep et butonuna tıklayın.
2. Talebiniz Woxx’a iletilir. Sertifikasyon/onay sonrası canlı anahtarınız aktifleşir.
3. Zaten bekleyen ya da aktif bir canlı anahtarınız varsa sistem sizi uyarır (aşağıdaki gibi).

Anahtarınız hazır. Şimdi çalıştığını görelim — üç basit adım: token al → ara → rezerve et.

Aşağıdaki üç istek, entegrasyonunuzun temelidir. Bu örnekler curl ile gösterilmiştir ama aynısını herhangi bir programlama dilinden yapabilirsiniz.

1. Token alın: API Key + Secret gönderir, 1 saat geçerli bir token alırsınız.
2. Otel arayın: token’ı Authorization başlığına koyup arama yaparsınız; sonuçta her otelin bir rateKey’i gelir.
3. Rezervasyon yapın: seçtiğiniz rateKey ile booking isteği atarsınız. Sandbox’ta yanıt SBX-… ile başlar — gerçek rezervasyon oluşmaz.

Tablodaki Durum sütunu her anahtarın ne halde olduğunu söyler:

Bir anahtarı iptal etmek için tablodaki o satırın İşlem sütununda İptal et deyin ve onaylayın.

API entegrasyonu yapmadan da Resvisor panelinden doğrudan fiyat arayıp rezervasyon yapabilirsiniz. Ekibinizin telefonla ya da masada yaptığı satışlar için bu yol yeterlidir.

b2b.resvisor.com satış paneli için ekran görüntülü adım adım kılavuzlar: Acente yöneticisi · Satış personeli

Ana Sayfa — her şey tek ekranda

Girişten sonra açılan Ana Sayfa günlük işin çoğunu tek ekranda toplar:

• Arama kutusu — Otel, Tur ya da Kruvaziyer sekmesinden doğrudan fiyat aratırsınız.
• Rezervasyon Arama — referans ya da kısa kodla (ör. HL05TAAMQ6) rezervasyonu hemen bulursunuz.
• Durum İzleme — Beklemede, Onaylı ve İptal sekmelerinde rezervasyonlarınız kodu, giriş tarihi ve misafiriyle listelenir.
• Son Rezervasyonlar — bugün, bu hafta, bu ay ya da bu yıl yapılanlar.
• Duyurular ve Dokümanlar — Woxx'un paylaştığı son duyurular ve dosyalar.
• İstatistikler — ürüne ve duruma göre rezervasyon sayıları, aylık satış grafiği; yöneticiler için kredi limiti, bakiye ve kullanılabilir tutar.

1. Fiyat arayın

1. Soldaki menüden Fiyat Arama'yı açın; Otel, Tur ya da Kruvaziyer sekmesini seçin.
2. Destinasyon, tarihler ve oda/kişi bilgisini girip Ara deyin. Sonuçlar kaynaklardan geldikçe listeye eklenir.
3. Gördüğünüz fiyatlar acente marjınız dahil satış fiyatıdır. Yıldız, pansiyon ve fiyat aralığıyla süzebilirsiniz.

2. Rezervasyon yapın

1. Otel kartında Oda Seç'e tıklayın; açılan sayfada oda ve pansiyonu seçip Rezervasyon deyin.
2. Sihirbaz üç adımdır: Hizmet (özet ve iptal koşulu) → Misafirler (rezervasyon sahibi ve yolcular) → Onay.
3. Onay adımında tutarın cari hesabınıza borç yazılacağını kabul edip Rezervasyonu tamamla deyin. Rezervasyon kodu (ör. HL07TA4RDU) ve voucher hemen hazır olur.

3. Rezervasyonlarınızı izleyin

Rezervasyonlarım ekranında tüm rezervasyonlarınız kod, tarih ve durumla listelenir; tarih, durum, ürün, kod ve misafir adıyla arayabilir, Excel'e aktarabilirsiniz. Her rezervasyonun kısa bir kodu vardır (otelde HL…, turda OT…); arama kutusuna kısa kodu ya da uzun referansı yazabilirsiniz.

Bir rezervasyonun detayından Voucher PDF'ini indirir, iptal koşulunu görüp iptal edebilirsiniz. Voucher otel ve tur rezervasyonlarında Resvisor adına düzenlenir: kısa kod, tarihler, misafirler, satış tutarı ve durum bandı (onaylı / iptal) yer alır; tedarikçi adı ve alış fiyatı yer almaz.

4. Cari hesabınız

Cari ekranı kredi limitinizi, bakiyenizi ve kullanılabilir tutarı gösterir; her rezervasyon ve iptal bir hareket olarak listelenir. Limit dolduğunda yeni rezervasyon yapılamaz; ödemeniz işlendikçe kullanılabilir tutar açılır.

5. Kullanıcılar ve yetkiler

Firmanızdaki çalışanları Kullanıcılar → Kullanıcı ekle ile eklersiniz; eklenen kişiye şifre belirleme e-postası gider. İki yetki vardır:

6. Destek

Sağ alttaki destek düğmesinden ya da Destek ekranından talep açar, yanıtları ve durumları (açık, işlemde, çözüldü) buradan izlersiniz.

7. Bildirimler ve telefona kurulum

Üst çubuktaki 🔔 zilinde sizi ilgilendiren olaylar toplanır: iptal talebinizin sonucu, iade, opsiyon son tarihi yaklaşıyor / opsiyon düştü, destek talebinize cevap ve yeni duyuru. Satırına basınca ilgili rezervasyon, talep ya da duyuru açılır.

Zil penceresindeki ⚙ simgesi Bildirim ayarları'nı açar: hangi konunun (Rezervasyon · Destek · Duyuru) telefona gelmesini istediğinizi anahtarla seçersiniz. Kapattığınız konu zilde görünmeye devam eder.

Telefona kurulum (bir kez, yaklaşık 1 dakika):

1. Bildirim ayarlarında Bağlantı oluştur'a basın, bağlantıyı kopyalayıp telefonunuza gönderin (bağlantı 10 dakika geçerlidir).
2. Telefonda Chrome (Android) ya da Safari (iPhone) ile açın; Resvisor Bildirimler sayfası giriş yapmış olarak gelir.
3. Android: ⋮ → Ana ekrana ekle → Yükle. iPhone: Paylaş → Ana Ekrana Ekle.
4. Ana ekrandaki Resvisor simgesinden açın, Bildirimlere izin ver → İzin ver. Telefonunuza bir deneme bildirimi gelir.

Resvisor Acente API yalnızca bir arama motoru değil; uçtan uca satış altyapısıdır. Anahtarınızı aldıktan sonra elinizde olanlar:

• 🧩 Geliştirici dostu paket: Swagger (etkileşimli API dokümanı), Postman koleksiyonu, örnek istek/yanıtlar ve dokümantasyon. Teknik ekibiniz saatler içinde entegre olur. (Portaldaki /developers sayfası ilk duraktır.)
• 🔔 Webhook ile anlık bildirim: İptal/iade, opsiyon son tarihi yaklaşıyor / opsiyon düştü ve yeni duyuru gibi olaylar gerçekleştiğinde sisteminize otomatik, imzalı bildirim gönderilir — sürekli sorgulamanıza gerek kalmaz.
• 🔄 Rezervasyon sonrası yönetim: Durum sorgulama, iptal ve iade talebi — hepsi API üzerinden. Satış bittiğinde yalnız kalmazsınız.
• 🖼️ Zengin içerik: Otel fotoğrafları, açıklamalar, olanaklar ve destinasyon verisi — kendi sitenizi eksiksiz kurmanız için hazır içerik.
• 🛠️ İki entegrasyon yolu: Kod ile API entegrasyonu ya da hiç kod yazmadan hazır B2B panelimizden satış. İşinize uyan yolu seçersiniz.

• Secret’ı asla paylaşmayın. E-posta, mesaj, ekran görüntüsü — hiçbir yerde açık göndermeyin.
• Secret’ı tarayıcı/mobil uygulamaya gömmeyin. İstekleri kendi sunucunuzdan atın.
• Sandbox ile geliştirin, live ile satın. Test bittiğinde canlıya geçin.
• Şüphede iptal edin. Sızıntı ihtimalinde anahtarı iptal edip yenisini üretmek saniyeler sürer.
• IP kısıtı (opsiyonel): Canlı anahtarınızı yalnızca kendi sunucu IP’nizden çalışacak şekilde kısıtlayabilirsiniz — ekstra güvenlik için Woxx’tan talep edin.

Sandbox’ta rezervasyon yaptım, gerçek oldu mu?

Hayır. Sandbox tamamen testtir; yanıt SBX-… ile gelir, hiçbir gerçek kayıt/borç oluşmaz.

Secret’ı kaybettim, ne yapmalıyım?

Secret bir daha gösterilemez. O anahtarı iptal edip yeni bir anahtar oluşturun; yeni Secret’ı hemen kaydedin.

Token ne kadar geçerli?

1 saat. Süresi dolunca aynı API Key + Secret ile yeni token alırsınız — anahtarınız değişmez.

Canlı anahtarı ne zaman alırım?

“Canlı anahtar talep et” dedikten sonra Woxx onayıyla. Cari limit ve gerekli anlaşma tamamlanınca aktifleşir.

Fiyatları neden arama listesinde markup’sız görüyorum?

Acente marjınız otel detayında ve rezervasyonda uygulanır; liste fiyatı taban fiyattır. Bu normaldir.

Hangi ürünleri satabilirim?

Anahtarınızın yetkisine göre otel, tur ve cruise. Yetki kapsamınızı token yanıtındaki scopes alanında görürsünüz.