Genel Tanıtım (TR)
Last updated
Last updated
Giriş
Bu bölüm ile harici otomasyon sistem geliştiricilerinin genel bir bakış açısı ile sistem mimarisini, iş akışlarını, sistemler arasında paylaşılan veri içeriklerini, farklı kullanım senaryolarını tanıyıp geliştirmeye geçmeden önce sistemi tanıması amaçlanmıştır.
Harici otomasyon geliştiricileri, sistemi tanıdıktan sonra geliştirme sürecini sayfasından devam edecektir.
Geliştirici dokümanında detaylarını bulabileceğiniz Token X API ve webhooklarını kullanarak harici otomasyon sistemi kendi üzerinde oluşan sipariş/çekleri Token ÖKC'ye iletebilir. Token ÖKC'de bütün ödeme tipleri desteklenebilecek şekilde ödeme alınır. Ödeme sonrasında fiş ve/veya fatura oluşturulur. Siparişe ait ödeme ve fatura bilgileri harici sisteme geri dönülür.
Geliştirici Dokümanı sayfasında TokenX Kablosuz Entegrasyon'da kullanılan API / isteklerden detaylı bir şekilde bahsedilmektedir. Geliştirici dokümanı sayfasına geçmeden önce lütfen bu sayfayı detaylı bir şekilde inceleyin.
Geliştirmeye Başlamadan Önce: TokenX Kablosuz Entegrasyon kullanarak geliştirme sürecine başlamadan önce aşağıda belirtilen maddeleri kontrol etmenizi rica ederiz. (Aşağıda belirtilen tüm gereksinimler Token Finansal Teknolojiler tarafından entegre olacak iş yerine sağlanacaktır) .
- X30TR POS Cihazı
- client-id
ve client-secret
X30TR Terminalinizde TokenX Connect Uygulamasının Açılması: X30TR Terminalinizde cihazında “Satış Uygulamaları” menüsünden “TokenX Connect” uygulamasına erişebilirsiniz. - X30TR Terminalinizde TokenX Connect uygulaması açıldığındaki örnek resim:
Aşağıda belirtilen maddelerde TokenX API istekleri kullanılmaktadır. Bu API isteklerinin detaylarına Geliştirici Dokümanı'ndan ulaşabilirsiniz. Bu maddeler temel iş akışının daha anlaşılabilir olması için belirtilmiştir.
TokenX Connect Uygulaması ilk açıldıktan sonra yapılması gerekenler:
- 1. Client-Id ve Client-Secret ile Authentication (Authenticate API): Token Finansal Teknolojiler tarafından size iletilen client-id
ve client-secret
bilgileri ile Authenticate API isteği gönderilmelidir. İstek sonucundaki access_token
, kalan tüm isteklerde kullanılacaktır.
- 2. Token ÖKC'nin harici sisteme tanıtılması:
Token ÖKC'de bulunan TokenX Connect (Kablosuz) uygulaması ilk açıldığında ya da TokenX Connect (Kablosuz) uygulamasında sol üstte bulunan ikona tıklandığında bir QR kod gösterilir. Bu kod içerisinde API isteklerinde kullanılacak AV ile başlayan terminal id bilgisi, şube id (branch-id) bilgisi ve işyeri id (merchant-id) bilgisi yer almaktadır. Harici otomasyon sistemi, "merchantId_branchId_terminalId" formatındaki QR kodu okuyarak, terminal ve şube bilgisini alıp API isteklerinde bu bilgileri kullanabilmektedir.
- 3. Mali Eşleştirme (Get Fiscal Parameters API): Harici sistem ile Token ÖKC'nin mali olarak eşleşmesi için zorunlu adımdır. Kayıtlı kısımların/ürünlerin Get Fiscal Parameters API isteği ile alınarak, mali eşleştirme yapılmalıdır. Sepet gönderirken bu aşamada alınan kısım/ürün bilgileri kullanılmalıdır. Uygulama açıldıktan sonra terminaliniz mali bilgileri TokenX Sistemlerine göndermiştir, bu mali bilgileri alabilmek için Get Fiscal Parameters API isteğini çağırmanız gerekmektedir.
TokenX Connect Uygulamasını kullanarak Sepet Oluşturma. TokenX Connect uygulamasında iki farklı şekilde sepet oluşturabilirsiniz. Bunun için iki ayrı sepet modu mevcuttur. Bu sepet modlarını cihazınızın sağ üst köşesinde bulunan düğmeyi kullanarak değiştirebilirsiniz:
1. Sepet Ödemesini Hemen Al (Add Instant Basket API): Cihazınızı ilk açtığınızda "Sepet Ödemesini Hemen Al" modu ile karşılaşırsınız. Bu sepet modu ödemenin hemen alınacağı durumlarda kullanılır. Örneğin: Restoran, eczane, perakende sektörleri için kasada ödemenin alınacağı senaryolar. Bu senaryoları gerçekleştirmek için TokenX Connect uygulaması "Sepet Ödemesini Hemen Al" modunda olmalıdır. Add Instant Basket API isteği ile yaratılan sepetler Token ÖKC terminalinde ödeme ekranına yönlendirilecektir. Ödemesi alınan sepet otomatik olarak kapatılacaktır.
2. Birden Fazla Sepeti Listele (Add Basket API): Bu sepet modunun sepetin oluşturulması ile ödeme arasında belirli bir sürenin geçtiği senaryolarda kullanılması tavsiye edilir. Örneğin: Restoranlar için masada ödemenin alınması veya eve gönderilen siparişlerde kapıda ödemenin alınması senaryosu. Bu senaryoları gerçekleştirebilmek içn Token ÖKC'de “Birden fazla sepeti listele” modunun seçilmesi gereklidir. Add Basket isteği ile oluşturulan sepetler, Token ÖKC terminal üzerindeki TokenX Connect uygulamasında “Birden fazla sepeti listele” modu seçildiğinde liste halinde görünecektir. İlgili sepeti seçerek detaylarını görüp ödemesini alabilirsiniz.
Ödeme sonucunun alınması: Ödeme yapıldıktan sonra, ödeme ve mali bilgiler webhook aracılığıyla sistemlerinize bildirilir.
Kablosuz entegrasyon ile işyerindeki birçok bağlantı senaryo desteklenebilmektedir.
Bir harici otomasyon cihazının birden fazla ÖKC'ye bağlanabilme
Birden fazla harici otomasyon cihazının bir ÖKC'ye bağlanabilmesi
Harici otomasyon sisteminden şube bazlı (örneğin internet siparişleri, kapıda ödeme) ÖKC'lere bağlanabilmesi