Entegrasyona Başlarken

İmzaPos ödeme API'si Restful mimarisi ile geliştirilmiş olup. Üye işyerlerinin internet üzerinden ödeme almalarına olanak tanır. Bir çok programlama dili ve hazır alt yapılar hazırlanmış kütüphaneleri ile entegrasyon hızlı bir şekilde tamamlanabilir. Başlamak için aşağıdaki adımları izlemeniz yeterli.

API Erişim Bağlantıları

Geliştiricilere sunulan 2 tip bağlantı adresi vardır

API Açıklama Bağlantı
Test Ortamı (Sandbox) Entegrasyon aşamasında kullanılacak bağlantı adresi https://yourdomain.com/api/live/
Gerçek Ortam (Live) Yayına geçildiği aşamada kullanılacak bağlantı adresi https://yourdomain.com/api/sandbox/

Test ortamı ile entegrasyonun sorunsuz bir şekilde çalıştığından emin olabilirsiniz. Burada yapılan işlemler gerçeği yansıtmamakla birlikte live ortamda alacağınız cevapları size verecektir.

API İstekleri ve Cevaplar

Belirtilen API endpoint adreslerine HTTP POST formatında yapılan isteklere karşın JSON formatında cevap alınmaktadır. Her endpoint için gönderlilmesi zorunlı veya opsiyonel olan parametreler mevcuttur.

TLS / SSL Güvenlik Protokolü

PCI-DSS Protokolleri gereği yapılan istekler TLS 1.1 ve TLS 1.2 protokolleri ile yapılmalıdır. Aksi durumda bağlantı sağlanmaycak ve işlemler gerçekleşmeyecektir.

Başvuru ve Doğrulama

İmzaPos paneli hesap sayfanızda bulunan "Api İstekleri" bölümünde yeni hesap oluşturabilirsiniz. Her kullanıcı kendi hesabı üzerinden api oluşturma işlemlerini yapmalıdır. Adınıza oluşturulacak Bayi kodu ve Güvenlik Anahtarı bilgileri ile erişim sağlanacaktır. Bu bilgilerin geliştirici dışında kimseyle paylaşılmaması önerilir. Ayrıca geliştirici tarafını alan adı bazlı ve ip bazlı kısıtlamaya tabi tutabilirsiniz. Belirtilen alan adı ve ip dışındaki istekler kabul edilmez.

Hash (Güvenlik kodu) Üretilmesi

Hash bilgisi gönderilen bilgileri teyit amaçlı alınan şifrelenmiş bir değerdir. Gönderilen parametrelerin belli bir format üzerinde birleşmesi sonucu bu değer üretilir. Oluşturulan değer İmzaPos tarafında aynı işlemler yapıldığında üretilen değer ile aynı olmalıdır.
Bu değeri oluşturmak için izlenecek adımlar şu şekildedir:
1- Zorunlu tüm parametreler ve ek olarak opsiyonel eklenene parametrelerin gönderimi sağlanır
2- Parametreler isimlerine göre alfabetik olarak sıralanıp bir string değer olarak birleştirilir.
3- Her parametre arasına "ip" harfleri yazılır
4- Oluşturulan string değer sha256 hash formatına dönüştürülür.
5- İstek yapılan endpoint'in "hash" parametresinde bu değer gönderilir.