# Sık Sorulan Sorular

## **Kablosuz entegrasyon kullanarak geliştirmeye nasıl başlayabilirim ?**

Kablosuz entegrasyon kullanarak geliştirme yapmaya başlamak için geliştirici ekibimizin sizinle paylaştığı postman koleksiyonu ve client-id, client-secret bilgilerine sahip olduğunuzdan emin olun. Bu bilgilere ek olarak size göndereceğimiz Token ÖKC'nin ekranında “Satış Uygulamaları” menüsü altında “TokenX Connect (Kablosuz)” Android uygulamasını görebiliyor olmalısınız. TokenX Connect (Kablosuz) uygulamasını açtıktan sonra adım adım yapmanız gereken işlemlerin detaylarına Developer Portal'da bulunan TOKEN X CONNECT (CLOUD) / Genel Tanıtım (TR) ve Geliştirici Dokümanı (TR) sayfalarından ulaşabilirsiniz.

## **Kablosuz entegrasyonda nasıl sepet oluşturabilirim ?**

TokenX Connect (Kablosuz) Android uygulamasında iki farklı şekilde sepet oluşturabilirsiniz. Sepet oluşturmadan önce Token ÖKC ekranının sağ üst köşesinde bulunan düğmeden hangi sepet modunda olduğunuzu kontrol edebilir ve istediğiniz sepet moduna geçiş yapabilirsiniz. Sepet ödemesini hemen al modunda sepet oluşturmak için **"Add Instant Basket API"** isteğini,  Birden Fazla Sepeti Listele modunda sepet oluşturabilmek için **"Add Basket API"** isteğini kullanabilirsiniz. Bu isteklerin detaylarına TOKEN X CONNECT (CLOUD) / Geliştirici Dokümanı (TR) sayfasından ve postman koleksiyonundan ulaşabilirsiniz.

## **Kablosuz entegrasyonda “Add Basket” ve “Add Instant Basket” arasındaki fark nedir ?**

**Add Instant Basket**, ödemenin hemen alınacağı durumlarda kullanılır. Örneğin: Eczane veya perakende gibi kasada hemen ödeme alınan sektörlerde kullanılabilir. Bu modda oluşturulan sepetler terminal üzerinde direkt ödeme ekranına yönlendirilir ve ödeme sonrası otomatik olarak kapatılır. Bu modda sepet oluşturabilmek için TokenX Connect (Kablosuz) uygulamasında “Sepet ödemesini hemen al” modunda olduğunuzdan emin olmalısınız.

**Add Basket** ise, sepetin oluşturulmasıyla ödeme arasında belirli bir süre geçebilecek senaryolar için kullanılabilir. Örneğin: Restoranlarda masaya yapılan servislerin ödemesi veya eve teslim siparişlerin kapıda ödemesi gibi durumlar için uygundur. Bu modda oluşturulan sepetler, TokenX Connect (Kablosuz) uygulamasında “Birden fazla sepeti listele” modunda liste halinde gösterilir ve ilgili sepet seçilerek ödeme detay sayfasına gidilir ve sonrasında ödeme tamamlanır.

## **Kablosuz entegrasyonda sepet ödemesini hemen al modunda sepet oluşturamıyorum.**

Sepet ödemesini hemen al modunda sepet oluşturabilmek için Token ÖKC'de “Satış Uygulamaları → TokenX Connect (Kablosuz)“ uygulamasına girip cihazın “Sepet ödemesini hemen al”  modunda olduğuna emin olmak gerekir. Ayrıca, bu sepet modunda sepet oluşturabilmek için atılacak isteğin **Add Instant Basket API** olduğuna emin olunmalıdır. Bu isteğin detayına TOKEN X CONNECT (CLOUD) / Geliştirici Dokümanı (TR) sayfasından ve postman koleksiyonundan ulaşabilirsiniz.

## **Kablosuz entegrasyonda birden fazla sepeti listele modunda sepet oluşturdum, oluşturduğum sepeti göremiyorum.**

Birden fazla sepeti listele modunda oluşturduğunuz sepetleri görüntüleyebilmek için Token ÖKC'de bulunan “Satış Uygulamaları → TokenX Connect (Kablosuz)“ uygulamasına girip cihazın “Birden fazla sepeti listele”  modunda olduğuna emin olmak gerekir. Ayrıca, bu sepet modunda sepet oluşturabilmek için atılacak isteğin **Add Basket API** olduğuna emin olunmalıdır. Ayriyeten, **doğru** **şubenize** istek attığınızdan emin olmalısınız (istek atmak istediğiniz şubenin branch-id'sini kontrol edebilirsiniz). Bu isteğin detayına TOKEN X CONNECT (CLOUD) / Geliştirici Dokümanı (TR) sayfasından ve postman koleksiyonundan ulaşabilirsiniz.

## **Kablosuz entegrasyonda sepet modunu nasıl değiştirebilirim ?**

Token ÖKC'de bulunan "Satış Uygulamaları → TokenX Connect (Kablosuz)" uygulamasının sağ üst kısmında bulunan butonu kullanarak sepet modunu değiştirebilirsiniz.

## **Kablosuz entegrasyonda sepet ödemesini hemen al modunda sepetimi oluşturdum ancak cihazıma yansımadı.**

Add Instant Basket API isteği ile yaratılan sepetlerin Token ÖKC ekranında görüntülenebilmesi için “Satış Uygulamaları → TokenX Connect (Kablosuz)“ uygulamasının açık olması gerekir. Bu uygulama kapatılmış ise "Sepet ödemesini heman al" modunda sepet oluşturulabilir ancak oluşturulan bu sepet cihazınızda görüntülenemez. Oluşturulan sepetin direkt olarak görüntülenmesi için uygulamanın açık olması gerekir. Uygulama kapalıyken oluşturulan sepetler uygulama açıldığında otomatik olarak alınıp ödeme akışı başlatılacaktır.

## **Kablosuz entegrasyonda ödememi tamamladım, bunun bilgisini uygulamama nasıl alabilirim?**

Ödeme tamamlandıktan sonra, bu ödemenin bilgisini/detaylarını uygulamanıza alabilmeniz için bir webhook adresi ayarlamanız gerekmektedir. Webhook adresini ayarlamadıysanız, geliştirici dokümanında bulunan **2.** **Webhook Adreslerinin Ayarlanması (Set Client Settings API)** [https://developer.tokeninc.com/token-developer-portal-1/x-platform/token-x-connect-cloud/gelistirici-dokumani-tr#id-2.-webhook-adreslerinin-ayarlanmasi-clientsettings-set-api](https://developer.tokeninc.com/token-developer-portal-1/x-platform/token-x-connect-cloud/gelistirici-dokumani-tr#id-2.-webhook-adreslerinin-ayarlanmasi-clientsettings-set-api) başlığını takip ederek ödeme sonrası dönüş datasını alabileceğiniz webhook url’inizi **ClientSettings API isteğini kullanarak** ayarlayabilirsiniz. Uygulamanıza iletilecek olan webhook datasının içeriği ile ilgili detaylara dokümanın aynı sayfasında bulunan **9. Ödeme Sonrası Webhook İle Bildirim** başlığı altından ulaşabilirsiniz.

## **Kablosuz entegrasyonda webhook adresimi ayarladım ancak webhook gelmiyor.**

Kendi güvenlik katmanınızda bir IP kısıtlamanız var ise TokenX IP adreslerinizi IP whitelist'e eklemeniz gerekmektedir. TokenX IP adresleri bilgileri size verilmediyse lütfen bizimle iletişime geçiniz.

## **Kablosuz entegrasyonda oluşturduğum sepetin basketID'sini kaybettim.**

Geliştirici dokümanında bulunan **6. Terminal'de Olan Tamamlanmamış Sepetleri Alma (Get Open Baskets For Terminal API)** [https://developer.tokeninc.com/token-developer-portal-1/x-platform/token-x-connect-cloud/gelistirici-dokumani-tr#id-6.-terminalde-olan-tamamlanmamis-sepetleri-alma-get-open-baskets-for-terminal-api](https://developer.tokeninc.com/token-developer-portal-1/x-platform/token-x-connect-cloud/gelistirici-dokumani-tr#id-6.-terminalde-olan-tamamlanmamis-sepetleri-alma-get-open-baskets-for-terminal-api) başlığını takip ederek kaybettiğiniz sepetin basketID'sine ulaşabilirsiniz. Oluşturduğunuz sepetin basketID'sine, hangi sepet modunda oluşturulduğu farketmeksizin ulaşabilirsiniz.

## **Kablosuz entegrasyonda oluşturduğum sepeti nasıl silebilirim?**

Geliştirici dokümanında bulunan **8. Sepet Silme (Delete Basket API)** [https://developer.tokeninc.com/token-developer-portal-1/x-platform/token-x-connect-cloud/gelistirici-dokumani-tr#id-8.-sepet-silme-delete-basket-api](https://developer.tokeninc.com/token-developer-portal-1/x-platform/token-x-connect-cloud/gelistirici-dokumani-tr#id-8.-sepet-silme-delete-basket-api) başlığını takip ederek oluşturduğunuz, açık kalan/tamamlanmamış sepeti silebilirsiniz. Oluşturulan, açık kalan/tamamlanmamış sepet, hangi sepet modunda oluşturulduğu farketmeksizin silinebilir.

## **Kablosuz entegrasyonda birden fazla sepeti listele modunda başka bir şube için sepet oluşturdum.**

Bu durumda oluşturulan sepetin basketID'si ile Delete Basket API isteğini atılarak sepet silinebilir. Bu isteğin detaylarına geliştirici dokümanında bulunan **8. Sepet Silme (Delete Basket API)** [https://developer.tokeninc.com/token-developer-portal-1/x-platform/token-x-connect-cloud/gelistirici-dokumani-tr#id-8.-sepet-silme-delete-basket-api](https://developer.tokeninc.com/token-developer-portal-1/x-platform/token-x-connect-cloud/gelistirici-dokumani-tr#id-8.-sepet-silme-delete-basket-api) başlığını takip ederek ulaşabilirsiniz. Eğer oluşturduğunuz sepetin basketID'sini kaybettiyseniz, geliştirici dokümanında bulunan **6. Terminal'de Olan Tamamlanmamış Sepetleri Alma (Get Open Baskets For Terminal API)** [https://developer.tokeninc.com/token-developer-portal-1/x-platform/token-x-connect-cloud/gelistirici-dokumani-tr#id-6.-terminalde-olan-tamamlanmamis-sepetleri-alma-get-open-baskets-for-terminal-api](https://developer.tokeninc.com/token-developer-portal-1/x-platform/token-x-connect-cloud/gelistirici-dokumani-tr#id-6.-terminalde-olan-tamamlanmamis-sepetleri-alma-get-open-baskets-for-terminal-api) başlığını takip ederek kaybettiğiniz sepetin basketID'sine ulaşabilirsiniz.&#x20;

## **Kablosuz entegrasyonda terminal id'ye nereden ulaşabilirim?**

Terminal id'inizin değerini bilmiyorsanız iki farklı şekilde ulaşabilirsiniz.

1. Token ÖKC'nin arkasında bulunan AV ya da AT ile başlayan cihaza özel değer.&#x20;
2. 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 veya AT ile başlayan terminal id bilgisi, şube id (branch-id) bilgisi ve işyeri id (merchant-id) bilgisi yer almaktadır. QR kod'u okuttuğunuzda karşınıza çıkacak değer bu formattadır: "merchantId\_branchId\_terminalId".

## **Kablosuz entegrasyonda terminali uygulamama nasıl tanıtabilirim?**

TokenX Connect (Kablosuz) uygulamasında sol üstte bulunan butona tıklandığında bir QR kod gösterilir. Bu kod içerisinde API isteklerinde kullanılacak AV veya AT 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.&#x20;
