Acente Portalı — Adım Adım Kullanım Kılavuzu

Travapi 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ı partner.travapi.com adresindeki portaldan alırsınız. Bu kılavuz, o portalı 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 çok yakında aynı API üzerinden eklenecek — mevcut entegrasyonunuz değişmeden yeni ürünleri de satabileceksiniz.

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

1. Tarayıcınızdan partner.travapi.com adresini açın.
2. Sağ üstteki İş Ortağı Ol butonuna tıklayın.
3. Açılan 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. Ana sayfada sağ üstteki Giriş bağlantısına tıklayın.
2. E-posta ve belirlediğiniz şifreyi girin.
3. Giriş yap deyin. Sistem sizi doğrudan API Erişimi paneline götürü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ı oluştur — anında test anahtarı üretir.
• Canlı erişim iste — 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ı oluştur butonuna tıklayın.
2. Anında bir pencere açılır: içinde API Key ve Secret vardır.
3. İkisini de kopyalayıp güvenli bir yere kaydedin. (Her satırdaki Kopyala butonu işinizi görür.)
4. 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ı erişim iste 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.

Travapi 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 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ı erişim iste” 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.