Kontrol listesinin amacı: Yanlış yetkiyle canlıya çıkmamak
Entegrasyonun testte bir kez başarılı olması, canlıda her senaryoyu karşılayacağı anlamına gelmez. Örneğin bir banka uygulaması yalnızca yetkilendirildiği restoranlardan rezervasyon oluşturmalı; POS sağlayıcısı ise kendi restoranının var olan rezervasyon kayıtlarına erişmelidir. İlk kontrol, bağlantının partner türüyle ve yapmak istediği işlemle eşleşmesidir.
Bu rehber, teknik görüşmeden sonra geliştirici ve operasyon ekiplerinin birlikte uygulayabileceği son kontrol adımlarını özetler. Yeni başlayan ekipler önce Partner API entegrasyonuna başlangıç rehberini inceleyebilir.
1. Partner, restoran ve işlem izinlerini karşılaştırın
En az bir yetkili restoranı listeleyebildiğinizi ve yetkiniz olmayan başka bir restorana erişemediğinizi test edin. Guest Network ortaklığı için müsaitlik ve rezervasyon oluşturma, POS için rezervasyon okuma ve servis işlemleri gibi gerekli yetkileri ayrı yazın. Bir işlemin erişim token'ı ile çağrılabilmesi, ilgili restoran ve veri kapsamına da izin verildiği anlamına gelmez.
Misafir iletişim bilgileri gereken bir senaryoda ayrıca okuma iznini doğrulayın. Bu alanlar kapalıysa uygulamanız eksik bilgiyi hata gibi sunmasın. Pazarlama amacıyla iletişim kurmak ise teknik okuma izninden farklı bir hukuki değerlendirme gerektirir.
2. Rezervasyon ve ödeme durumlarını ayırın
Guest Network akışında restoran yapılandırması, tarih-saat müsaitliği, geçici hold ve confirm işlemlerini sırayla doğrulayın. Ödeme gerekmeyen rezervasyon ile ertelenmiş ödeme ve anında ödeme senaryolarını ayrı test edin. Anında ödeme veya provizyonda ödeme sonrası Finalize yapılmazsa rezervasyon henüz oluşmamış olabilir.
Ödeme başarılı olduğu hâlde uygulamaya geri dönülemeyen bir durumu deneyin. Ödeme durumunu sorgulama ve eksik Finalize işlemini tamamlama adımlarının kime ait olacağını netleştirin. Kullanıcıya gösterilen başarı mesajı, yalnızca kesinleşmiş rezervasyon sonucuna dayanmalıdır.
3. Webhook güvenliğini ve tekrarları deneyin
Webhook alıcısında HMAC imza doğrulaması, zaman damgası kontrolü ve aynı EventId ile tekrar teslim edilen olayları ele alma davranışını test edin. Bildirimin rezervasyonun tüm alanlarını içermediğini unutmayın. Gerekli izinle rezervasyonun güncel detayını tekrar okuyun.
Onay ve iptal olaylarını art arda üreterek farklı sırada gelen bildirimlere hazırlanıp hazırlanmadığınızı kontrol edin. Uygulamanız son gelen webhook adını değil, güncel kaydı misafire göstermelidir. Hangi olay türlerinin gerçekten yayınlandığını teknik dokümandan doğrulayın; bir olay türüne abone olmak tek başına o olayın yayımlandığı anlamına gelmez.
4. Canlıya geçiş için sorumluları ve geri dönüş yolunu belirleyin
İlk görüşmede senaryo ve bağlantı kapsamı birlikte çıkarılır. Misafirin uygulama içinden restoran talebi göndermesiyle Rezervem’deki rezervasyon durumunun partner ekranında izlenmesi farklı akışlardır. Partner API bu iki kullanım biçimini destekleyebilir; hangi akışın açılacağı, görüşmede belirlenen kapsama bağlıdır.
Kapsam netleştiğinde test ortamı, erişim anahtarları ve API dokümantasyonu paylaşılır. Partner ekipleri REST API ve webhook akışını kendi sistemlerinde geliştirir. Rezervem tarafındaki doğrulama, verinin ve durum değişikliklerinin tanımlanan kapsam içinde ilerlediğini kontrol eder. Kullanım senaryosu testte karşılığını bulmadan canlı rezervasyon akışı açılmaz.
Başvurudan canlıya Partner API yolu
Bir partnerin yolu başvuru ve ilk görüşmeyle açılır. Kurumsal partnerler Guest Network tarafında ilerler; teknoloji ortakları ve restoran grupları Partner API entegrasyon görüşmesinde kullanım senaryosunu paylaşır. Beklenen, bütün sistem ayrıntılarını tek seferde göndermek değil, Rezervem’le hangi iş akışının konuşacağını açıkça tarif etmektir.
Ardından erişim kapsamı belirlenir; test erişimi, dokümantasyon ve yetkiler partnerin senaryosuna göre tanımlanır. Her partnerin rezervasyon oluşturma hakkı otomatik olarak açılmaz. Oracle Simphony Cloud doğrulanmış POS entegrasyonu, OMNI POS ise yetkilendirilmiş veritabanı bağlantısı üzerinden gece adisyon/rezervasyon eşleştirmesi sağlar. Google Haritalar rezervasyonları uygun restoranlar için aktif olarak sunulur; Rezervem'in kendi doğrudan teknik bağlantısının geliştirilmesi ayrıca sürmektedir. Telefon/santral desteği işletmeye göre değerlendirilir. Partner API ve Guest Network sayfalarından kapsamı inceleyebilirsiniz.
