POS Terminal Management API, ödeme terminali envanterinizi yönetmek için kullanılan bir API'dir. Bu API sayesinde belirli bir terminal hakkında bilgi alabilir, terminallerinizin ve mağazalarınızın genel görünümünü elde edebilir ve terminalleri bir satıcı hesabına veya mağazaya atayabilirsiniz. API, her istekte X-API-Key başlığı ile gönderilen bir API anahtarı ile kimlik doğrulaması yapar. Ayrıca, sürümleme desteği sayesinde URL'de sürüm numarası belirterek farklı sürümleri kullanabilirsiniz. Sürüm belirtildiğinde Boolean yanıt değerleri string formatında ("true"/"false") dönerken, sürüm belirtilmediğinde normal boolean (true/false) olarak döner.
Hangi ihtiyaçlarda değerlendirilebilir?
- Ödeme terminali envanterini merkezi olarak yönetmek isteyen işletmeler
- Terminalleri mağaza veya satıcı hesaplarına otomatik atamak isteyen kuruluşlar
- POS terminal ağını izlemek ve raporlamak isteyen ödeme hizmet sağlayıcıları
Yaygın kullanım alanları
Terminal Bilgisi Sorgulama
Belirli bir terminalin durumu, modeli, seri numarası gibi bilgileri almak için API kullanılabilir. Bu sayede terminal envanteri güncel tutulabilir.
Terminal ve Mağaza Genel Bakışı
İşletmeye ait tüm terminallerin ve mağazaların listesini alarak operasyonel görünürlük sağlanabilir. Bu, hangi terminalin hangi mağazada olduğunu takip etmeyi kolaylaştırır.
Terminal Atama
Terminalleri belirli bir mağazaya veya satıcı hesabına atayarak yapılandırma süreçleri otomatikleştirilebilir. Bu, yeni mağaza açılışlarında veya terminal taşımalarında iş yükünü azaltır.
İncelenmesi gereken noktalar
- API anahtarı güvenliği: API anahtarlarınızı gizli tutun ve yalnızca güvenli sunucular üzerinden kullanın.
- Sürümleme farklılıkları: Sürüm belirtilen endpoint'lerde Boolean değerler string olarak döner; bu, veri tipi dönüşümlerinde dikkat edilmesi gereken bir noktadır.
- Canlı ortam geçişi: Canlı ortamda kullanmak için yeni web servis kullanıcı kimlik bilgileri oluşturmanız gerekir; test ortamından farklı kimlik bilgileri kullanılmalıdır.
WordPress.org
Kurulum ve geliştirme notları
API'nin kurulumu, bir API anahtarı edinmeyi ve isteklerde bu anahtarı X-API-Key başlığında göndermeyi içerir. Resmi dokümantasyonda adım adım kurulum bilgisi verilmemiştir.
API'nin geliştirme süreci, API anahtarı ile kimlik doğrulama yaparak endpoint'lere istek göndermeyi içerir. Resmi dokümantasyonda geliştirme adımlarına dair ayrıntılı bilgi verilmemiştir.
Hazır çözümün ötesinde
Özel geliştirme ne zaman değerlendirilebilir?
ZeplinGo olarak, POS Terminal Management API'yi mevcut web sistemlerinize entegre etmek için ihtiyaçlarınıza özel çözümler geliştiriyoruz. API'nin sunduğu terminal yönetimi işlevlerini web arayüzünüzle birleştirerek operasyonel süreçlerinizi dijitalleştirebiliriz. Kapsamı birlikte belirleyerek, terminal envanterinizi yönetmek için size özel bir panel veya otomasyon sistemi tasarlayabiliriz.
Ücretsiz ön çalışma isteyin →Değerlendirme soruları
POS Terminal Management API için API anahtarını nasıl alabilirim?
API anahtarınızı Adyen Customer Area'dan alabilirsiniz. Resmi dokümantasyonda 'How to get the API key' bölümünde ayrıntılı açıklama bulunmaktadır.
API'nin sürümleme sistemi nasıl çalışır?
API, URL'de vXX formatında sürüm numarası kullanır. Örneğin, /postfmapi/terminal/v1/getTerminalsUnderAccount. Sürüm belirtildiğinde Boolean yanıtlar string olarak dönerken, belirtilmediğinde normal boolean olarak döner.
Canlı ortamda API'yi kullanmak için ne yapmalıyım?
Canlı ortamda kullanmak için yeni web servis kullanıcı kimlik bilgileri oluşturmanız gerekir. Test ortamında kullandığınız kimlik bilgileri canlı ortamda geçerli değildir.
