Esc
Aramaya başlamak için yazın...

Ödeme Entegrasyon Servisleri

1. Ortak Ödeme Sayfası #

İstenen değerler post edilerek işlemler Nkolay Ortak Ödeme sayfasına yönlendirilir. Kart bilgileri doğrudan Nkolay sunucularına gider, güvenlik Nkolay tarafından sağlanır. Site içinde iframe ile entegrasyon yapılabilir.

2. Linkli Ödeme #

Ödeme linki kart kullanıcısına SMS veya e-posta ile gönderilir. Kullanıcı linke tıklayarak Nkolay Ortak Ödeme sayfasına yönlendirilir, işlemler burada gerçekleşir.

3. API - Kart Bilgilerinin Üye İşyeri Tarafından Alındığı Yapı #

Üye işyeri kendi sayfasında kart bilgilerini alır, Nkolay API ile işlem yapar. Bu yapıda kart bilgileri üye işyeri tarafından alındığı için PCI DSS gereklilikleri üye işyerine aittir.

Test ortam bilgileri
sx (Token): 118591467|bScbGDYCtPf7SS1N6PQ6/+58rFhW1WpsWINqvkJFaJlu6bMH2tgPKDQtjeA5vClpzJP24uA0vx7OX53cP3SgUspa4EvYix+1C3aXe++8glUvu9Oyyj3v300p5NP7ro/9K57Zcw==
sx list:    118591467|bScbGDYCtPf7SS1N6PQ6/+58rFhW1WpsWINqvkJFaJlu6bMH2tgPKDQtjeA5vClpzJP24uA0vx7OX53cP3SgUspa4EvYix+1C3aXe++8glUvu9Oyyj3v300p5NP7ro/9K57Zcw==|3hJpHVF2cqvcCZ4q6F7rcA==
sx iptal:   118591467|bScbGDYCtPf7SS1N6PQ6/+58rFhW1WpsWINqvkJFaJlu6bMH2tgPKDQtjeA5vClpzJP24uA0vx7OX53cP3SgUspa4EvYix+1C3aXe++8glUvu9Oyyj3v300p5NP7ro/9K57Zcw==|yDUZaCk6rsoHZJWI3d471A/+TJA7C81X
Merchant Secret Key: _YckdxUbv4vrnMUZ6VQsr
URL: https://paynkolaytest.nkolayislem.com.tr/Vpos

Form Göndererek Ortak Ödeme Sayfası Kullanımı #

Ödeme alabilmeniz için sizlere özel verilen değerleri HTTP POST metodu ile Test ortam URL: https://paynkolaytest.nkolayislem.com.tr/Vpos adresine post edilerek gönderilir.

Prod ortam URL'i: https://paynkolay.nkolayislem.com.tr/Vpos

Form Değişkenlerine ait bilgiler #

Servise POST edebileceğiniz parametreler aşağıdaki gibidir. Tüm parametreler, isteğin gövdesinde (body) standart HTML Form Post metoduyla gönderilmelidir.

Uygulama akışı:

  • Formda gönderdiğiniz bilgilerin geçerlilik kontrolü yapılır, eksik veya hatalı bilgi varsa hata mesajı dönülür ve akış sonlanır.
  • Formda gönderdiğiniz bilgiler kontrol edilir. Doğru değil ise hata mesajı ile akış sonlanır.
  • Formda gönderdiğiniz bilgiler doğru ise, kredi kartı bilgilerinin girileceği form gösterilir.
  • Formda kredi kartı kart bilgisi girildikten sonra bu kutucuktan ayrılırken taksit seçenekleri görüntülenir. Tek çekim varsayılan olarak seçili gelir.
  • Kredi kartı bilgilerinin tamamı girilip uygun taksit seçeneği işaretlendikten sonra "Ödemeyi Gerçekleştir" tuşuna basılarak ödeme işlemi gerçekleştirilir.
  • Ödeme işlemi 3D olacak ise akış 3D sayfasına yönlendirilir, 3D değilse direk sonuçlanır.
  • Ödeme işlemi başarılı sonuçlanmış ise "successUrl" sayfasına başarılı sonuç değerleri post edilerek yönlendirilir.
  • İşlem başarısız olursa başarısız işlem bilgileri "failURL" sayfasına post edilir.
İsimTipiAçıklamaZorunluÖrnek Değer
agentCodestringAlt temsilcilik üzerinden işlem yapılıyorsa bu değer ile alt temsilcinizin kodunu gönderebilirsiniz.İsteğe Bağlı7683323
amountdecimalÖdeme tutarıdır. Kuruş ayıracı olarak . (nokta) kullanılmalıdır.Zorunlu1280.10
binstringDilerseniz sadece belirli kart bin'lerinden işlem alabilirsiniz. ( Kartın ilk 6 hanesidir. )İsteğe Bağlı413278|521089
cardcampaignstringVisa, Master Kartlara kampanya yapabilirsiniz. Visa için 4, MasterCard için 5 parametresini göndermeniz gerekmektedir.İsteğe Bağlı4 (Visa) / 5 (MC)
cardHolderIPstringİşlemi yapan kart sahibinin IP adresi.Zorunlu37.135.23.122
clientRefCodestringKendi referans numaranızdır. (Türkçe karakter içermemeli. En fazla 1024 karakter.)Zorunlu5231As-FE2A36
currencyCodestringGönderilmezse TL üzerinden işlem yapılır. USD için 840, EUR için 978 gönderin.İsteğe Bağlı949
customerKeystringOrtak ödeme sayfası ile kart saklama yapılabilmesi için bu değerin gönderilmesi gerekmektedir.İsteğe Bağlı13813813813
detailstring"true" olarak gönderilirse ortak ödeme sayfasında müşteriden ek bilgi alınır.İsteğe Bağlıtrue
ECOMM_PLATFORMstringB2B olarak yazılım geliştiriyorsanız platformunuzun ismini yazabilirsiniz.İsteğe BağlıCetvel
failUrlstringBaşarısız işlem sonucu post edilir.Zorunluhttps://domain.com/fail
hashDataV2stringGüvenlik hash değeri. Hash hesaplaması için ilgili sayfaya bakınız.ZorunlusUZl2nWw...
instalmentsstringTaksit sayısı. 1 = tek çekim. Boş bırakılırsa varsayılan taksit ayarları uygulanır.İsteğe Bağlı2
languagestringDil seçeneği. "en" İngilizce, "ru" Rusça. Gönderilmezse Türkçe.İsteğe Bağlıen
MerchantCustomerNostringTemsilci veya alt üye işyeri numaranız. Panelden bu numara ile aratabilirsiniz.İsteğe Bağlı93423410
rndstringDateTime.Now ile işlem tarihini göndermeniz gerekmektedir.Zorunlu09-08-2021 15:24:22
secondstringSepetteki kalan süreyi saniye olarak post edebilirsiniz. Geri sayım gösterilir.İsteğe Bağlı600
successUrlstringBaşarılı işlem sonucu post edilir.Zorunluhttps://domain.com/success
sxstringWeb Servis için gerekli giriş kodudur (Token).Zorunlu114488219|SjEH1wb...
transactionTypestring"SALES" satış veya "PRESALES" provizyon.ZorunluSALES
use3Dstring"true" gönderilirse 3D Secure zorlanır. Boş gönderilirse mevcut limit uygulanır.Zorunlutrue