BAŞLANGIÇ

EsnekPos API servisi web siteleriniz üzerinden sorunsuz bir şekilde ödeme hizmeti alabilmeniz için geliştirilmiştir.

  • Esnek Pos Panel Adresimiz : https://www.pos.elekse.com
  • Sorularınız veya destek talepleriniz için destek@esnekpos.com adresinden bize 7/24 ulaşabilirsiniz.
  • .NET için hazırlanmış örnek projemize buradan ulaşabilirsiniz.
  • Ödeme isteği gönderebilmek için gerekli olan, üye işyerinize özel oluşturulan Merchant ve Merchant Key bilgilerinize panel üzerinden ulaşabilirsiniz.
  • Kullanacağınız ödeme modeline göre soldaki menüden ilerleyip entegrasyon işlemlerinizi gerçekleştirebilirsiniz.
  • Testlerinizi yaparken kullanacağınız test üye işyeri ve test kart bilgilerine soldaki menüden ulaşabilirsiniz.
  • İşlem sonucunda size dönülecek olan hata kod ve mesajlarına soldaki menüden ulaşabilirsiniz.

Entegrasyon Sürecimiz

  • Kullanacağınız ödeme modeline göre entegrasyon işlemlerinizi gerçekleştirdikten sonra test bilgileri ile işlem gerçekleştirerek sisteme sorunsuz bir şekilde entegre olduğunuzdan emin olmalısınız.
  • İşlem sonuçlarını kullanıcılarınızın daha rahat anlayabilmesi için bizden gelen hata kod ve mesajlarını kendinize göre düzenlemelisiniz.
  • İşlem sonunda sizin belirttiğiniz geri dönüş sayfasına verilerin eksiksiz ve doğru bir şekilde geldiğinden emin olmalısınız.
  • Tüm bu süreçler de sorularınızı veya destek taleplerinizi destek@esnekpos.com adresinden bize ulaştırabilirsiniz.


Destek Bilgileri

Sorularınız veya destek talepleriniz için destek@esnekpos.com adresinden bize 7/24 ulaşabilirsiniz.


destek@esnekpos.com

HAZIR PAKETLER

EsnekPos Hazır Modülleri İndirip Ödeme Almaya Başlayabilirsiniz.

Entegrasyon Sürecimiz

  • Kullanacağınız ödeme modeline göre entegrasyon işlemlerinizi gerçekleştirdikten sonra test bilgileri ile işlem gerçekleştirerek sisteme sorunsuz bir şekilde entegre olduğunuzdan emin olmalısınız.
  • İşlem sonuçlarını kullanıcılarınızın daha rahat anlayabilmesi için bizden gelen hata kod ve mesajlarını kendinize göre düzenlemelisiniz.
  • İşlem sonunda sizin belirttiğiniz geri dönüş sayfasına verilerin eksiksiz ve doğru bir şekilde geldiğinden emin olmalısınız.
  • Tüm bu süreçler de sorularınızı veya destek taleplerinizi destek@esnekpos.com adresinden bize ulaştırabilirsiniz.


Destek Bilgileri

Sorularınız veya destek talepleriniz için destek@esnekpos.com adresinden bize 7/24 ulaşabilirsiniz.


destek@esnekpos.com

3D Ödeme Modeli

Güvenli ve sorunsuz bir şekilde işlemlerin gerçekleşebilmesi ve fraud işlemlerin önlenebilmesi için tüm paremetrelerin eksiksiz bir şekilde gönderilmesi gerekmektedir.

API Post Adresi: https://posservice.elekse.com/api/pay/EYV3DPay

İstek Mesajı

Parametre Açıklama
MERCHANT Üye işyerinize özel oluşturulan kullanıcı bilginizdir. (EsnekPos paneli üzerinden bu bilgiye erişebilirsiniz.)
MERCHANT KEY Üye işyerinize özel oluşturulan kullanıcı şifre bilginizdir. (EsnekPos paneli üzerinden bu bilgiye erişebilirsiniz.)
ORDER_AMOUNT Gerçekleştirmek istediğiniz işleme ait tutar bilgisidir. (Örn: 15,90)
PRICES_CURRENCY Gönderdiğiniz tutar bilgisine ait para birimi bilgisidir. (Şu an için sadece "TR" gönderebilirsiniz.)
BACK_URL İşlem başarılı veya başarısız olarak tamamlandıktan sonra işlem cevabını göndereceğimiz dönüş adresinizdir.
ORDER_REF_NUMBER Ödeme isteğinde bulunurken gönderdiğiniz işleme ait referans numarasıdır. Ödemenizi bu referans numarası ile takip edebilirsiniz. (Maksimum 24 Karekter Olmalıdır.)
CC_NUMBER Ödeme işlemini gerçekleştireceğiniz karta ait 16 haneli numarasını içeren paremetredir.
CC_OWNER Kart sahibinin ad ve soyad bilgisinin belirtildiği parametredir.
EXP_MONTH Kartın son kullanım tarihinin ay bilgisinin belirtildiği parametredir. (Örn: 06)
EXP_YEAR Kartın son kullanım tarihinin yıl bilgisinin belirtildiği parametredir. (Örn: 2023)
CC_CVV Kartın arka yüzeyinde bulunan güvenlik kodunun bilgisinin belirtildiği parametredir. (Örn: 000)
INSTALLMENT_NUMBER İşlem için istenen taksit sayısının belirtildiği paremetredir. (Örn: Tek çekim işlem için "1" göndermelisiniz.)
FIRST_NAME İşlemi gerçekleştiren müşterinin adı bilgisidir.
LAST_NAME İşlemi gerçekleştiren müşterinin soyadı bilgisidir.
ADDRESS İşlemi gerçekleştiren müşterinin adres bilgisidir.
MAIL İşlemi gerçekleştiren müşterinin mail bilgisidir.
PHONE İşlemi gerçekleştiren müşterinin telefon numarası bilgisidir.
CITY İşlemi gerçekleştiren müşterinin şehir bilgisidir.
STATE İşlemi gerçekleştiren müşterinin ilçe bilgisidir.

Cevap Mesajı

Parametre Açıklama
ORDER_REF_NUMBER Ödeme isteğinde bulunurken gönderdiğiniz işleme ait referans numarası
STATUS İşlem sonuç durumu
RETURN_CODE İşlem sonuç kodu. (Örn: "0" ise başarılı işlem)
RETURN_MESSAGE Başarısız işlemler için hata mesajı.
DATE İşlem Tarihi
URL_3DS Kullanıcıyı yönlendireceğiniz 3D Doğrulama Sayfası url adresi.
REFNO İşleme ait Esnek Pos sistemindeki referans numarası.
HASH İşleme ait hash numarası
CUSTOMER_NAME İşleme ait müşteri ad soyad bilgileri.
CUSTOMER_MAIL İşleme ait müşteri mail adresi.
CUSTOMER_PHONE İşleme ait müşteri telefon numarası.
CUSTOMER_ADDRESS İşleme ait müşteri adres bilgileri.
CUSTOMER_CC_NUMBER İşlemin gerçekleştirildiği kart bilgisi. (Şifrelenmiş bir şekilde paylaşılacaktır.)


 public class PaymentRequest
 { 

    public EYVConfig Config { get; set; }
    public EYVCreditCard CreditCard { get; set; }
    public EYVCustomer Customer { get; set; }
    public PaymentRequest()
    {
         Config = new EYVConfig();
         CreditCard = new EYVCreditCard();
         Customer = new EYVCustomer();
    }
    public class EYVConfig
    {
         public EYVConfig()
         {

         }
         public string MERCHANT { get; set; }
         public string MERCHANT_KEY { get; set; }
         public string BACK_URL { get; set; }
         public string PRICES_CURRENCY { get; set; }
         public string ORDER_REF_NUMBER { get; set; }
         public string ORDER_AMOUNT { get; set; }
    }
    public class EYVCreditCard
    {
        public EYVCreditCard()
        {

        }
        public string CC_NUMBER { get; set; }
        public string EXP_MONTH { get; set; }
        public string EXP_YEAR { get; set; }
        public string CC_CVV { get; set; }
        public string CC_OWNER { get; set; }
        public string INSTALLMENT_NUMBER { get; set; }
    }
    public class EYVCustomer
    {
        public EYVCustomer()
        {

        }
        public string FIRST_NAME { get; set; }
        public string LAST_NAME { get; set; }
        public string MAIL { get; set; }
        public string PHONE { get; set; }
        public string CITY { get; set; }
        public string STATE { get; set; }
        public string ADDRESS { get; set; }
        public string CLIENT_IP { get; set; }
    }
} 




PaymentRequest  paymentRequest =  new PaymentRequest();
paymentRequest.Config =  new PaymentRequest.EYVConfig();
paymentRequest.Config.MERCHANT =  "TEST1234"; 
paymentRequest.Config.MERCHANT_KEY =  "4oK26hK8MOXrIV1bzTRVPA=="; 
paymentRequest.Config.ORDER_AMOUNT =  "15,00"; 
paymentRequest.Config.PRICES_CURRENCY =  "TR"; 
paymentRequest.Config.BACK_URL =  "site dönüş url"; 
paymentRequest.Config.ORDER_REF_NUMBER =  "esnekpos01"; 

paymentRequest.CreditCard =  new new PaymentRequest.EYVCreditCard();
paymentRequest.CreditCard.CC_OWNER =  "Kart Üzerinde Yazan İsim"; 
paymentRequest.CreditCard.CC_NUMBER =  "Kart Numarası"; 
paymentRequest.CreditCard.EXP_MONTH =  "Kart Ay numarası"; 
paymentRequest.CreditCard.EXP_YEAR =  "Kart Yıl Numarası"; 
paymentRequest.CreditCard.CC_CVV  =  "Kart Güvenlik Kodu"; 
paymentRequest.CreditCard.INSTALLMENT_NUMBER =  "Taksit Satısı"; 

paymentRequest.Customer =  new new PaymentRequest.EYVCustomer();
paymentRequest.Customer.FIRST_NAME =  "Müşteri Ad"; 
paymentRequest.Customer.LAST_NAME =  "Müşteri Soyad"; 
paymentRequest.Customer.ADDRESS =  "Müşteri Adres"; 
paymentRequest.Customer.MAIL =  "Müşteri Mail Adresi"; 
paymentRequest.Customer.PHONE  =  "müşteri Telefon"; 
paymentRequest.Customer.CITY =  "Şehir"; 
paymentRequest.Customer.STATE =  "İlçe"; 
paymentRequest.Customer.STATE =  "İlçe"; 
// Note: .NET dışında bir teknoloji ile entegre olmak isterseniz Api adresimize örnekteki json şablonu şeklinde post olabilirsiniz.
                         
 {
    "Config" :  {
        "MERCHANT" : "TEST1234",
        "MERCHANT_KEY" : "4oK26hK8MOXrIV1bzTRVPA==",
        "BACK_URL" : "İşlem sonucunda sizin belirleyeceğiniz dönüş url adresi",
        "PRICES_CURRENCY" : "TR",
        "ORDER_REF_NUMBER" : "001",
        "ORDER_AMOUNT" : "15"
    },
    "CreditCard" : {
         "CC_NUMBER" : "4159562885391991",
         "EXP_MONTH" : "12",
         "EXP_YEAR" : "2023",
         "CC_CVV" : "000",
         "CC_OWNER" : "test",
         "INSTALLMENT_NUMBER" : "1"
    },
    "Customer" : {
         "FIRST_NAME" : "Firstname",
         "LAST_NAME" : "Lastname",
         "MAIL" : "destek@esnekpos.com",
         "PHONE" : "02122356600",
         "CITY" : "İstanbul",
         "STATE" : "Şişli",
         "ADDRESS" : "Merkez Mah. Akar Cd. No:3/115 ITower Plaza Kat:17 Bomonti Şişli/İstanbul"
    }
 }
      
                                            

Güvenli Ödeme Sayfası Modeli

Ödemelerinizi güvenli ve hızlı bir şekilde esnek pos ödeme sayfasını kullanarak alabilmek için gerekli entegrasyon bilgilerini aşağıdan inceleyebilirsiniz. Güvenli ve sorunsuz bir şekilde işlemlerin gerçekleşebilmesi ve fraud işlemlerin önlenebilmesi için tüm paremetrelerin eksiksiz bir şekilde gönderilmesi gerekmektedir.

Post Edilecek url: https://posservice.elekse.com/api/pay/TrustedPay

İstek Mesajı

Parametre Açıklama
MERCHANT Üye işyerinize özel oluşturulan kullanıcı bilginizdir. (EsnekPos paneli üzerinden bu bilgiye erişebilirsiniz.)
MERCHANT KEY Üye işyerinize özel oluşturulan kullanıcı şifre bilginizdir. (EsnekPos paneli üzerinden bu bilgiye erişebilirsiniz.)
ORDER_AMOUNT Gerçekleştirmek istediğiniz işleme ait tutar bilgisidir. (Örn: 15,90)
PRICES_CURRENCY Gönderdiğiniz tutar bilgisine ait para birimi bilgisidir. (Şu an için sadece "TR" gönderebilirsiniz.)
BACK_URL İşlem başarılı veya başarısız olarak tamamlandıktan sonra işlem cevabını göndereceğimiz dönüş adresinizdir.
ORDER_REF_NUMBER Ödeme isteğinde bulunurken gönderdiğiniz işleme ait referans numarasıdır. Ödemenizi bu referans numarası ile takip edebilirsiniz. (Maksimum 24 Karekter Olmalıdır.)
INSTALLMENT_NUMBER İşlem için istenen taksit sayısının belirtildiği paremetredir. (Örn: Tek çekim işlem için "1" göndermelisiniz.)
FIRST_NAME İşlemi gerçekleştiren müşterinin adı bilgisidir.
LAST_NAME İşlemi gerçekleştiren müşterinin soyadı bilgisidir.
ADDRESS İşlemi gerçekleştiren müşterinin adres bilgisidir.
MAIL İşlemi gerçekleştiren müşterinin mail bilgisidir.
PHONE İşlemi gerçekleştiren müşterinin telefon numarası bilgisidir.
CITY İşlemi gerçekleştiren müşterinin şehir bilgisidir.
STATE İşlemi gerçekleştiren müşterinin ilçe bilgisidir.

Cevap Mesajı

Parametre Açıklama
ORDER_REF_NUMBER Ödeme isteği bulunurken gönderdiğiniz işleme ait referans numarası
STATUS İşlem sonuç durumu
RETURN_CODE İşlem sonuç kodu. (Örn: "0" ise başarılı işlem)
RETURN_MESSAGE Başarısız işlemler için hata mesajı.
DATE İşlem Tarihi
URL_3DS Kullanıcıyı yönlendireceğiniz 3D Doğrulama Sayfası url adresi.
REFNO İşleme ait Esnek Pos sistemindeki referans numarası.
HASH İşleme ait hash numarası
CUSTOMER_NAME İşleme ait müşteri ad soyad bilgileri.
CUSTOMER_MAIL İşleme ait müşteri mail adresi.
CUSTOMER_PHONE İşleme ait müşteri telefon numarası.
CUSTOMER_ADDRESS İşleme ait müşteri adres bilgileri.
CUSTOMER_CC_NUMBER İşlemin gerçekleştirildiği kart bilgisi. (Şifrelenmiş bir şekilde paylaşılacaktır.)


PaymentRequest  paymentRequest =  new PaymentRequest();
paymentRequest.Config =  new PaymentRequest.EYVConfig();
paymentRequest.Config.MERCHANT =  "TEST1234"; 
paymentRequest.Config.MERCHANT_KEY =  "4oK26hK8MOXrIV1bzTRVPA=="; 
paymentRequest.Config.ORDER_AMOUNT =  "15,00"; 
paymentRequest.Config.PRICES_CURRENCY =  "TR"; 
paymentRequest.Config.BACK_URL =  "site dönüş url"; 
paymentRequest.Config.ORDER_REF_NUMBER =  "esnekpos01"; 

paymentRequest.CreditCard =  new new PaymentRequest.EYVCreditCard();
paymentRequest.CreditCard.INSTALLMENT_NUMBER =  "Taksit Satısı"; 

paymentRequest.Customer =  new new PaymentRequest.EYVCustomer();
paymentRequest.Customer.FIRST_NAME =  "Müşteri Ad"; 
paymentRequest.Customer.LAST_NAME =  "Müşteri Soyad"; 
paymentRequest.Customer.ADDRESS =  "Müşteri Adres"; 
paymentRequest.Customer.MAIL =  "Müşteri Mail Adresi"; 
paymentRequest.Customer.PHONE  =  "müşteri Telefon"; 
paymentRequest.Customer.CITY =  "Şehir"; 
paymentRequest.Customer.STATE =  "İlçe"; 
// Note: .NET dışında bir teknoloji ile entegre olmak isterseniz Api adresimize örnekteki json şablonu şeklinde post olabilirsiniz.
                         
 {
    "Config" :  {
        "MERCHANT" : "TEST1234",
        "MERCHANT_KEY" : "4oK26hK8MOXrIV1bzTRVPA==",
        "BACK_URL" : "İşlem sonucunda sizin belirleyeceğiniz dönüş url adresi",
        "PRICES_CURRENCY" : "TR",
        "ORDER_REF_NUMBER" : "001",
        "ORDER_AMOUNT" : "15"
    },
    "CreditCard" : {
         "INSTALLMENT_NUMBER" : "1"
    },
    "Customer" : {
         "FIRST_NAME" : "Firstname",
         "LAST_NAME" : "Lastname",
         "MAIL" : "destek@esnekpos.com",
         "PHONE" : "02122356600",
         "CITY" : "İstanbul",
         "STATE" : "Şişli",
         "ADDRESS" : "Merkez Mah. Akar Cd. No:3/115 ITower Plaza Kat:17 Bomonti Şişli/İstanbul"
    }
 }

                       
                                            
Test Kart Bilgileri

API Post Test Adresi: https://posservice.elekse.com/api/pay/EYV3DPay

MERCHANT: TEST1234

MERCHANT_KEY: 4oK26hK8MOXrIV1bzTRVPA==

Kart Numarası: 4159 5628 8539 1991

Son Kullanma Tarihi: 12/2023

Güvenlik Numarası: 000

3D Doğrulama Şifresi: a

Destek Bilgilerimiz


destek@esnekpos.com

Cevap Parametre Bilgileri

İşlem sonunda size gönderilen hata kod ve mesajlarının açıklamaları için aşağıdaki bilgileri inceleyebilirsiniz.

Hata Kodları

Kod Açıklama
0-SUCCESS Başarılı İşlem
100-ERROR Hatalı İşlem
101-FIELD İstek mesajında eksik veya hatalı bilgi
102-AUTHENTICATION Üye İşyeri Doğrulama Hatası
103-LIMIT_ERROR Üye işyeri işlem limit hatası
201-PAYMENT_ERROR Ödeme işleminde karşılaşılan hata bilgisi

Hata Mesajları

Parametre Açıklama
PaymentRequest.Config.MERCHANT Hatalı Merchant
PaymentRequest.Config.MERCHANT_KEY Hatalı Merchant Key
PaymentRequest.Config.ORDER_REF_NUMBER Referans Numarası Daha Önce Kayıtlı yada 24 karekter sınırı geçildi.
PaymentRequest.Config.BACK_URL Hatalı dönüş adresi
PaymentRequest.Config.ORDER_AMOUNT Hatalı Tutar Girişi
PaymentRequest.Config.PRICES_CURRENCY Geçersiz Para Birimi
PaymentRequest.CreditCard.CC_OWNER Kart İsmi Hatalı
PaymentRequest.CreditCard.CC_NUMBER Hatalı Kart Numarası
PaymentRequest.CreditCard.CC_CVV Kart Güvenlik Numarası Hatalı
PaymentRequest.CreditCard.EXP_MONTH(MM) Kart Son Kullanma Tarihi Hatalı
PaymentRequest.CreditCard.EXP_YEAR(YYYY) Kart Son Kullanma Tarihi Hatalı
PaymentRequest.CreditCard.INSTALLMENT_NUMBER Taksit Hatası
PaymentRequest.Customer.ADDRESS Adres Boş Gönderildi.
PaymentRequest.Customer.CITY Şehir Boş Gönderildi.
PaymentRequest.Customer.STATE İlçe Boş Gönderildi.
PaymentRequest.Customer.FIRT_NAME Ad Boş Gönderildi
PaymentRequest.Customer.LAST_NAME Soyad Boş Gönderildi
PaymentRequest.Customer.MAIL Mail Boş Gönderildi
PaymentRequest.Customer.PHONE Telefon Boş Gönderildi
Limit.Single_Process_Amount Tek işlem tutar limiti aşıldı.
Limit.Card.Day_Amount Günlük aynı kart işlem tutar limiti aşıldı.
Limit.Card.Day_Count Günlük aynı kart işlem adet limiti aşıldı.
Limit.Merchant.Day_Count Günlük üye işyeri işlem adet limiti aşıldı.
Limit.Merchant.Day_Amount Günlük üye işyeri işlem tutar limiti aşıldı.
Limit.Merchant.Month_Amount Aylık üye işyeri işlem tutar limiti aşıldı.
Limit.Merchant.Month_Count Aylık üye işyeri işlem adet limiti aşıldı.
Not.3DAuthentication 3D Doğrulama Gerçekleştirilemedi.
Insufficient.Funds İşlem gerçekleştirilen kart limiti yetersiz.

    
         public class PaymentResponse
         { 
        
                public string ORDER_REF_NUMBER { get; set; }
                public string STATUS { get; set; }
                public string RETURN_CODE { get; set; }
                public string RETURN_MESSAGE { get; set; }
                public string DATE { get; set; }
                public string URL_3DS { get; set; }
                public string REFNO { get; set; }
                public string HASH { get; set; }
                public string CUSTOMER_NAME { get; set; }
                public string CUSTOMER_MAIL { get; set; }
                public string CUSTOMER_PHONE { get; set; }
                public string CUSTOMER_ADDRESS { get; set; }
                public string CUSTOMER_CC_NUMBER { get; set; }
            } 
        
    

                         
    {
        "ORDER_REF_NUMBER": "1435",
        "STATUS": "SUCCESS",
        "RETURN_CODE": "0",
        "RETURN_MESSAGE": "SUCCESS",
        "DATE": "2.4.2019 15:49:31",
        "URL_3DS": "https://posservice.elekse.com/api/testPay/3DSecurityTEST/order/efe7e213dfsfee",
        "REFNO": "1419",
        "HASH": "efe7e69b3bfa45641ec5a4852ccaa09f9851477597d6af6241fc144cd99767ee",
        "CUSTOMER_NAME": "Firstname Lastname",
        "CUSTOMER_MAIL": "destek@esnekpos.com",
        "CUSTOMER_PHONE": "02122356600",
        "CUSTOMER_ADDRESS": "Merkez Mah. Akar Cd. No:3/115 ITower Plaza Kat:17 Bomonti Şişli/İstanbul",
        "CUSTOMER_CC_NUMBER": "415956******1991"
    }