Alıntı
E-pin Servisi > Entegrasyon
E-pin servisi ile web siteniz arasında kolay bir entegrasyon gerçekleştirerek E-pin'leri Sonteklif sistemine girmeden de alıcılara otomatik teslimat gerçekleştirmeniz mümkündür. Bu şekilde, alıcının ödemesi sonrası Sonteklif sistemi web sitenizin ileteceğiniz bir sayfasına bağlanır, ürün ve adet konusunda bildirim yapar ve sitenizin bildirime cevap olarak ilettiği E-pin'leri alarak alıcının Sonteklif'teki mesaj kutusuna gönderir.
atış sonrası Sonteklif sisteminin bağlantı kuracağı sitenizin adresini yazın: Örnek: http://www.siteniz.com/yeni_epin_istegi.php
Satış sonrası yukarıya girdiğiniz adrese bağlantı kurulur ve satışa ilişkin aşağıda açıklaması bulunan bilgiler HTTP POST yöntemiyle iletilir.
urun_id : Sonteklif üzerinde satışa sunduğunuz ürünün numarasıdır. Servis ana sayfasındaki "Düzenle" linkleri üzerinden bu bilgiyi görebilirsiniz.
satis_kodu : Sonteklif üzerindeki alışverişe ait satış kodudur. Alışveriş sonrası otomatik olarak oluşur.
adet : Üründen kaç adet alındığı bilgisidir. Bu bilgiye göre kaç adet E-pin gönderimi yapılacağı tarafınızca bilinir.
hash : İsteğin Sonteklif tarafından geldiğinden emin olunması için güvenlik amaçlı oluşturulmuş koddur.
Bağlantı adresine yapılan gönderime XML yapısında bir yanıt beklenecektir. XML içeriği aşağıdaki örnekteki gibi olmalıdır.
<?xml version="1.0" encoding="UTF-8"?>
<EpinResponse>
<Epin>1111-2222-3333-4444</Epin>
<Epin>8888-7777-6666-5555</Epin>
...
</EpinResponse>
Bağlantı sırasında iletilen ADET bilgisine uygun olarak XML içerisinde "<Epin></Epin>" düğümleri tekrarlanır.
ÖNEMLİ: Stoklarınızda belirtilen ADET kadar E-pin bulunmuyorsa yanıt olarak NO_STOCK döndürmelisiniz. Örneğin gelen istekte ADET 3 ise ve sitenizde kalan ürün adedi 2 ise XML döndürmemeli, yalnızca NO_STOCK yazdırmalısınız.
HASH hesaplama ve örnek değerler:
PHP için:
hash_hmac('sha256', (SATIS_KODU.URUN_ID.ADET), SERVIS_ID);
Test yapabilmeniz için örnek değerlerle hash hesaplama ve sonucu:
hash_hmac('sha256', ('8737-232323222'.'676755'.'2'), 'DSF34USGT6')
5bcbdffdd566e8f3b7429f65e768d5bcc134bf83094eb7f810 6aa6ea19a2914d
NOT: Eğer web sitenizde .NET kullanıyorsanız yukarıdaki örnek hesaplama için farklı sonuç elde edersiniz. Çözüm için aşağıdaki sayfa yardımcı olacaktır:
http://www.theinquisition.co.uk/2011...p-or-c-vb-net/
Bilmeniz gerekenler ve dikkat edilmesi gereken hususlar:
1. Sitenize birkaç deneme sonunda bağlantı kurulamaması durumunda (network sorunları vb. nedenlerle) eğer varsa sisteme elle girdiğiniz E-pin'ler otomatik teslimat yapılır. Eğer ürüne ait elle girdiğiniz E-pin bulunmuyorsa ya da adedi yetersizse teslimat işlemlerine Sonteklif üzerinden devam etmeniz gerekir.
2. Bağlantı adresine gelen gönderimin Sonteklif'ten geldiğine emin olunmalıdır. Bunun için mutlaka sitenizde HASH kontrolü yapılmalıdır. HASH hesaplaması servis numaranız (SERVIS_ID), SATIS_KODU, URUN_ID ve ADET değişkenlerinin hash fonksiyonundan geçirilmesi ile elde edilir. Servis numaranız için Bize Ulaşın formu üzerinden iletişime geçmenizi rica ederiz.
3. Servis numaranızı güvenli bir şekilde saklamalı ve ayrıca Sontekliften gelen HASH bilgilerini üçüncü kişilerin erişiminden korumalısınız.
E-pin servisi ile web siteniz arasında kolay bir entegrasyon gerçekleştirerek E-pin'leri Sonteklif sistemine girmeden de alıcılara otomatik teslimat gerçekleştirmeniz mümkündür. Bu şekilde, alıcının ödemesi sonrası Sonteklif sistemi web sitenizin ileteceğiniz bir sayfasına bağlanır, ürün ve adet konusunda bildirim yapar ve sitenizin bildirime cevap olarak ilettiği E-pin'leri alarak alıcının Sonteklif'teki mesaj kutusuna gönderir.
atış sonrası Sonteklif sisteminin bağlantı kuracağı sitenizin adresini yazın: Örnek: http://www.siteniz.com/yeni_epin_istegi.php
Satış sonrası yukarıya girdiğiniz adrese bağlantı kurulur ve satışa ilişkin aşağıda açıklaması bulunan bilgiler HTTP POST yöntemiyle iletilir.
urun_id : Sonteklif üzerinde satışa sunduğunuz ürünün numarasıdır. Servis ana sayfasındaki "Düzenle" linkleri üzerinden bu bilgiyi görebilirsiniz.
satis_kodu : Sonteklif üzerindeki alışverişe ait satış kodudur. Alışveriş sonrası otomatik olarak oluşur.
adet : Üründen kaç adet alındığı bilgisidir. Bu bilgiye göre kaç adet E-pin gönderimi yapılacağı tarafınızca bilinir.
hash : İsteğin Sonteklif tarafından geldiğinden emin olunması için güvenlik amaçlı oluşturulmuş koddur.
Bağlantı adresine yapılan gönderime XML yapısında bir yanıt beklenecektir. XML içeriği aşağıdaki örnekteki gibi olmalıdır.
<?xml version="1.0" encoding="UTF-8"?>
<EpinResponse>
<Epin>1111-2222-3333-4444</Epin>
<Epin>8888-7777-6666-5555</Epin>
...
</EpinResponse>
Bağlantı sırasında iletilen ADET bilgisine uygun olarak XML içerisinde "<Epin></Epin>" düğümleri tekrarlanır.
ÖNEMLİ: Stoklarınızda belirtilen ADET kadar E-pin bulunmuyorsa yanıt olarak NO_STOCK döndürmelisiniz. Örneğin gelen istekte ADET 3 ise ve sitenizde kalan ürün adedi 2 ise XML döndürmemeli, yalnızca NO_STOCK yazdırmalısınız.
HASH hesaplama ve örnek değerler:
PHP için:
hash_hmac('sha256', (SATIS_KODU.URUN_ID.ADET), SERVIS_ID);
Test yapabilmeniz için örnek değerlerle hash hesaplama ve sonucu:
hash_hmac('sha256', ('8737-232323222'.'676755'.'2'), 'DSF34USGT6')
5bcbdffdd566e8f3b7429f65e768d5bcc134bf83094eb7f810 6aa6ea19a2914d
NOT: Eğer web sitenizde .NET kullanıyorsanız yukarıdaki örnek hesaplama için farklı sonuç elde edersiniz. Çözüm için aşağıdaki sayfa yardımcı olacaktır:
http://www.theinquisition.co.uk/2011...p-or-c-vb-net/
Bilmeniz gerekenler ve dikkat edilmesi gereken hususlar:
1. Sitenize birkaç deneme sonunda bağlantı kurulamaması durumunda (network sorunları vb. nedenlerle) eğer varsa sisteme elle girdiğiniz E-pin'ler otomatik teslimat yapılır. Eğer ürüne ait elle girdiğiniz E-pin bulunmuyorsa ya da adedi yetersizse teslimat işlemlerine Sonteklif üzerinden devam etmeniz gerekir.
2. Bağlantı adresine gelen gönderimin Sonteklif'ten geldiğine emin olunmalıdır. Bunun için mutlaka sitenizde HASH kontrolü yapılmalıdır. HASH hesaplaması servis numaranız (SERVIS_ID), SATIS_KODU, URUN_ID ve ADET değişkenlerinin hash fonksiyonundan geçirilmesi ile elde edilir. Servis numaranız için Bize Ulaşın formu üzerinden iletişime geçmenizi rica ederiz.
3. Servis numaranızı güvenli bir şekilde saklamalı ve ayrıca Sontekliften gelen HASH bilgilerini üçüncü kişilerin erişiminden korumalısınız.