Ö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.
- Ortak Ödeme Sayfası ile Ödeme Alma ( form göndererek )
- Ortak Ödeme Sayfası ile Ödeme Alma ( link oluşturup )
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 bilgilerisx (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.
| İsim | Tipi | Açıklama | Zorunlu | Örnek Değer |
|---|---|---|---|---|
agentCode | string | Alt temsilcilik üzerinden işlem yapılıyorsa bu değer ile alt temsilcinizin kodunu gönderebilirsiniz. | İsteğe Bağlı | 7683323 |
amount | decimal | Ödeme tutarıdır. Kuruş ayıracı olarak . (nokta) kullanılmalıdır. | Zorunlu | 1280.10 |
bin | string | Dilerseniz sadece belirli kart bin'lerinden işlem alabilirsiniz. ( Kartın ilk 6 hanesidir. ) | İsteğe Bağlı | 413278|521089 |
cardcampaign | string | Visa, Master Kartlara kampanya yapabilirsiniz. Visa için 4, MasterCard için 5 parametresini göndermeniz gerekmektedir. | İsteğe Bağlı | 4 (Visa) / 5 (MC) |
cardHolderIP | string | İşlemi yapan kart sahibinin IP adresi. | Zorunlu | 37.135.23.122 |
clientRefCode | string | Kendi referans numaranızdır. (Türkçe karakter içermemeli. En fazla 1024 karakter.) | Zorunlu | 5231As-FE2A36 |
currencyCode | string | Gönderilmezse TL üzerinden işlem yapılır. USD için 840, EUR için 978 gönderin. | İsteğe Bağlı | 949 |
customerKey | string | Ortak ödeme sayfası ile kart saklama yapılabilmesi için bu değerin gönderilmesi gerekmektedir. | İsteğe Bağlı | 13813813813 |
detail | string | "true" olarak gönderilirse ortak ödeme sayfasında müşteriden ek bilgi alınır. | İsteğe Bağlı | true |
ECOMM_PLATFORM | string | B2B olarak yazılım geliştiriyorsanız platformunuzun ismini yazabilirsiniz. | İsteğe Bağlı | Cetvel |
failUrl | string | Başarısız işlem sonucu post edilir. | Zorunlu | https://domain.com/fail |
hashDataV2 | string | Güvenlik hash değeri. Hash hesaplaması için ilgili sayfaya bakınız. | Zorunlu | sUZl2nWw... |
instalments | string | Taksit sayısı. 1 = tek çekim. Boş bırakılırsa varsayılan taksit ayarları uygulanır. | İsteğe Bağlı | 2 |
language | string | Dil seçeneği. "en" İngilizce, "ru" Rusça. Gönderilmezse Türkçe. | İsteğe Bağlı | en |
MerchantCustomerNo | string | Temsilci veya alt üye işyeri numaranız. Panelden bu numara ile aratabilirsiniz. | İsteğe Bağlı | 93423410 |
rnd | string | DateTime.Now ile işlem tarihini göndermeniz gerekmektedir. | Zorunlu | 09-08-2021 15:24:22 |
second | string | Sepetteki kalan süreyi saniye olarak post edebilirsiniz. Geri sayım gösterilir. | İsteğe Bağlı | 600 |
successUrl | string | Başarılı işlem sonucu post edilir. | Zorunlu | https://domain.com/success |
sx | string | Web Servis için gerekli giriş kodudur (Token). | Zorunlu | 114488219|SjEH1wb... |
transactionType | string | "SALES" satış veya "PRESALES" provizyon. | Zorunlu | SALES |
use3D | string | "true" gönderilirse 3D Secure zorlanır. Boş gönderilirse mevcut limit uygulanır. | Zorunlu | true |