DOCS
Türkçe English
Panel Giriş Başvurun

Paynkolay Docs

Kodunuz solda okur, sağda çalışır

Ödeme kabul etmeye başlamak için gereken her şey: test bilgileri, tahsilat metodları ve API referansı. Konsol hep yanınızda — okuduğunuz her adımın karşılığı sağda.

İlk İsteği Gönderin Yöntem Seçin
≈ 8 snuçtan uca 3D akışı
PCI DSSyük Paynkolay tarafında
26 uçPostman koleksiyonunda
7/24kolayposdestek@nkolay.com.tr

Hızlı başlangıç

  1. Panel erişiminizi alınBaşvurunuz onaylanınca üye işyeri hesabınız açılır; sx ve Merchant Secret Key panelde sizi bekler.
  2. Test ortamında imzalı istek gönderinSağdaki konsoldan cURL örneğini kopyalayın; hash sunucu tarafında üretilir, tarayıcıya asla inmez.
  3. Test kartıyla uçtan uca deneyin5200 19•• •••• 1495 ile 3D akışını tamamlayın; sonuç successUrl adresinize POST edilir.
  4. Canlı bilgilerinizle yayına çıkınAynı gövde, farklı taban adres. Yanıt imzasını (hashDataV2) mutlaka doğrulayın.

Erişim uçları

Tüm istekler application/x-www-form-urlencoded gövdeyle gönderilir.

POST https://paynkolaytest.nkolayislem.com.tr/Vpos TEST
POST https://paynkolay.nkolayislem.com.tr/Vpos CANLI

Örnek uç — Ortak Ödeme (Form)

Kart bilgileri Paynkolay ortak ödeme sayfasında alınır; siz yalnızca imzalı alanları POST edersiniz.

sxstringZORUNLU

Üye işyerine özel token. Panelinizden alınır, istemci tarafında saklanmaz.

amountdecimalZORUNLU

Ödeme tutarı. Kuruş ayıracı olarak nokta kullanılır — ör. 102.50.

successUrlstringZORUNLU

Başarılı sonucun POST edileceği adres. Geçerli SSL sertifikası zorunludur.

failUrlstringZORUNLU

Başarısız sonucun POST edileceği adres.

rndstringZORUNLU

Her istekte üretilen tekil değer; hash'e dahildir, tekrar saldırılarını önler.

hashDatastringZORUNLU

Alanların | ile birleştirilip SHA-512 + Base64 ile imzalanmış hâli. Sunucu tarafında üretilir.

agentCodestringİSTEĞE BAĞLI

Alt temsilcilik üzerinden işlem yapılıyorsa temsilci kodu.

Canlıya geçerken: canlı sx ve Merchant Secret Key değerlerinize panelden Ayarlar → Entegrasyon Bilgileri adımıyla ulaşırsınız. Göremiyorsanız API yetkiniz tanımlı olmayabilir.

Size uygun yöntem

Ortak Ödeme (Form)Kart bilgileri bizim sayfamızda alınır; en hızlı başlangıç. Linkli ÖdemeÖdeme linkini SMS veya e-posta ile gönderin; kod gerekmez. API ile Ödeme (3D · NON3D)Tam kontrol: kendi arayüzünüzden RESTful API ile tahsilat. Hazır EklentilerWooCommerce, OpenCart, Magento — kur, bilgilerini gir, yayında.

Doküman ağacı

Tüm ana başlıklar ve alt başlıklar, konsoldan okur gibi — açılır menü yok. Bir satıra dokunun, sayfasına gidin.

tree — paynkolay-docs/

Sıkça sorulan sorular

Hash neden uyuşmuyor?

Alan sırası ve boş customerKey borusu en sık iki neden. Ürettiğiniz imzayı Hash Aracı çıktısıyla karşılaştırın.

3D doğrulama formunu nasıl basmalıyım?

Yanıtta dönen HTML'i olduğu gibi tarayıcıya basın; müşteri bankasının 3D sayfasına yönlenir, sonuç adreslerinize POST edilir.

Web sitem yok — tahsilat yapabilir miyim?

Evet — Linkli Ödeme ile panelden link oluşturup SMS/e-posta ile gönderirsiniz; teknik bilgi gerektirmez.

Son güncelleme: 7 Eylül 2026

v6 · Versiyonlar